Documentation: comments/list.php

comments/list.php - List comments available for a given anchor

This page features various elements, depending of the layout selected for the anchor.

Following principles have been selected for threads that start at anchor page:

The anchor page (articles/view.php) features a first set of comments (1..COMMENTS_PER_PAGE).

Therefore, this script lists following pages of comments (page 2, 3, etc.).

The link to comments is actually the link to the anchor page (e.g., 'articles/view.php/123#comments').
Page 1 (e.g., 'comments/view.php/article/123') lists comments COMMENTS_PER_PAGE+1..2*COMMENTS_PER_PAGE.
Each comment features links to Reply, Quote, Edit and Delete, taking proper access restrictions into account.
The link to add a comment is labelled 'Add your own comment'.

This applies to following layouts:

compact
daily
decorated
jive
manual
yabb

Following principles have been selected for other layouts:

This script is used to list every comments, and the anchor page (articles/view.php)

only has a 'Discuss this page (### comments)' links.

The link to comments is actually the link to this page (e.g., 'comments/list.php/article/123').
Page 1 (e.g., 'comments/view.php/article/123') lists comments 1..COMMENTS_PER_PAGE, etc.
Each comment features links to Reply, Quote, Edit and Delete, taking proper access restrictions into account.
The link to add a comment is labelled 'Add your own comment'.

This applies to following layouts:

alistapart
boxesandarrows
table
wiki

Access is granted only if the surfer is allowed to view the anchor page.

Accepted calls:

list.php?anchor=article:<id>
list.php/<article>/<id>

If the anchor for this item 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.

Licence: GNU Lesser General Public License

Auteurs:

Bernard Paques bernard.paques@bigfoot.com

Testeurs:

Agnes