Documentation: sections/feed.php

sections/feed.php - List new articles in the RSS 2.0 format

List up to ten fresh pages for one section only. At the moment, this script gives the list of the ten newest published articles, with following information:

title - the title of the article
url - the absolute url to fetch the article
time - the date and time of article last modification
author - the last contributor to the article
section - the label of the section from where the article is originated
image - the absolute url to fetch a related image, if any

Per-request authentication is based on HTTP basic authentication mechanism, as explained in RFC2617.

If an unknown user asks for the RSS feed, he will be prompted by his user agent to enter his name and password. This mechanism has been checked with FeedReader 2.7, Internet Explorer 6.0, and Mozilla 1.7.3.

The RFC explicitly allows for building URLs including the name and the password, as in the following example:

http://my_name:my_password@my_site/yacs/agents/feed.php

Such links can be used in user agents (i.e., a lot of poorly written news readers) that do not handle HTTP authentication properly. However, please note that Microsoft has recently removed support for such URLs. This may means that some news readers based on Internet Explorer won't be able to get YACS events log. If this occurs, please consider to switch to standard-conformant software such as Feedreader.

If following features are enabled, this script will use them:

compression - Through gzip, we have observed a shift from 3566 bytes to 881 bytes, meaning one Ethernet frame rather than three
cache - Cache is supported through ETag and by setting Content-Length; Also, Cache-Control enables caching for some time, even through HTTPS

Restrictions apply on this page:

associates and editors are allowed to move forward
permission is denied if the anchor is not viewable
access is restricted ('active' field == 'R'), but the surfer is an authenticated member
public access is allowed ('active' field == 'Y')
permission denied is the default

Accept following invocations:

feed.php/12
feed.php?id=12

If this section, or one of its anchor, specifies a specific skin (option keyword 'skin_xyz'), or a specific variant (option keyword 'variant_xyz'), they are used instead default values.

This script is a reference file of this system.

Voir aussi:

Licence: GNU Lesser General Public License

Auteurs:

Bernard Paques bernard.paques@bigfoot.com

Testeurs:

Ghjmora