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
Getting Started: Free Download | Purchase | Install
Reference: Functions | Plugins | Themes | Full Index
Etc.: Display Formatting | Example Code | Affiliates
Item Link
Evolution | LE | Koi | SE |
All | All | All | All |
The item title may be displayed either as plain text or as a hyperlink. To display it as plain text, include the word "title" in your iorder setting. To display it as a link, include the word "link" in your cborder or caorder setting. To display the URL of the link, but not as a link, refer to the item URL page. Examples:
CarpConf('iorder','title,date,desc');or
CarpConf('iorder','link,date,desc');Display formatting options
The following options apply whether your are displaying the title as plain text or as a link:
- bilink ("before item link") : Specifies text and/or HTML to be displayed before the item title or link.
- ailink ("after item link") : Specifies text and/or HTML to be displayed after the item title or link.
- maxititle ("maximum item link length") : Specifies the maximum number of characters (not including HTML tags) to output from the title. If maxititle is zero ("0"), the entire title will be displayed, no matter how long.
- atruncititle ("after truncated item link") : Specifies text and/or HTML to append to the title if it is longer than maxititle. Note that when truncating, maxititle is reduced by the length of atruncititle so that the total length is equal to maxititle.
- defaultititle ("default item title") : Specifies text to use as an item title if the item does not specify one. The default value is "(no title)".
- ilinktitles ("item link titles") : Specifies whether to add a "title" attribute to the item link, containing the entire item title.
The primary purpose of this is to display the entire title as a "tool tip" if it has been trucated.
Specify one of the following values:
- 0: never insert a title attribute
- 1 (the default): if the item title has been truncated because it was longer than maxititle
- 2: always insert a title attribute
- ilink_attrs ("item link attributes") : [CaRP >= 4.0 only] the contents of this setting will be output inside the item title link tags. It can be used to, for example, add ' rel="nofollow"' to the item links.
- ilinkclass ("item link CSS class") [CaRP >= 2.0] : CSS class(es) to apply to the item link or title
- ilinkstyle ("item link CSS style") [CaRP >= 2.0] : CSS styling to apply to the item link or title
- linktarget ("link target") : Specifies which window or frame to open links in.
Specify one of the following values:
- 0 (the default): the current window (and frame, if in a frame set)
- 1: a new window
- 2: the same window, but ensure that it is not in a frame
- the name of a frame if in a frameset, or the name of a window (NOTE: the name must contain at least one character that is not a digit)
- ilinktarget ("item link target") : This setting has been replaced by the linktarget setting. In versions 3.1.1 to 3.6.4, this setting is supported for backwards compability. It has been removed from 4.0 and higher.
Example
CarpConf('iorder','link,desc'); CarpConf('bilink','<i>'); CarpConf('ailink','</i>'); CarpConf('maxititle',100); CarpConf('atruncititle','...'); CarpConf('ilinktitles',0); CarpConf('ilinkclass','myTextClassName'); CarpConf('ilinkstyle','text-decoration:none;color:#03c;');