Extension:Newest Pages Blog
This extension is currently not actively maintained! Although it may still work, any bug reports or feature requests will more than likely be ignored. If you are interested in taking on the task of developing and maintaining this extension, you can request repository ownership. As a courtesy, you may want to contact the author. You should also remove this template and list yourself as maintaining the extension in the page's {{extension}} infobox. |
 Release status: unstable |
|
|---|---|
| Implementation | Special page |
| Description | Adds an includable special page to MediaWiki which shows the most recently created or updated pages on the wiki, in weblog format. |
| Author(s) | Benjaminbradley |
| Latest version | 1.0 |
| License | GPL |
| Download | see here |
| Translate the Newest Pages Blog extension if it is available at translatewiki.net | |
| Check usage and version matrix. | |
The Newest Pages Blog extension adds an includable special page to MediaWiki which shows the most recently created or updated pages on the wiki, in weblog format. The format of the entries can be customized, and several query filtering options are available. The blog entries can be accessed as a regular special page, included within other pages as a form of dynamic list, or accessed as an RSS/Atom feed.
Installing the extensionEdit
To install the Newest Pages Blog extension, first upload/copy the extension files NewestPagesBlog.php and NewestPagesBlog.i18n.php into the subfolder NewestPagesBlog of your MediaWiki extensions directory. Then edit your LocalSettings.php file and add the following line:
require_once( "$IP/extensions/NewestPagesBlog/NewestPagesBlog.php" );
Save the file to complete the installation.
Accessing the special pageEdit
To access the special page in the regular view mode, go to Special:Newestpagesblog on your wiki, or select it from the list of special pages. The page has a default and maximum limit of 50 items, which can be customised using the supplied limit links, or with the 'limit' parameter in the page URL. To add customized parameters, use the following syntax:
...Special:NewestPagesBlog/parameter1=value1/parameter2=value2/etc
Parameters can include any combination of:
- limit=[number of pages to show]
- defaults to 50, the maximum value (to reduce strain on the database)
- namespace=[namespace of pages to show]
- default to all, use - for main namespace
- order=updated|new
- default to new, determines the order in which pages are pulled
- author=[user]
- default to all, pull only creations/updates by the given user
- format=blog|atom|rss
- default to blog, choose atom or rss for feed output
For example:
- - would show the 20 most recently updated pages in the "Talk" namespace
- - would show the 10 pages created most recently by the user Benjamin in the main namespace
Including the special pageEdit
To include the special page into another page, add the following wiki markup to that page:
- {{Special:NewestPagesBlog}}
This will be replaced with the blog entries when the containing page is rendered. To add customized parameters, use the following syntax:
- {{Special:NewestPagesBlog/parameter1=value1/parameter2=value2/etc}}
For example:
- {{Special:NewestPagesBlog/namespace=User}}
would show the newest pages in the user namespace. Use - to select the main namespace. To select a namespace AND set a limit, use syntax similar to the following:
- {{Special:NewestPagesBlog/namespace=User/limit=5}}
- {{Special:NewestPagesBlog/limit=5/namespace=User}}
Customising the interface textEdit
The interface text and message formats used in the Newest Pages Blog extension are customisable via the MediaWiki namespace. See Special:Allmessages for a list of customisable interface messages in the wiki. In addition to the messages used by the NewestPages extension, the NewestPagesBlog extension adds the following:
- newestpagesblog-dateformat - customizable date format - uses php's date() format - see http://us2.php.net/date
- newestpagesblog-entryformat - format of entry. can include special values:
- $1 - date, formatted according to above
- $2 - title of the page
- $3 - category list
- $4 - entry, brief format
- $5 - user who posted
- $6 - "created" or "updated" depending on if order is new or updated
- newestpagesblog-entryheader - shown before the entry list
- newestpagesblog-entryfooter - shown after the entry list
- newestpagesblog-summaryendmarker - the text which marks the end of the summary/description at the top of the page. Defaults to "----" which means that all text before the first horizontal line in the page will be used as the description" for that page.
Change logEdit
2006-06-14 Version 1.0 * Initial release
Feedback welcomed at bgcb11 at gmail.com