* @since 1.3 */ class FeedItem extends HtmlDescribable { /** * Mandatory attributes of an item. */ var $title, $description, $link; /** * Optional attributes of an item. */ var $author, $authorEmail, $image, $category, $comments, $guid, $source, $creator; /** * Publishing date of an item. May be in one of the following formats: * * RFC 822: * "Mon, 20 Jan 03 18:05:41 +0400" * "20 Jan 03 18:05:41 +0000" * * ISO 8601: * "2003-01-20T18:05:41+04:00" * * Unix: * 1043082341 */ var $date; /** * Add element tag RSS 2.0 * modified by : Mohammad Hafiz bin Ismail (mypapit@gmail.com) * * * display : * * */ var $enclosure; /** * Any additional elements to include as an assiciated array. All $key => $value pairs * will be included unencoded in the feed item in the form * <$key>$value * Again: No encoding will be used! This means you can invalidate or enhance the feed * if $value contains markup. This may be abused to embed tags not implemented by * the FeedCreator class used. */ var $additionalElements = Array(); // on hold // var $source; } /** * Class EnclosureItem */ class EnclosureItem extends HtmlDescribable { /* * * core variables * **/ var $url,$length,$type; /* * For use with another extension like Yahoo mRSS * Warning : * These variables might not show up in * later release / not finalize yet! * */ var $width, $height, $title, $description, $keywords, $thumburl; var $additionalElements = Array(); } /** * An FeedImage may be added to a FeedCreator feed. * @author Kai Blankenhorn * @since 1.3 */ class FeedImage extends HtmlDescribable { /** * Mandatory attributes of an image. */ var $title, $url, $link; /** * Optional attributes of an image. */ var $width, $height, $description; } /** * An HtmlDescribable is an item within a feed that can have a description that may * include HTML markup. */ class HtmlDescribable { /** * Indicates whether the description field should be rendered in HTML. */ var $descriptionHtmlSyndicated; /** * Indicates whether and to how many characters a description should be truncated. */ var $descriptionTruncSize; var $description; /** * Returns a formatted description field, depending on descriptionHtmlSyndicated and * $descriptionTruncSize properties * @return string the formatted description */ function getDescription() { $descriptionField = new FeedHtmlField($this->description); $descriptionField->syndicateHtml = $this->descriptionHtmlSyndicated; $descriptionField->truncSize = $this->descriptionTruncSize; return $descriptionField->output(); } } /** * An FeedHtmlField describes and generates * a feed, item or image html field (probably a description). Output is * generated based on $truncSize, $syndicateHtml properties. * @author Pascal Van Hecke * @version 1.6 */ class FeedHtmlField { /** * Mandatory attributes of a FeedHtmlField. */ var $rawFieldContent; /** * Optional attributes of a FeedHtmlField. * */ var $truncSize, $syndicateHtml; /** * Creates a new instance of FeedHtmlField. * @param string $parFieldContent: if given, sets the rawFieldContent property */ function __construct($parFieldContent) { if ($parFieldContent) { $this->rawFieldContent = $parFieldContent; } } /** * Creates the right output, depending on $truncSize, $syndicateHtml properties. * @return string the formatted field */ function output() { // when field available and syndicated in html we assume // - valid html in $rawFieldContent and we enclose in CDATA tags // - no truncation (truncating risks producing invalid html) if (!$this->rawFieldContent) { $result = ""; } elseif ($this->syndicateHtml) { $result = "rawFieldContent."]]>"; } else { if ($this->truncSize and is_int($this->truncSize)) { $result = FeedCreator::iTrunc(htmlspecialchars($this->rawFieldContent),$this->truncSize); } else { $result = htmlspecialchars($this->rawFieldContent); } } return $result; } } /** * UniversalFeedCreator lets you choose during runtime which * format to build. * For general usage of a feed class, see the FeedCreator class * below or the example above. * * @since 1.3 * @author Kai Blankenhorn */ class UniversalFeedCreator extends FeedCreator { /** @var FeedCreator */ var $_feed; /** * Sets format * * @param string $format */ function _setFormat($format) { switch (strtoupper($format)) { case "2.0": // fall through case "RSS2.0": $this->_feed = new RSSCreator20(); break; case "1.0": // fall through case "RSS1.0": $this->_feed = new RSSCreator10(); break; case "0.91": // fall through case "RSS0.91": $this->_feed = new RSSCreator091(); break; case "PIE0.1": $this->_feed = new PIECreator01(); break; case "MBOX": $this->_feed = new MBOXCreator(); break; case "OPML": $this->_feed = new OPMLCreator(); break; case "ATOM": // fall through: always the latest ATOM version case "ATOM1.0": $this->_feed = new AtomCreator10(); break; case "ATOM0.3": $this->_feed = new AtomCreator03(); break; case "HTML": $this->_feed = new HTMLCreator(); break; case "JS": // fall through case "JAVASCRIPT": $this->_feed = new JSCreator(); break; default: $this->_feed = new RSSCreator091(); break; } $vars = get_object_vars($this); foreach ($vars as $key => $value) { // prevent overwriting of properties "contentType", "encoding"; do not copy "_feed" itself if (!in_array($key, array("_feed", "contentType", "encoding"))) { $this->_feed->{$key} = $this->{$key}; } } } function _sendMIME() { header('Content-Type: '.$this->contentType.'; charset='.$this->encoding, true); } /** * Creates a syndication feed based on the items previously added. * * @see FeedCreator::addItem() * @param string $format format the feed should comply to. Valid values are: * "PIE0.1", "mbox", "RSS0.91", "RSS1.0", "RSS2.0", "OPML", "ATOM0.3", "HTML", "JS" * @return string the contents of the feed. */ function createFeed($format = "RSS0.91") { $this->_setFormat($format); return $this->_feed->createFeed(); } /** * Saves this feed as a file on the local disk. After the file is saved, an HTTP redirect * header may be sent to redirect the use to the newly created file. * @since 1.4 * * @param string $format format the feed should comply to. Valid values are: * "PIE0.1" (deprecated), "mbox", "RSS0.91", "RSS1.0", "RSS2.0", "OPML", "ATOM", "ATOM0.3", "HTML", "JS" * @param string $filename optional the filename where a recent version of the feed is saved. If not specified, the filename is $_SERVER["PHP_SELF"] with the extension changed to .xml (see _generateFilename()). * @param boolean $displayContents optional send the content of the file or not. If true, the file will be sent in the body of the response. */ function saveFeed($format="RSS0.91", $filename="", $displayContents=true) { $this->_setFormat($format); $this->_feed->saveFeed($filename, $displayContents); } /** * Turns on caching and checks if there is a recent version of this feed in the cache. * If there is, an HTTP redirect header is sent. * To effectively use caching, you should create the FeedCreator object and call this method * before anything else, especially before you do the time consuming task to build the feed * (web fetching, for example). * * @param string $format format the feed should comply to. Valid values are: * "PIE0.1" (deprecated), "mbox", "RSS0.91", "RSS1.0", "RSS2.0", "OPML", "ATOM0.3". * @param string $filename optional the filename where a recent version of the feed is saved. If not specified, the filename is $_SERVER["PHP_SELF"] with the extension changed to .xml (see _generateFilename()). * @param int $timeout optional the timeout in seconds before a cached version is refreshed (defaults to 3600 = 1 hour) */ function useCached($format="RSS0.91", $filename="", $timeout=3600) { $this->_setFormat($format); $this->_feed->useCached($filename, $timeout); } /** * Outputs feed to the browser - needed for on-the-fly feed generation (like it is done in WordPress, etc.) * * @param $format string format the feed should comply to. Valid values are: * "PIE0.1" (deprecated), "mbox", "RSS0.91", "RSS1.0", "RSS2.0", "OPML", "ATOM0.3". */ function outputFeed($format='RSS0.91') { $this->_setFormat($format); $this->_sendMIME(); $this->_feed->outputFeed(); } } /** * FeedCreator is the abstract base implementation for concrete * implementations that implement a specific format of syndication. * * @abstract * @author Kai Blankenhorn * @since 1.4 */ class FeedCreator extends HtmlDescribable { /** * Mandatory attributes of a feed. */ var $title, $description, $link; /** * Optional attributes of a feed. */ var $syndicationURL, $language, $copyright, $pubDate, $lastBuildDate, $editor, $editorEmail, $webmaster, $category, $docs, $ttl, $rating, $skipHours, $skipDays; /** * Optional attribute of a feed * * @var FeedImage */ var $image = null; /** * The url of the external xsl stylesheet used to format the naked rss feed. * Ignored in the output when empty. */ var $xslStyleSheet = ""; /** * Style sheet for rss feed */ var $cssStyleSheet = ""; /** * @access private * @var FeedItem[] */ var $items = Array(); /** * This feed's MIME content type. * @since 1.4 * @access private */ var $contentType = "application/xml"; /** * This feed's character encoding. * @since 1.6.1 **/ var $encoding = "utf-8"; /** * Any additional elements to include as an assiciated array. All $key => $value pairs * will be included unencoded in the feed in the form * <$key>$value * Again: No encoding will be used! This means you can invalidate or enhance the feed * if $value contains markup. This may be abused to embed tags not implemented by * the FeedCreator class used. */ var $additionalElements = Array(); var $_timeout; /** * Adds an FeedItem to the feed. * * @param FeedItem $item The FeedItem to add to the feed. * @access public */ function addItem($item) { $this->items[] = $item; } /** * Truncates a string to a certain length at the most sensible point. * First, if there's a '.' character near the end of the string, the string is truncated after this character. * If there is no '.', the string is truncated after the last ' ' character. * If the string is truncated, " ..." is appended. * If the string is already shorter than $length, it is returned unchanged. * * @static * @param string $string A string to be truncated. * @param int $length the maximum length the string should be truncated to * @return string the truncated string */ static function iTrunc($string, $length) { if (strlen($string)<=$length) { return $string; } $pos = strrpos($string,"."); if ($pos>=$length-4) { $string = substr($string,0,$length-4); $pos = strrpos($string,"."); } if ($pos>=$length*0.4) { return substr($string,0,$pos+1)." ..."; } $pos = strrpos($string," "); if ($pos>=$length-4) { $string = substr($string,0,$length-4); $pos = strrpos($string," "); } if ($pos>=$length*0.4) { return substr($string,0,$pos)." ..."; } return substr($string,0,$length-4)." ..."; } /** * Creates a comment indicating the generator of this feed. * The format of this comment seems to be recognized by * Syndic8.com. */ function _createGeneratorComment() { return "\n"; } /** * Creates a string containing all additional elements specified in * $additionalElements. * @param $elements array an associative array containing key => value pairs * @param $indentString string a string that will be inserted before every generated line * @return string the XML tags corresponding to $additionalElements */ function _createAdditionalElements($elements, $indentString="") { $ae = ""; if (is_array($elements)) { foreach($elements AS $key => $value) { $ae.= $indentString."<$key>$value\n"; } } return $ae; } /** * Create elements for stylesheets */ function _createStylesheetReferences() { $xml = ""; if ($this->cssStyleSheet) $xml .= "cssStyleSheet."\" type=\"text/css\"?>\n"; if ($this->xslStyleSheet) $xml .= "xslStyleSheet."\" type=\"text/xsl\"?>\n"; return $xml; } /** * Builds the feed's text. * @abstract * @return string the feed's complete text */ function createFeed() { } /** * Generate a filename for the feed cache file. The result will be $_SERVER["PHP_SELF"] with the extension changed to .xml. * For example: * * echo $_SERVER["PHP_SELF"]."\n"; * echo FeedCreator::_generateFilename(); * * would produce: * * /rss/latestnews.php * latestnews.xml * * @return string the feed cache filename * @since 1.4 * @access private */ function _generateFilename() { $fileInfo = pathinfo($_SERVER["PHP_SELF"]); return substr($fileInfo["basename"],0,-(strlen($fileInfo["extension"])+1)).".xml"; } /** * @since 1.4 * @access private * * @param string $filename */ function _redirect($filename) { // attention, heavily-commented-out-area // maybe use this in addition to file time checking //Header("Expires: ".date("r",time()+$this->_timeout)); /* no caching at all, doesn't seem to work as good: Header("Cache-Control: no-cache"); Header("Pragma: no-cache"); */ // HTTP redirect, some feed readers' simple HTTP implementations don't follow it //Header("Location: ".$filename); header("Content-Type: ".$this->contentType."; charset=".$this->encoding."; filename=".utf8_basename($filename)); header("Content-Disposition: inline; filename=".utf8_basename($filename)); readfile($filename); die(); } /** * Turns on caching and checks if there is a recent version of this feed in the cache. * If there is, an HTTP redirect header is sent. * To effectively use caching, you should create the FeedCreator object and call this method * before anything else, especially before you do the time consuming task to build the feed * (web fetching, for example). * @since 1.4 * @param $filename string optional the filename where a recent version of the feed is saved. If not specified, the filename is $_SERVER["PHP_SELF"] with the extension changed to .xml (see _generateFilename()). * @param $timeout int optional the timeout in seconds before a cached version is refreshed (defaults to 3600 = 1 hour) */ function useCached($filename="", $timeout=3600) { $this->_timeout = $timeout; if ($filename=="") { $filename = $this->_generateFilename(); } if (file_exists($filename) AND (time()-filemtime($filename) < $timeout)) { $this->_redirect($filename); } } /** * Saves this feed as a file on the local disk. After the file is saved, a redirect * header may be sent to redirect the user to the newly created file. * @since 1.4 * * @param $filename string optional the filename where a recent version of the feed is saved. If not specified, the filename is $_SERVER["PHP_SELF"] with the extension changed to .xml (see _generateFilename()). * @param $displayContents boolean optional send an HTTP redirect header or not. If true, the user will be automatically redirected to the created file. */ function saveFeed($filename="", $displayContents=true) { if ($filename=="") { $filename = $this->_generateFilename(); } $feedFile = fopen($filename, "w+"); if ($feedFile) { fputs($feedFile,$this->createFeed()); fclose($feedFile); if ($displayContents) { $this->_redirect($filename); } } else { echo "
Error creating feed file, please check write permissions.
"; } } /** * Outputs this feed directly to the browser - for on-the-fly feed generation * @since 1.7.2-mod * * still missing: proper header output - currently you have to add it manually */ function outputFeed() { echo $this->createFeed(); } } /** * FeedDate is an internal class that stores a date for a feed or feed item. * Usually, you won't need to use this. */ class FeedDate { /** @var int */ var $unix; /** * Creates a new instance of FeedDate representing a given date. * Accepts RFC 822, ISO 8601 date formats as well as unix time stamps. * @param mixed $dateString optional the date this FeedDate will represent. If not specified, the current date and time is used. */ function __construct($dateString="") { if ($dateString=="") $dateString = date("r"); if (is_numeric($dateString)) { $this->unix = $dateString; return; } if (preg_match("~(?:(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun),\\s+)?(\\d{1,2})\\s+([a-zA-Z]{3})\\s+(\\d{4})\\s+(\\d{2}):(\\d{2}):(\\d{2})\\s+(.*)~",$dateString,$matches)) { $months = Array("Jan"=>1,"Feb"=>2,"Mar"=>3,"Apr"=>4,"May"=>5,"Jun"=>6,"Jul"=>7,"Aug"=>8,"Sep"=>9,"Oct"=>10,"Nov"=>11,"Dec"=>12); $this->unix = mktime($matches[4],$matches[5],$matches[6],$months[$matches[2]],$matches[1],$matches[3]); if (substr($matches[7],0,1)=='+' OR substr($matches[7],0,1)=='-') { $tzOffset = (((int) substr($matches[7],0,3) * 60) + (int) substr($matches[7],-2)) * 60; } else { if (strlen($matches[7])==1) { $oneHour = 3600; $ord = ord($matches[7]); if ($ord < ord("M")) { $tzOffset = (ord("A") - $ord - 1) * $oneHour; } elseif ($ord >= ord("M") AND $matches[7]!="Z") { $tzOffset = ($ord - ord("M")) * $oneHour; } elseif ($matches[7]=="Z") { $tzOffset = 0; } } switch ($matches[7]) { case "UT": case "GMT": $tzOffset = 0; } } $this->unix += $tzOffset; return; } if (preg_match("~(\\d{4})-(\\d{2})-(\\d{2})T(\\d{2}):(\\d{2}):(\\d{2})(.*)~",$dateString,$matches)) { $this->unix = mktime($matches[4],$matches[5],$matches[6],$matches[2],$matches[3],$matches[1]); if (substr($matches[7],0,1)=='+' OR substr($matches[7],0,1)=='-') { $tzOffset = (((int) substr($matches[7],0,3) * 60) + (int) substr($matches[7],-2)) * 60; } else { if ($matches[7]=="Z") { $tzOffset = 0; } } $this->unix += $tzOffset; return; } $this->unix = 0; } /** * Gets the date stored in this FeedDate as an RFC 822 date. * * @return string a date in RFC 822 format */ function rfc822() { //return gmdate("r",$this->unix); $date = gmdate("D, d M Y H:i:s", $this->unix); if (TIME_ZONE!="") $date .= " ".str_replace(":","",TIME_ZONE); return $date; } /** * Gets the date stored in this FeedDate as an ISO 8601 date. * * @return string a date in ISO 8601 (RFC 3339) format */ function iso8601() { $date = gmdate("Y-m-d\TH:i:sO",$this->unix); if (TIME_ZONE!="") $date = str_replace("+0000",TIME_ZONE,$date); $date = substr($date,0,22) . ':' . substr($date,-2); return $date; } /** * Gets the date stored in this FeedDate as unix time stamp. * * @return int a date as a unix time stamp */ function unix() { return $this->unix; } } /** * RSSCreator10 is a FeedCreator that implements RDF Site Summary (RSS) 1.0. * * @see http://www.purl.org/rss/1.0/ * @since 1.3 * @author Kai Blankenhorn */ class RSSCreator10 extends FeedCreator { /** * Builds the RSS feed's text. The feed will be compliant to RDF Site Summary (RSS) 1.0. * The feed will contain all items previously added in the same order. * @return string the feed's complete text */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createGeneratorComment(); if ($this->cssStyleSheet=="") { $this->cssStyleSheet = "http://www.w3.org/2000/08/w3c-synd/style.css"; } $feed.= $this->_createStylesheetReferences(); $feed.= "\n"; $feed.= " syndicationURL."\">\n"; $feed.= " ".htmlspecialchars($this->title)."\n"; $feed.= " ".htmlspecialchars($this->description)."\n"; $feed.= " ".$this->link."\n"; if ($this->image!=null) { $feed.= " image->url."\" />\n"; } $now = new FeedDate(); $feed.= " ".htmlspecialchars($now->iso8601())."\n"; $feed.= " \n"; $feed.= " \n"; $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " items[$i]->link)."\"/>\n"; } $feed.= " \n"; $feed.= " \n"; $feed.= " \n"; if ($this->image!=null) { $feed.= " image->url."\">\n"; $feed.= " ".htmlspecialchars($this->image->title)."\n"; $feed.= " ".$this->image->link."\n"; $feed.= " ".$this->image->url."\n"; $feed.= " \n"; } $feed.= $this->_createAdditionalElements($this->additionalElements, " "); $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " items[$i]->link)."\">\n"; //$feed.= " Posting\n"; $feed.= " text/html\n"; if ($this->items[$i]->date!=null) { $itemDate = new FeedDate($this->items[$i]->date); $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; } if ($this->items[$i]->source!="") { $feed.= " ".htmlspecialchars($this->items[$i]->source)."\n"; } if ($this->items[$i]->author!="") { $feed.= " ".htmlspecialchars($this->items[$i]->author)."\n"; } $feed.= " ".htmlspecialchars(strip_tags(strtr($this->items[$i]->title,"\n\r"," ")))."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->link)."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->description)."\n"; $feed.= $this->_createAdditionalElements($this->items[$i]->additionalElements, " "); $feed.= " \n"; } $feed.= "\n"; return $feed; } } /** * RSSCreator091 is a FeedCreator that implements RSS 0.91 Spec, revision 3. * * @see http://my.netscape.com/publish/formats/rss-spec-0.91.html * @since 1.3 * @author Kai Blankenhorn */ class RSSCreator091 extends FeedCreator { /** * Stores this RSS feed's version number. * @access private */ var $RSSVersion; /** * Constructor */ function __construct() { $this->_setRSSVersion("0.91"); $this->contentType = "application/rss+xml"; } /** * Sets this RSS feed's version number. * @access private * * @param $version */ function _setRSSVersion($version) { $this->RSSVersion = $version; } /** * Builds the RSS feed's text. The feed will be compliant to RDF Site Summary (RSS) 1.0. * The feed will contain all items previously added in the same order. * @return string the feed's complete text */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createGeneratorComment(); $feed.= $this->_createStylesheetReferences(); $feed.= "RSSVersion."\">\n"; $feed.= " \n"; $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->title),100)."\n"; $this->descriptionTruncSize = 500; $feed.= " ".$this->getDescription()."\n"; $feed.= " ".$this->link."\n"; $now = new FeedDate(); $feed.= " ".htmlspecialchars($now->rfc822())."\n"; $feed.= " ".FEEDCREATOR_VERSION."\n"; if ($this->image!=null) { $feed.= " \n"; $feed.= " ".$this->image->url."\n"; $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->image->title),100)."\n"; $feed.= " ".$this->image->link."\n"; if ($this->image->width!="") { $feed.= " ".$this->image->width."\n"; } if ($this->image->height!="") { $feed.= " ".$this->image->height."\n"; } if ($this->image->description!="") { $feed.= " ".$this->image->getDescription()."\n"; } $feed.= " \n"; } if ($this->language!="") { $feed.= " ".$this->language."\n"; } if ($this->copyright!="") { $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->copyright),100)."\n"; } if ($this->editor!="") { $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->editor),100)."\n"; } if ($this->webmaster!="") { $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->webmaster),100)."\n"; } if ($this->pubDate!="") { $pubDate = new FeedDate($this->pubDate); $feed.= " ".htmlspecialchars($pubDate->rfc822())."\n"; } if ($this->category!="") { // Changed for DokuWiki: multiple categories are possible if(is_array($this->category)) foreach($this->category as $cat){ $feed.= " ".htmlspecialchars($cat)."\n"; }else{ $feed.= " ".htmlspecialchars($this->category)."\n"; } } if ($this->docs!="") { $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->docs),500)."\n"; } if ($this->ttl!="") { $feed.= " ".htmlspecialchars($this->ttl)."\n"; } if ($this->rating!="") { $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->rating),500)."\n"; } if ($this->skipHours!="") { $feed.= " ".htmlspecialchars($this->skipHours)."\n"; } if ($this->skipDays!="") { $feed.= " ".htmlspecialchars($this->skipDays)."\n"; } $feed.= $this->_createAdditionalElements($this->additionalElements, " "); $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " \n"; $feed.= " ".FeedCreator::iTrunc(htmlspecialchars(strip_tags($this->items[$i]->title)),100)."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->link)."\n"; $feed.= " ".$this->items[$i]->getDescription()."\n"; if ($this->items[$i]->author!="") { $feed.= " ".htmlspecialchars($this->items[$i]->author)."\n"; } /* // on hold if ($this->items[$i]->source!="") { $feed.= " ".htmlspecialchars($this->items[$i]->source)."\n"; } */ if ($this->items[$i]->category!="") { // Changed for DokuWiki: multiple categories are possible if(is_array($this->items[$i]->category)) foreach($this->items[$i]->category as $cat){ $feed.= " ".htmlspecialchars($cat)."\n"; }else{ $feed.= " ".htmlspecialchars($this->items[$i]->category)."\n"; } } if ($this->items[$i]->comments!="") { $feed.= " ".htmlspecialchars($this->items[$i]->comments)."\n"; } if ($this->items[$i]->date!="") { $itemDate = new FeedDate($this->items[$i]->date); $feed.= " ".htmlspecialchars($itemDate->rfc822())."\n"; } if ($this->items[$i]->guid!="") { $feed.= " ".htmlspecialchars($this->items[$i]->guid)."\n"; } $feed.= $this->_createAdditionalElements($this->items[$i]->additionalElements, " "); if ($this->RSSVersion == "2.0" && $this->items[$i]->enclosure != null) { $feed.= " items[$i]->enclosure->url; $feed.= "\" length=\""; $feed.= $this->items[$i]->enclosure->length; $feed.= "\" type=\""; $feed.= $this->items[$i]->enclosure->type; $feed.= "\"/>\n"; } $feed.= " \n"; } $feed.= " \n"; $feed.= "\n"; return $feed; } } /** * RSSCreator20 is a FeedCreator that implements RDF Site Summary (RSS) 2.0. * * @see http://backend.userland.com/rss * @since 1.3 * @author Kai Blankenhorn */ class RSSCreator20 extends RSSCreator091 { /** * Constructor */ function __construct() { parent::_setRSSVersion("2.0"); } } /** * PIECreator01 is a FeedCreator that implements the emerging PIE specification, * as in http://intertwingly.net/wiki/pie/Syntax. * * @deprecated * @since 1.3 * @author Scott Reynen and Kai Blankenhorn */ class PIECreator01 extends FeedCreator { /** * Constructor */ function __construct() { $this->encoding = "utf-8"; } /** * Build content * @return string */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createStylesheetReferences(); $feed.= "\n"; $feed.= " ".FeedCreator::iTrunc(htmlspecialchars($this->title),100)."\n"; $this->descriptionTruncSize = 500; $feed.= " ".$this->getDescription()."\n"; $feed.= " ".$this->link."\n"; $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " \n"; $feed.= " ".FeedCreator::iTrunc(htmlspecialchars(strip_tags($this->items[$i]->title)),100)."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->link)."\n"; $itemDate = new FeedDate($this->items[$i]->date); $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->guid)."\n"; if ($this->items[$i]->author!="") { $feed.= " \n"; $feed.= " ".htmlspecialchars($this->items[$i]->author)."\n"; if ($this->items[$i]->authorEmail!="") { $feed.= " ".$this->items[$i]->authorEmail."\n"; } $feed.=" \n"; } $feed.= " \n"; $feed.= "
".$this->items[$i]->getDescription()."
\n"; $feed.= " \n"; $feed.= " \n"; } $feed.= "\n"; return $feed; } } /** * AtomCreator10 is a FeedCreator that implements the atom specification, * as in http://www.atomenabled.org/developers/syndication/atom-format-spec.php * Please note that just by using AtomCreator10 you won't automatically * produce valid atom files. For example, you have to specify either an editor * for the feed or an author for every single feed item. * * Some elements have not been implemented yet. These are (incomplete list): * author URL, item author's email and URL, item contents, alternate links, * other link content types than text/html. Some of them may be created with * AtomCreator10::additionalElements. * * @see FeedCreator#additionalElements * @since 1.7.2-mod (modified) * @author Mohammad Hafiz Ismail (mypapit@gmail.com) */ class AtomCreator10 extends FeedCreator { /** * Constructor */ function __construct() { $this->contentType = "application/atom+xml"; $this->encoding = "utf-8"; } /** * Build content * @return string */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createGeneratorComment(); $feed.= $this->_createStylesheetReferences(); $feed.= "language!="") { $feed.= " xml:lang=\"".$this->language."\""; } $feed.= ">\n"; $feed.= " ".htmlspecialchars($this->title)."\n"; $feed.= " ".htmlspecialchars($this->description)."\n"; $feed.= " link)."\"/>\n"; $feed.= " ".htmlspecialchars($this->link)."\n"; $now = new FeedDate(); $feed.= " ".htmlspecialchars($now->iso8601())."\n"; if ($this->editor!="") { $feed.= " \n"; $feed.= " ".$this->editor."\n"; if ($this->editorEmail!="") { $feed.= " ".$this->editorEmail."\n"; } $feed.= " \n"; } $feed.= " ".FEEDCREATOR_VERSION."\n"; $feed.= "syndicationURL . "\" />\n"; $feed.= $this->_createAdditionalElements($this->additionalElements, " "); $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " \n"; $feed.= " ".htmlspecialchars(strip_tags($this->items[$i]->title))."\n"; $feed.= " items[$i]->link)."\"/>\n"; if ($this->items[$i]->date=="") { $this->items[$i]->date = time(); } $itemDate = new FeedDate($this->items[$i]->date); $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->link)."\n"; $feed.= $this->_createAdditionalElements($this->items[$i]->additionalElements, " "); if ($this->items[$i]->author!="") { $feed.= " \n"; $feed.= " ".htmlspecialchars($this->items[$i]->author)."\n"; $feed.= " \n"; } if ($this->items[$i]->description!="") { $feed.= " ".htmlspecialchars($this->items[$i]->description)."\n"; } if ($this->items[$i]->enclosure != null) { $feed.=" items[$i]->enclosure->url ."\" type=\"". $this->items[$i]->enclosure->type."\" length=\"". $this->items[$i]->enclosure->length . "\" />\n"; } $feed.= " \n"; } $feed.= "\n"; return $feed; } } /** * AtomCreator03 is a FeedCreator that implements the atom specification, * as in http://www.intertwingly.net/wiki/pie/FrontPage. * Please note that just by using AtomCreator03 you won't automatically * produce valid atom files. For example, you have to specify either an editor * for the feed or an author for every single feed item. * * Some elements have not been implemented yet. These are (incomplete list): * author URL, item author's email and URL, item contents, alternate links, * other link content types than text/html. Some of them may be created with * AtomCreator03::additionalElements. * * @see FeedCreator#additionalElements * @since 1.6 * @author Kai Blankenhorn , Scott Reynen */ class AtomCreator03 extends FeedCreator { /** * Constructor */ function __construct() { $this->contentType = "application/atom+xml"; $this->encoding = "utf-8"; } /** * Build content * @return string */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createGeneratorComment(); $feed.= $this->_createStylesheetReferences(); $feed.= "language!="") { $feed.= " xml:lang=\"".$this->language."\""; } $feed.= ">\n"; $feed.= " ".htmlspecialchars($this->title)."\n"; $feed.= " ".htmlspecialchars($this->description)."\n"; $feed.= " link)."\"/>\n"; $feed.= " ".htmlspecialchars($this->link)."\n"; $now = new FeedDate(); $feed.= " ".htmlspecialchars($now->iso8601())."\n"; if ($this->editor!="") { $feed.= " \n"; $feed.= " ".$this->editor."\n"; if ($this->editorEmail!="") { $feed.= " ".$this->editorEmail."\n"; } $feed.= " \n"; } $feed.= " ".FEEDCREATOR_VERSION."\n"; $feed.= $this->_createAdditionalElements($this->additionalElements, " "); $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { $feed.= " \n"; $feed.= " ".htmlspecialchars(strip_tags($this->items[$i]->title))."\n"; $feed.= " items[$i]->link)."\"/>\n"; if ($this->items[$i]->date=="") { $this->items[$i]->date = time(); } $itemDate = new FeedDate($this->items[$i]->date); $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($itemDate->iso8601())."\n"; $feed.= " ".htmlspecialchars($this->items[$i]->link)."\n"; $feed.= $this->_createAdditionalElements($this->items[$i]->additionalElements, " "); if ($this->items[$i]->author!="") { $feed.= " \n"; $feed.= " ".htmlspecialchars($this->items[$i]->author)."\n"; $feed.= " \n"; } if ($this->items[$i]->description!="") { $feed.= " ".htmlspecialchars($this->items[$i]->description)."\n"; } $feed.= " \n"; } $feed.= "\n"; return $feed; } } /** * MBOXCreator is a FeedCreator that implements the mbox format * as described in http://www.qmail.org/man/man5/mbox.html * * @since 1.3 * @author Kai Blankenhorn */ class MBOXCreator extends FeedCreator { /** * Constructor */ function __construct() { $this->contentType = "text/plain"; $this->encoding = "utf-8"; } /** * @param string $input * @param int $line_max * @return string */ function qp_enc($input = "", $line_max = 76) { $hex = array('0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'); $lines = preg_split("/(?:\r\n|\r|\n)/", $input); $eol = "\r\n"; $escape = "="; $output = ""; while( list(, $line) = each($lines) ) { //$line = rtrim($line); // remove trailing white space -> no =20\r\n necessary $linlen = strlen($line); $newline = ""; for($i = 0; $i < $linlen; $i++) { $c = substr($line, $i, 1); $dec = ord($c); if ( ($dec == 32) && ($i == ($linlen - 1)) ) { // convert space at eol only $c = "=20"; } elseif ( ($dec == 61) || ($dec < 32 ) || ($dec > 126) ) { // always encode "\t", which is *not* required $h2 = floor($dec/16); $h1 = floor($dec%16); $c = $escape.$hex["$h2"].$hex["$h1"]; } if ( (strlen($newline) + strlen($c)) >= $line_max ) { // CRLF is not counted $output .= $newline.$escape.$eol; // soft line break; " =\r\n" is okay $newline = ""; } $newline .= $c; } // end of for $output .= $newline.$eol; } return trim($output); } /** * Builds the MBOX contents. * @return string the feed's complete text */ function createFeed() { $icnt = count($this->items); $feed = ""; for ($i=0; $i<$icnt; $i++) { if ($this->items[$i]->author!="") { $from = $this->items[$i]->author; } else { $from = $this->title; } $itemDate = new FeedDate($this->items[$i]->date); $feed.= "From ".strtr(MBOXCreator::qp_enc($from)," ","_")." ".date("D M d H:i:s Y",$itemDate->unix())."\n"; $feed.= "Content-Type: text/plain;\n"; $feed.= " charset=\"".$this->encoding."\"\n"; $feed.= "Content-Transfer-Encoding: quoted-printable\n"; $feed.= "Content-Type: text/plain\n"; $feed.= "From: \"".MBOXCreator::qp_enc($from)."\"\n"; $feed.= "Date: ".$itemDate->rfc822()."\n"; $feed.= "Subject: ".MBOXCreator::qp_enc(FeedCreator::iTrunc($this->items[$i]->title,100))."\n"; $feed.= "\n"; $body = chunk_split(MBOXCreator::qp_enc($this->items[$i]->description)); $feed.= preg_replace("~\nFrom ([^\n]*)(\n?)~","\n>From $1$2\n",$body); $feed.= "\n"; $feed.= "\n"; } return $feed; } /** * Generate a filename for the feed cache file. Overridden from FeedCreator to prevent XML data types. * @return string the feed cache filename * @since 1.4 * @access private */ function _generateFilename() { $fileInfo = pathinfo($_SERVER["PHP_SELF"]); return substr($fileInfo["basename"],0,-(strlen($fileInfo["extension"])+1)).".mbox"; } } /** * OPMLCreator is a FeedCreator that implements OPML 1.0. * * @see http://opml.scripting.com/spec * @author Dirk Clemens, Kai Blankenhorn * @since 1.5 */ class OPMLCreator extends FeedCreator { /** * Constructor */ function __construct() { $this->encoding = "utf-8"; } /** * Build content * @return string */ function createFeed() { $feed = "encoding."\"?>\n"; $feed.= $this->_createGeneratorComment(); $feed.= $this->_createStylesheetReferences(); $feed.= "\n"; $feed.= " \n"; $feed.= " ".htmlspecialchars($this->title)."\n"; if ($this->pubDate!="") { $date = new FeedDate($this->pubDate); $feed.= " ".$date->rfc822()."\n"; } if ($this->lastBuildDate!="") { $date = new FeedDate($this->lastBuildDate); $feed.= " ".$date->rfc822()."\n"; } if ($this->editor!="") { $feed.= " ".$this->editor."\n"; } if ($this->editorEmail!="") { $feed.= " ".$this->editorEmail."\n"; } $feed.= " \n"; $feed.= " \n"; $icnt = count($this->items); for ($i=0;$i<$icnt; $i++) { $feed.= " items[$i]->title,"\n\r"," "))); $feed.= " title=\"".$title."\""; $feed.= " text=\"".$title."\""; //$feed.= " description=\"".htmlspecialchars($this->items[$i]->description)."\""; $feed.= " url=\"".htmlspecialchars($this->items[$i]->link)."\""; $feed.= "/>\n"; } $feed.= " \n"; $feed.= "\n"; return $feed; } } /** * HTMLCreator is a FeedCreator that writes an HTML feed file to a specific * location, overriding the createFeed method of the parent FeedCreator. * The HTML produced can be included over http by scripting languages, or serve * as the source for an IFrame. * All output by this class is embedded in
tags to enable formatting * using CSS. * * @author Pascal Van Hecke * @since 1.7 */ class HTMLCreator extends FeedCreator { var $contentType = "text/html"; /** * Contains HTML to be output at the start of the feed's html representation. */ var $header; /** * Contains HTML to be output at the end of the feed's html representation. */ var $footer ; /** * Contains HTML to be output between entries. A separator is only used in * case of multiple entries. */ var $separator; /** * Used to prefix the stylenames to make sure they are unique * and do not clash with stylenames on the users' page. */ var $stylePrefix; /** * Determines whether the links open in a new window or not. */ var $openInNewWindow = true; var $imageAlign ="right"; /** * In case of very simple output you may want to get rid of the style tags, * hence this variable. There's no equivalent on item level, but of course you can * add strings to it while iterating over the items ($this->stylelessOutput .= ...) * and when it is non-empty, ONLY the styleless output is printed, the rest is ignored * in the function createFeed(). */ var $stylelessOutput =""; /** * Writes the HTML. * @return string the scripts's complete text */ function createFeed() { // if there is styleless output, use the content of this variable and ignore the rest if ($this->stylelessOutput!="") { return $this->stylelessOutput; } //if no stylePrefix is set, generate it yourself depending on the script name if ($this->stylePrefix=="") { $this->stylePrefix = str_replace(".", "_", $this->_generateFilename())."_"; } //set an openInNewWindow_token_to be inserted or not $targetInsert = ""; if ($this->openInNewWindow) { $targetInsert = " target='_blank'"; } // use this array to put the lines in and implode later with "document.write" javascript $feedArray = array(); if ($this->image!=null) { $imageStr = "". "". FeedCreator::iTrunc(htmlspecialchars($this->image->title),100). "image->width) { $imageStr .=" width='".$this->image->width. "' "; } if ($this->image->height) { $imageStr .=" height='".$this->image->height."' "; } $imageStr .="/>"; $feedArray[] = $imageStr; } if ($this->title) { $feedArray[] = "
". FeedCreator::iTrunc(htmlspecialchars($this->title),100)."
"; } if ($this->getDescription()) { $feedArray[] = "
". str_replace("]]>", "", str_replace("getDescription())). "
"; } if ($this->header) { $feedArray[] = "
".$this->header."
"; } $icnt = count($this->items); for ($i=0; $i<$icnt; $i++) { if ($this->separator and $i > 0) { $feedArray[] = "
".$this->separator."
"; } if ($this->items[$i]->title) { if ($this->items[$i]->link) { $feedArray[] = "
".FeedCreator::iTrunc(htmlspecialchars(strip_tags($this->items[$i]->title)),100). "
"; } else { $feedArray[] = "
". FeedCreator::iTrunc(htmlspecialchars(strip_tags($this->items[$i]->title)),100). "
"; } } if ($this->items[$i]->getDescription()) { $feedArray[] = "
". str_replace("]]>", "", str_replace("items[$i]->getDescription())). "
"; } } if ($this->footer) { $feedArray[] = "
".$this->footer."
"; } $feed= "".join($feedArray, "\r\n"); return $feed; } /** * Overrrides parent to produce .html extensions * * @return string the feed cache filename * @since 1.4 * @access private */ function _generateFilename() { $fileInfo = pathinfo($_SERVER["PHP_SELF"]); return substr($fileInfo["basename"],0,-(strlen($fileInfo["extension"])+1)).".html"; } } /** * JSCreator is a class that writes a js file to a specific * location, overriding the createFeed method of the parent HTMLCreator. * * @author Pascal Van Hecke */ class JSCreator extends HTMLCreator { var $contentType = "text/javascript"; /** * writes the javascript * @return string the scripts's complete text */ function createFeed() { $feed = parent::createFeed(); $feedArray = explode("\n",$feed); $jsFeed = ""; foreach ($feedArray as $value) { $jsFeed .= "document.write('".trim(addslashes($value))."');\n"; } return $jsFeed; } /** * Overrrides parent to produce .js extensions * * @return string the feed cache filename * @since 1.4 * @access private */ function _generateFilename() { $fileInfo = pathinfo($_SERVER["PHP_SELF"]); return substr($fileInfo["basename"],0,-(strlen($fileInfo["extension"])+1)).".js"; } } /** * This class allows to override the hardcoded charset * * @author Andreas Gohr */ class DokuWikiFeedCreator extends UniversalFeedCreator{ /** * Build content * * @param string $format * @param string $encoding * @return string */ function createFeed($format = "RSS0.91",$encoding='iso-8859-15') { $this->_setFormat($format); $this->_feed->encoding = $encoding; return $this->_feed->createFeed(); } } //Setup VIM: ex: et ts=4 :