Documentation: sections/view.php

sections/view.php - View one section

The main panel has following elements:

top icons, if any --set in sub-section
the section itself, with details, introduction, and main text.
gadget boxes, if any --set in sub-sections
list of sub-sections.
list of related articles (from this section, or from sub-sections)
list of files, if option 'with_files'
list of comments, if option 'with_comments'
list of related links
bottom icons, if any --set in sub-section
list of inactive sub-section, for associates

If the section has been configured to not display sub-sections, no command to create a sub-section is displayed.

The extra panel has following elements:

A navigation box for flashy news (#news, #scrolling_news, or #rotating_news)
A contextual menu to switch to other sections in the neighbour
Up to 6 articles in extra boxes --set in sub-section
Extra boxes listing articles of some sub-sections
categories attached to this section
Links to rss feeds related to this section
Bookmarklet to post to this section
Related feeding servers, if any
Means to reference this page, into a sidebar box
The top popular referrals, if any

Several HTTP headers, or <meta> attributes of the displayed page, are set dynamically here to help advanced web usage. This includes:

a link to a RDF description of this page (e.g., '<link rel="meta" href="http://127.0.0.1/yacs/sections/describe.php/4310" title="rdf" type="application/rdf+xml" />')
a link to a RSS feed for this section (e.g., '<link rel="alternate" href="http://127.0.0.1/yacs/sections/feed.php/4038" title="RSS" type="application/rss+xml" />')
a rdf section implementing the trackback interface
a pingback link (e.g., '<link rel="pingback" href="http://here/yacs/services/pingback.php" />')

How to customize this page?

Well, there is so much you can do:

use a special bullet for a given section by posting the adequate image to this section
edit the section to use a skin variant, or another skin - see sections/edit.php
create a new layout for articles, to change the rendering of listed pages - see the table below

At the moment this script supports following layouts for articles:

Section option	Layout used
'boxesandarrows'	articles/layout_articles_as_boxesandarrows.php
'daily'	articles/layout_articles_as_daily.php
'jive'	articles/layout_articles_as_jive.php
'manual'	articles/layout_articles_as_manual.php
'table'	articles/layout_articles_as_table.php
'yabb'	articles/layout_articles_as_yabb.php

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:

view.php/12 (view the first page of the section document)
view.php?id=12 (view the first page of the section document)
view.php/12/sections/1 (view the page 1 of the list of related sections)
view.php?id=12&sections=1 (view the page 1 of the list of related sections)
view.php/12/articles/3 (view the page 3 of the list of related articles)
view.php?id=12&articles=3 (view the page 3 of the list of related articles)
view.php/12/comments/1 (view the page 1 of the list of related comments)
view.php?id=12&comments=1 (view the page 1 of the list of related comments)
view.php/12/files/2 (view the page 2 of the list of related files)
view.php?id=12&files=2 (view the page 2 of the list of related files)
view.php/12/links/1 (view the page 1 of the list of related links)
view.php?id=12&links=1 (view the page 1 of the list of related links)

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:

Fw_crocodile
Tof christophe@battarel.com
Elrik
GnapZ
Viviane Zaniroli
Fernand Le Chien
Lucrecius
Agnes
Guillaume Perez
Olivier

Reste à faire:

add a command to publish all articles in the section at once (hardboiled)
index presentation of articles (agnes)