- This extension is currently under development - it may be in beta testing on specific wikis, but may not be widely available for some time.
“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 is much more efficient.
<ListPages> category= name count= number order= type </ListPages>
- 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.
category=People will display a list of pages in the People category.)
Replace number with the number of page titles you wish displayed (e.g.
count=6 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
published=Yesas 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
published=Noas 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:
- This sorts pages by when they were last edited
5-star rating elementsEdit
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 only show those pages where at least Number users have rated it.
Showing an image from the articleEdit
By default, a listpage will not display an image. It will only display if:
ShowPicture=Yeselement is included, and
- The page has a
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).
Showing text from the articleEdit
By default, a listpage will not display text from any of the pages (it will only display the title). To display text, use:
- Number should be the number of characters from the article you want to display
- Adding the element
BlurbFontSize=Smallwill make the font size of the blurb smaller.
Hiding the DateEdit
By default, a listpage will show how many days ago the article was created. To hide the date, use:
Hiding the StatsEdit
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: