rss

Functions
	blog_rss_add_http_header ($context, $title, $filtertype, $filterselect=0, $tagid=0)
	Build the URL for the RSS feed amd add it as a header.
	blog_rss_delete_file ($userid)
	Delete the supplied user's cached blog post RSS feed.
	blog_rss_file_name ($type, $id, $tagid=0)
	Retrieve the location and file name of a cached RSS feed.
	blog_rss_get_feed ($context, $args)
	Generate any blog RSS feed via one function.
	blog_rss_get_params ($filters)
	Utility function to extract parameters needed to generate RSS URLs from the blog filters.
	blog_rss_get_url ($contextid, $userid, $filtertype, $filterselect=0, $tagid=0)
	Build the URL for the RSS feed.
	blog_rss_print_link ($context, $filtertype, $filterselect=0, $tagid=0, $tooltiptext='')
	Print the link for the RSS feed with the correct RSS icon (Theme based)
	blog_rss_save_file ($type, $id, $tagid=0, $contents='')
	This function saves to file the rss feed specified in the parameters.

Detailed Description

Function Documentation

blog_rss_add_http_header()

blog_rss_add_http_header	(		$context,
			$title,
			$filtertype,
			$filterselect = 0,
			$tagid = 0 )

Build the URL for the RSS feed amd add it as a header.

Parameters

stdClass	$context	The context under which the URL should be created
string	$title	Name for the link to be added to the page header
string	$filtertype	The source of the RSS feed (site/course/group/user)
int	$filterselect	The id of the item defined by $filtertype
int	$tagid	The id of the row in the tag table that identifies the RSS Feed

blog_rss_delete_file()

blog_rss_delete_file

(

$userid

)

Delete the supplied user's cached blog post RSS feed.

Only user blogs are available by RSS. This doesn't call rss_delete_file() as blog RSS caching uses it's own file structure.

Parameters

int

$userid

blog_rss_file_name()

blog_rss_file_name	(		$type,
			$id,
			$tagid = 0 )

Retrieve the location and file name of a cached RSS feed.

Parameters

string	$type	The source of the RSS feed (site/course/group/user)
int	$id	The id of the item defined by $type
int	$tagid	The id of the row in the tag table that identifies the RSS Feed

Return values

string

blog_rss_get_feed()

blog_rss_get_feed	(		$context,
			$args )

Generate any blog RSS feed via one function.

Parameters

stdClass	$context	The context of the blog for which the feed it being generated
array	$args	An array of arguements needed to build the feed (contextid, token, componentname, type, id, tagid)

blog_rss_get_params()

blog_rss_get_params

(

$filters

)

Utility function to extract parameters needed to generate RSS URLs from the blog filters.

Parameters

array

$filters

filters for the blog

Return values

array

array containing the id of the user/course/group, the relevant context and the filter type: site/user/course/group

blog_rss_get_url()

blog_rss_get_url	(		$contextid,
			$userid,
			$filtertype,
			$filterselect = 0,
			$tagid = 0 )

Build the URL for the RSS feed.

Parameters

int	$contextid	The context under which the URL should be created
int	$userid	The id of the user requesting the RSS Feed
string	$filtertype	The source of the RSS feed (site/course/group/user)
int	$filterselect	The id of the item defined by $filtertype
int	$tagid	The id of the row in the tag table that identifies the RSS Feed

Return values

string

blog_rss_print_link()

blog_rss_print_link	(		$context,
			$filtertype,
			$filterselect = 0,
			$tagid = 0,
			$tooltiptext = '' )

Print the link for the RSS feed with the correct RSS icon (Theme based)

Parameters

stdClass	$context	The context under which the URL should be created
string	$filtertype	The source of the RSS feed (site/course/group/user)
int	$filterselect	The id of the item defined by $filtertype
int	$tagid	The id of the row in the tag table that identifies the RSS Feed
string	$tooltiptext	The tooltip to be displayed with the link

blog_rss_save_file()

blog_rss_save_file	(		$type,
			$id,
			$tagid = 0,
			$contents = '' )

This function saves to file the rss feed specified in the parameters.

Parameters

string	$type	The source of the RSS feed (site/course/group/user)
int	$id	The id of the item defined by $type
int	$tagid	The id of the row in the tag table that identifies the RSS Feed
string	$contents	The contents of the RSS Feed file

Return values

bool	whether the save was successful or not