Docs For Class FeedCreator

Description

FeedCreator is the abstract base implementation for concrete implementations that implement a specific format of syndication.

author: Kai Blankenhorn <kaib@bitfolge.de>
abstract:
since: 1.4

Located in /includes/feedcreator.class.php (line 464)

HtmlDescribable
   |
   --FeedCreator

Direct descendents

Class	Description
UniversalFeedCreator	UniversalFeedCreator lets you choose during runtime which format to build.
RSSCreator10	RSSCreator10 is a FeedCreator that implements RDF Site Summary (RSS) 1.0.
RSSCreator091	RSSCreator091 is a FeedCreator that implements RSS 0.91 Spec, revision 3.
PIECreator01	PIECreator01 is a FeedCreator that implements the emerging PIE specification, as in http://intertwingly.net/wiki/pie/Syntax.
AtomCreator03	DEPRICATED
AtomCreator10	AtomCreator10 is a FeedCreator that implements the atom specification,
MBOXCreator	MBOXCreator is a FeedCreator that implements the mbox format as described in http://www.qmail.org/man/man5/mbox.html
OPMLCreator	OPMLCreator is a FeedCreator that implements OPML 1.0.
HTMLCreator	HTMLCreator is a FeedCreator that writes an HTML feed file to a specific location, overriding the createFeed method of the parent FeedCreator.

Variable Summary

mixed $additionalElements

mixed $category

mixed $copyright

mixed $description

mixed $docs

mixed $editor

mixed $editorEmail

mixed $encoding

mixed $image

mixed $language

mixed $lastBuildDate

mixed $link

mixed $pubDate

mixed $rating

mixed $skipDays

mixed $skipHours

mixed $syndicationURL

mixed $title

mixed $ttl

mixed $webmaster

mixed $xslStyleSheet

Method Summary

static string iTrunc (string $string, int $length)

void addItem (object FeedItem $item)

string createFeed ()

void saveFeed ([filename $filename = ""], [redirect $displayContents = true])

void useCached ([filename $filename = ""], [timeout $timeout = 3600])

string _createAdditionalElements (elements $elements, [indentString $indentString = ""])

void _createGeneratorComment ()

void _createStylesheetReferences ()

Variables

mixed $additionalElements = array() (line 513)

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</$key> 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.

mixed $category (line 475)

mixed $copyright (line 475)

mixed $description (line 469)

mixed $docs (line 475)

mixed $editor (line 475)

mixed $editorEmail (line 475)

mixed $encoding = "UTF-8" (line 503)

This feed's character encoding.

since: 1.6.1

mixed $image (line 475)

mixed $language (line 475)

mixed $lastBuildDate (line 475)

mixed $link (line 469)

mixed $pubDate (line 475)

mixed $rating (line 475)

mixed $skipDays (line 475)

mixed $skipHours (line 475)

mixed $syndicationURL (line 475)

Optional attributes of a feed.

mixed $title (line 469)

Mandatory attributes of a feed.

mixed $ttl (line 475)

mixed $webmaster (line 475)

mixed $xslStyleSheet = "" (line 481)

The url of the external xsl stylesheet used to format the naked rss feed.

Ignored in the output when empty.

Inherited Variables

Inherited from HtmlDescribable

HtmlDescribable::$descriptionHtmlSyndicated
HtmlDescribable::$descriptionTruncSize

Methods

static iTrunc (line 539)

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.

return: the truncated string

string iTrunc (string $string, int $length)

string $string: string A string to be truncated.
int $length: length the maximum length the string should be truncated to

addItem (line 522)

Adds an FeedItem to the feed.

access: public

void addItem (object FeedItem $item)

object FeedItem $item: The FeedItem to add to the feed.

createFeed (line 607)

Builds the feed's text.

return: the feed's complete text
abstract:

string createFeed ()

Redefined in descendants as:

UniversalFeedCreator::createFeed() : Creates a syndication feed based on the items previously added.
RSSCreator10::createFeed() : Builds the RSS feed's text. The feed will be compliant to RDF Site Summary (RSS) 1.0.
RSSCreator091::createFeed() : Builds the RSS feed's text. The feed will be compliant to RDF Site Summary (RSS) 1.0.
PIECreator01::createFeed()
AtomCreator03::createFeed()
AtomCreator10::createFeed()
MBOXCreator::createFeed() : Builds the MBOX contents.
OPMLCreator::createFeed()
HTMLCreator::createFeed() : Writes the HTML.
JSCreator::createFeed() : writes the javascript

saveFeed (line 686)

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

void saveFeed ([filename $filename = ""], [redirect $displayContents = true])

filename $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()).
redirect $displayContents: boolean optional send an HTTP redirect header or not. If true, the user will be automatically redirected to the created file.

Redefined in descendants as:

UniversalFeedCreator::saveFeed() : 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.

useCached (line 667)

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

void useCached ([filename $filename = ""], [timeout $timeout = 3600])

filename $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()).
timeout $timeout: int optional the timeout in seconds before a cached version is refreshed (defaults to 3600 = 1 hour)

Redefined in descendants as:

UniversalFeedCreator::useCached() : Turns on caching and checks if there is a recent version of this feed in the cache.

_createAdditionalElements (line 584)

Creates a string containing all additional elements specified in $additionalElements.

return: the XML tags corresponding to $additionalElements

string _createAdditionalElements (elements $elements, [indentString $indentString = ""])

elements $elements: array an associative array containing key => value pairs
indentString $indentString: string a string that will be inserted before every generated line

_createGeneratorComment (line 572)

Creates a comment indicating the generator of this feed.

The format of this comment seems to be recognized by Syndic8.com.

void _createGeneratorComment ()

_createStylesheetReferences (line 594)

void _createStylesheetReferences ()

Inherited Methods

Inherited From HtmlDescribable

HtmlDescribable::getDescription()