Help:ListPages



“ListPages” is a function which dynamically outputs page titles and optionally content from pages in a certain category. It shares some similar functions with Dynamic Page List, but it much more efficient.

Required elements
 category= name count= number order= type 


 * The category, count, and order elements are mandatory. Omitting any of the three will cause the function to fail.
 * ListPages can only be used for main namespace pages and Blog: namespace pages.

Replace name with the name of the category (e.g.  will display a list of pages in the People category.)

Replace number with the number of page titles you wish displayed (e.g.  will display 6 pages from the category you choose from).

By default, there will be next/prev navigation buttons on the bottom of the list. This allows the user to see more links. To disable the navigation button, add another element:

Using this element a user can sort articles in a specified manner.

There are several types of ordering:


 * This sorts pages by when they reach “published” status, reverse chronologically. A page is “published” when it receives a score of 9 or higher, where votes are worth one point and unique commentors are worth 0.25 points.
 * For this field to work, you must also have added  as an element.
 * For this field to work, you must also have added  as an element.


 * This sorts the pages in reverse chronological order by creation date (the most recently created articles in that category appear first).
 * If you want to include only unpublished pages, add  as an element.
 * If you want to include only unpublished pages, add  as an element.


 * This sorts pages by their rating, with the highest rated pages on top. This can only be used for pages that have ratings boxes on them.
 * If you want to order them with lowest pages on top, add another element:.
 * If you want to order them with lowest pages on top, add another element:.


 * This sorts pages by when they were last edited
 * This sorts pages by when they were last edited

5-star rating elements
Note: Do not use these if the pages in the category have non-5-star voting boxes (typically Blog: pages) – they are mutually exclusive.


 * This will show the 5 star rating box and average rating directly on the page, allowing the user to rate the page by clicking on the stars.
 * This will show the 5 star rating box and average rating directly on the page, allowing the user to rate the page by clicking on the stars.


 * This will only show those pages where at least Number users have rated it.
 * This will only show those pages where at least Number users have rated it.

Showing an image from the article
By default, a listpage will not display an image. It will only display the title of the page if: If these are included, the listpage will display a thumbnail picture of the image next to the title of the page (if there is more than one image, it will display the image highest alphabetically).
 * The  --  element is included; and
 * The page has a  in it.

Showing text from the article
By default, a listpage will not display text from any of the pages (it will only display the title). To display text, use: showblurb=Number will make the font size of the blurb smaller.

Hiding the Date
By default, a listpage will show how many days ago the article was created. To hide the date, use:

Hiding the Stats
By default, a listpage will show how many votes and comments an article has, as a line of text under the article’s name.
 * To hide this data, use:
 * To put an icon to the left of the article name showing the number of comments, use:
 * To put an icon to the left of the article name showing the number of votes, use: