Documentation: articles/index.php

articles/index.php - The index of published articles

Most pages of your YACS server are articles. As a result, articles support a rich set of features:

* The specific abstraction used for this kind of object is described in articles/articles.php.

* Also, articles can be considered as containers of some sort for images, files, etc. Check articles/article.php, which implements shared/anchor.php.

* Lastly, if you are looking to extend articles to something else, you should check the overlay interface, implemented in overlays/overlay.php, and then a live example such as overlays/recipe.php or overlays/poll.php.

This index page lists most recent regular articles to any surfer. Here, regular means that these pages have been published, and that they have not hit some deadline.

The main menu displays the total number of articles. It also has navigation links to browse past pages. Commands are available to either create a new page, to review submitted articles. Associates can also import some XML data, check the database, or populate saple pages.

A list of most popular articles is displayed as a sidebar, if the total number of articles in the database is significant.

Optionnally, categories to be displayed at this index page are listed as sidebar boxes.

This script secretely features a link to the main RSS feeder for this site, namely:

<link rel="alternate" href="http://.../yacs/feeds/rss_2.0.php" title="RSS" type="application/rss+xml" />

Restrictions apply on this page:

anonymous users can see only active pages (the 'active' field == 'Y')
members can see active and restricted pages ('active field == 'Y' or 'R')
associates can see all published articles

Accept following invocations:

index.php (view the 20 most recent articles)
index.php/10 (view articles 200 to 220, in the past)
index.php?page=4 (view articles 80 to 100, back in the past)

This script is a reference file of this system.

Licence: GNU Lesser General Public License

Auteurs:

Bernard Paques bernard.paques@bigfoot.com

Reste à faire:

layout_articles_as_yahoo to allow for maps of articles
layout_articles_as_blocks to allow easier modifications of navigation and extra boxes
layout_articles_as_approvals to be used in the review queue