|
This plugin is used to display an RSS (Really Simple Syndication) feed.
This alllows you to broadcast news from other sites.
Usage :
<plugin>display_rss[<param>param_name<value>param_value</value></param>]</plugin>
Parameters between [ & ] are optional ( [ & ] are not part of the plugin syntax... )
You can use several parameters.
Parameters List:
| Paramètre |
Valeur par défaut |
Description |
|
url
|
|
Mandatory: The adress of the RSS feed.
|
| |
|
nb_max_item
|
|
Maximum item number to retrieve.
|
|
nb_max_item_per_url
|
|
Maximum item number per RSS feed to retrieve.
(see advance use)
|
| |
|
date_format
|
%d/%m %H:%M |
strftime format string (see php doc).
|
|
date_sort
|
|
In most of RSS feeds, items are already sorted by date.
If you want to force a sort, simply use 1 as value...
|
| |
|
template_heading
|
<h2>%title%</h2>
<h4>%description%</h4>
<table> |
Gabarit de l'en-tête du flux RSS.
(ignoré lorsqu'on précise un paramètre type, et que celui-ci est différent de html
cf utilisation avancée)
|
| template_item |
<tr>
<td valign="top" nowrap>
<b>%date%</b>
</td>
<td>
<a href="%url%" target="_blank">%title%</a>
<br>%image%%description%
</td>
</tr>
|
RSS feed item template
(the default value differs when the type parameter is used, and its value is not html
see advanced use)
|
|
template_footing
|
</table>
|
RSS feed footing template
(ignored when the type parameter is used, and its value is not html
see advanced use)
|
| |
|
cache_age
|
20
|
Delay (in minutes), before asking again infos to server
|
Advanced Use :
- You can specify the url parameter more than once with different addresses.
This will allow you to make RSS feed agregation.
You will find the date_sort parameter usefull in that case...
- The url parameter can be used with the following syntax:
http://www.thesite.com/the_rss.htm|which_text|which_image
the | character is used as a field delimiter.
- The 1st field is the standard RSS feed url.
- The 2nd field is a text label which will replace, in the %which% variable, the value retrieved from the RSS feed.
- The 3rd field is the name of an image (already loaded in the site) which will replace, in the %which_image% variable, the value retrieved from the RSS feed.
- List of variables that can be used in the template_item parameter:
- %date% the item date retrieved from the RSS feed (if exists in the RSS feed)
- %url% a link retrieved from the RSS feed (it can be a link to the item, or to the site, according to the RSS feed)
- %title% The item title (if exists in the RSS feed)
- %description% The item description (if exists in the RSS feed)
- %which% name of the RSS feed
- %which_image% image of the RSS feed (if exists in the RSS feed)
- %br_which_image% value of %which_image%, with the
tag prefix, if value is not empty.
- %which_image_br% value of %which_image%, with the
tag suffix, if value is not empty.
- %image%
- %br_image% value of %image%, with the
tag prefix, if value is not empty.
- %image_br% value of %%mage%, with the
tag suffix, if value is not empty.
More, you can use the following parameters ( extract of the last_news plugin):
| Paramètre |
Valeur par défaut |
Description |
|
type
|
html
|
Possible values are :
-
html : Default behaviour where html code is generated, with no scrolling.
-
marquee : The scrolling is done in javascript if the navigator is compatible, otherwise the html <marquee> tag is used.
-
slideshow : The scrolling is done in javascript if the navigator is compatible, otherwise the html <marquee> tag is used..
-
marquee_tag : <marquee> tag is used.
|
| disable_pause_on_cursor |
0 |
use 1 to disable the pause when the mouse pointer is over the plugin area. |
| width |
|
Width (in pixel). |
| height |
|
Height (in pixel). |
| orientation |
vertical |
horizontal or vertical. |
When the type parameter is slideshow,
the default value of the template_item is :
<a title="%description%" target="_blank" href="%url%">%image_br%%date% %title%</a>
When the type parameter is marquee or marquee_tag ,
the default value of the template_item is :
<a title="%description%" target="_blank" href="%url%">%date% %title%</a>
Extra Parameter List
When type parameter value is equal to marquee or marquee_tag :
Following parameters are valid only if the page is displayed using
Microsoft Internet Explorer version 5.5 or later :
| Parameter |
Default Value |
Description |
| transition_type |
random |
| character delimited Transition List .
an empty list means that all transitions are used with their default parameters.
Transition Syntax:
transition_name;transition_parameters
Example :
GradientWipe;GradientSize=.50, wipeStyle=1, motion='reverse',duration=3|Slide;slideStyle='PUSH', bands=1
Following transition type are available:
Barn Blinds CheckBoard Fade GradientWipe Inset Iris Pixelate RadialWipe RandomBars RandomDissolve Slide Spiral Stretch Strips Wheel Zigzag
See Microsoft DirectX Transitions
By using the play pseudo transitio as the first one, transitions will be played in sequence instead of randomly. |
| transition_duration |
1 |
Number of seconds. |
| Parameter |
Default Value |
Description |
| scrollamount |
2 |
Number of scroll pixels. |
| scrolldelay |
20 |
Number of milliseconds between each scroll. |
Extra Parameter List
When type parameter value is equal to slideshow:
| Parameter |
Default Value |
Description |
| pause_delay |
7 |
Number of seconds to wait before displaying the next news. |
|