CaRP Evolution Box
Web This Site

CaRP: Caching RSS Parser - Documentation


CaRP Interactive FAQ
Getting Started: Free Download | Purchase | Install
Reference: Functions | Plugins | Themes | Full Index
Etc.: Display Formatting | Example Code | Affiliates

Miscellaneous Settings


carperrors: Specifies whether or not to display CaRP's error messages. Note that this setting does not affect PHP errors. Valid values are:

Example:
	require_once '/path/to/carp.php';
	CarpConf('carperrors',0);
	CarpCacheShow('http://www.geckotribe.com/press/rss/pr.rss');
	
phperrors: Specifies whether or not to display PHP errors, notices, etc. Valid values are:

Example:
	require_once '/path/to/carp.php';
	CarpConf('phperrors',E_ALL);
	CarpCacheShow('http://www.geckotribe.com/press/rss/pr.rss');
	
noitems: A message to display if no news items are found (generally because the filterin and/or filterout settings have filtered out all the items in the newsfeed). To make this message show up, shownoitems must be set to "1". If this message is displayed, nothing else will be displayed (no channel data, etc.). The default value is 'No news items found'.

shownoitems: Specifies where or not to use the "noitems" setting or to proceed as if that setting didn't exist. Valid values are:

Example:
	require_once '/path/to/carp.php';
	CarpConf('filterin','CaRP');
	CarpConf('shownoitems',1);
	CarpConf('noitems','No press releases about CaRP were found.');
	CarpCacheShow('http://www.geckotribe.com/press/rss/pr.rss');
	
descriptiontags: A list of HTML tag names, separated by pipes (|), which are allowed in the DESCRIPTION fields (both for ITEMs and the CHANNEL)--all others will be handled as specified by the removebadtags setting. For paired tags like <a href="..."> and </a>, you should name both tags in the list. Only the tag name should be indicated, not the entire tag.

Example:
	require_once '/path/to/carp.php';
	CarpConf('descriptiontags','b|/b|i|/i'); // allow only bold and italics opening and closing tags
	CarpCacheShow('http://www.geckotribe.com/press/rss/pr.rss');
	
removebadtags: Specifies whether to remove or entity encode HTML tags not listed int he descriptiontags setting. Valid values are:


carp_banned_tags: [CaRP >= 4.0 only] This setting is NOT set using CarpConf, but is specified as a constant in carpconf.php. Any HTML tags listed will always be removed from the description regardless of whether they're listed in the "descriptiontags" setting or not. The tags listed here are those that could most easily be used for security exploits.

strip-xhtml-prefixes: [CaRP >= 4.0 only] Specifies whether to remove namespace prefixes from XHTML content in Atom feeds. Valid values are:


outputformat: Specifies which of CaRP's output modes to use. Valid values are:


maxgroupfilter: Specifies the maximum number of feeds to refetch during a single call to CarpGroupFilter. The default number is 3.

afield: [CaRP >= 4.0.7 only] The value of this setting will be output after each "field" (the things listed in the iorder, cborder and caorder settings). By default, a newline is output. In a webpage, this is displayed as a single space. By setting it to '' (empty), for example, fields can be displayed without a space appearing between them.

aitem: [CaRP >= 4.0.7 only] The value of this setting will be output after each feed item (ie. story, post or entry). This setting should only be altered to omit the newline character (it's default value) -- for all other purposes, use the "ai" setting instead.