CaRP: Caching RSS Parser - Display Formatting: Item Image

CaRP: Caching RSS Parser - Documentation

Item Image

Evolution	LE	Koi	SE
All	n/a	>=3.1	n/a

Displaying the Item Image
To display the item image, include the word "image" in your iorder setting. For example:

CarpConf('iorder','image,link,desc');

IMPORTANT NOTE
The settings described on this page apply only to images that the feed points to using <enclosure> and <image> elements. If the feed points to the images using HTML <img> tags, they must be displayed using the descriptiontags setting.

Display formatting options

biimage ("before item image") : Specifies text and/or HTML to be displayed before the item image.
aiimage ("after item image") : Specifies text and/or HTML to be displayed after the item image.
defiimageh ("default item image height") : The height in pixels for the item image if no height is specified by the newsfeed. If zero ("0"), no automatic height default is applied.
defiimagew ("default item image width") : The width in pixels for the item image if no width is specified by the newsfeed. If zero ("0"), no automatic width default is applied.
maxiimageh ("maximum item image height") : The maximum height in pixels for the item image. If zero ("0"), the image will not be scaled down, no matter how large it is, unless maxiimagew results in scaling. Depending on the image dimensions, the height may be scaled smaller in order to maintain the proper aspect ratio if maxiimagew is also specified. This setting is only applied if the newsfeed specifies an image height.
maxiimagew ("maximum item image width") : The maximum width in pixels for the item image. If zero ("0"), the image will not be scaled down, no matter how large it is, unless maxiimageh results in scaling. Depending on the image dimensions, the width may be scaled smaller in order to maintain the proper aspect ratio if maxiimageh is also specified. This setting is only applied if the newsfeed specifies an image width.
setiimageh ("set item image height") : The height in pixels of the item image. This dimension will be applied whether the newsfeed specifies a height or not. If both setiimageh and setiimagew are specified, the image may be distored depending on the settings and the image's actual dimensions. If only one is set, the aspect ratio will be preserved.
setiimagew ("set item image width") : The width in pixels of the item image. This dimension will be applied whether the newsfeed specifies a width or not. If both setiimageh and setiimagew are specified, the image may be distored depending on the settings and the image's actual dimensions. If only one is set, the aspect ratio will be preserved.

If setiimageh or setiimagew is specified, the default and maximum size settings are ignored. The default and maximum size settings, on the other hand, may be used together.

Example

CarpConf('iorder','image,link,desc');
CarpConf('biimage','<div style="float:left;margin-right:5px;">');
CarpConf('aiimage','</div>');
CarpConf('defiimagew',60);
CarpConf('maxiimagew',60);

The above settings will ensure that no image is displayed more than 60 pixels wide, whether the newsfeed specifies its dimensions or not.