} optional. * Array of categories for item. * Only used by atom format. * publish {Integer} optional. * a time when item should be "published". * if no publish time is specified, or the time is in the past, the item will be shown. * for example: * strtotime('2014-10-31') */ class Features { // id for features list. public $id = 'usgs_earthquake_home'; // author for features list. public $author = 'U.S. Geological Survey'; // site url (ends with a /). public $siteUrl = 'https://earthquake.usgs.gov/'; // base url for section (ends with a /). public $baseUrl; // title of features list. public $title; // items in list. public $items; /** * Construct a new Features list. */ public function __construct ($items=null) { $this->items = array(); } /** * Get list of items currently "publish"able. * * @return {Array} all items without a publish date, or a publish date in the past. */ public function getItems () { $now = time(); $items = array(); foreach ($this->items as $item) { if (!isset($item['publish']) || $item['publish'] <= $now) { $items[] = $item; } } return $items; } /** * Format Features list as Atom feed. * * @return {String} atom feed. */ public function toAtom() { $items = $this->getItems(); $r = ''; $r .= '' . PHP_EOL . '' . '' . $this->title . '' . '' . $this->getAtomDate(time()) . '' . '' . '' . $this->author . '' . '' . $this->siteUrl . '' . '' . '' . $this->id . ''; foreach ($items as $item) { $r .= $this->getAtomEntry($item); } $r .= ''; return $r; } /** * Format Features list as Html. * * @param $numItems {Integer} default 4. * total number of items to include in list. * @param $numFeatured {Integer} default 1. * number of items to "feature". * @return {String} html. */ public function toHtml() { $items = $this->getItems(); $len = count($items); $r = ''; $r .= '
'; $r .= '
' . $this->getFeaturedHtml($items[0]) . '
'; $r .= '
'; $r .= '
'; $r .= '
'; $r .= '
    '; $r .= '
  • ' . $this->getItemHtml($items[1]) . '
    • ' . '
' . '
'; $r .= '
'; $r .= '
    '; $r .= '
  • ' . $this->getItemHtml($items[2]) . '
    • ' . '
' . '
'; $r .= '
' . '
' . '
'; return $r; } /** * Format a time as ISO8601. * * @param $time {Integer} * unix epoch timestamp in seconds. * @return {String} ISO8601 formatted date. */ protected function getAtomDate ($time) { return gmdate('Y-m-d\TH:i:s\Z', $time); } /** * Format an item as an Atom entry. * * @param item {Item} * @return {String} atom entry element. */ protected function getAtomEntry ($item) { $r = ''; $r .= '' . '' . $item['id'] . '' . '' . $item['title'] . '' . '' . $this->getAtomDate($item['modified']) . '' . '' . 'getLink($item['thumbnail']) . '" width="100" align="left" hspace="10"/>' . $item['content'] . ']]>'; if (isset($item['tags'])) { foreach ($item['tags'] as $tag) { $r .= ''; } } $r .= ''; return $r; } /** * Format a featured item as Html * * @param item {Item} * @return {String} html formatted item. */ protected function getFeaturedHtml ($item) { return '' . '' . '

' . $item['title'] . '

' . '
' . '' . '

' . $item['content'] . '

'; } /** * Format an item as Html. * * @param item {Item} * @return {String} html formatted item. */ protected function getItemHtml ($item) { return '' . '' . '

' . $item['title'] . '

' . '' . '' . '

' . $item['content'] . '

'; } /** * Get an absolute link from a relative link. * * @param $link {String} * relative or absolute link. * @return {String} absolute link. */ protected function getLink ($link) { if (strpos($link, 'https') === 0) { return $link; } return $this->siteUrl . $this->baseUrl . $link; } }