Extension:TopTenPages

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear action run.svg
Top Ten Pages
Release status: unmaintained
TopTenPages.png
Implementation Tag, Special page
Description Allows to display the most popular pages of a wiki on a page
Author(s)
Latest version 0.4.0 (2015-06-27)
MediaWiki 1.25+
PHP 5.3+
Database changes No
License MIT License
Download
Parameters
$wgTopTenPagesStartAtOne
Tags
* <TopTenPages/>
  • <TopTenPages offset="1">5</TopTenPages>
Translate the TopTenPages extension if it is available at translatewiki.net
Check usage and version matrix.

The TopTenPages extension allows to display the most popular pages of the wiki on a page. It makes use of "Special:Popularpages" provided by the HitCounters extension.

Usage[edit]

<TopTenPages [offset=OFFSET]>[NUMBEROFPAGES]</TopTenPages>

or

{{Special:TopTenPages/OFFSET/NUMBEROFPAGES}}
OFFSET
Format: Number
Default: 0 or -
How many of the most popular Pages to ignore. (e.g. 1 to ignore the main page)
NUMBEROFPAGES
Format: Number
Default: 10
Maximum number of pages to be listed.

Examples[edit]

To show 10 most popular pages
<TopTenPages/> 
To show 5 most popular pages
<TopTenPages>5</TopTenPages>
To omit the most popular page(s)
<TopTenPages offset=1/> 

Installation[edit]

  • Make sure you installed the HitCounters extension which is required by this extension to work.
  • Download and place the file(s) in a directory called TopTenPages in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'TopTenPages' );
    
  • Configure as required
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'TopTenPages' );, you need to use:

require_once "$IP/extensions/TopTenPages/TopTenPages.php";

Configuration[edit]

$wgTopTenPagesStartAtOne (disabled by default)
Enable this to always start the list numbering at "1", even if an "offset" attribute was set.