Extension:Random In Category

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png
Random In Category

Release status: stable

Implementation Special page
Description Allows to direct the user to a random page in specified category
Author(s) Victor Vasiliev (VasilievVVtalk)
Latest version 2.0 (2011-01-31)
MediaWiki 1.16+
Database changes No
License GPLv2 or later
Download

Translate the Random In Category extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

The Random In Category extension allows you to direct the user to a random page in specified category.

Usage[edit | edit source]

Very similarly to Special:Random, you can specify a category name as a parameter to the page. Thus, "Special:RandomInCategory/Foo" or "Special:RandomPageInCategory/Foo" (MW ≥ MW 1.22) will get you a page from the "Foo" category.

Comparison to Core[edit | edit source]

MediaWiki version: 1.22

In MediaWiki 1.22, a Special:RandomInCategory feature was added to core. The core version gives much more biased results then this extension (However, it has much less performance overhead). Versions of this extension for MediaWiki 1.22 and greater change the name that this extension provides from "Special:RandomInCategory", to Special:RandomPageInCategory to prevent conflict with the core feature.

Download[edit | edit source]

You can download the extension directly from the MediaWiki source code repository (browse code). You can get:

One of the extensions tags

Not all extensions have tags. Some extensions have tags for each release, in which case those tags have the same stability as the release. To download a tag

  • Go to the tags list
  • Click the name of the tag you want to download
  • Click "snapshot"
The latest version of one of the extensions branches

Each extension has a master branch containing the latest code (might be unstable). Extensions can have further branches as well.

  • Go to the branches list
  • Click the branch name
  • Click "snapshot"
A snapshot made during the release of a MediaWiki version.

This might be unstable and is not guaranteed to work with the associated MediaWiki version.

After you've got the code, save it into the extensions/RandomInCategory directory of your wiki.

If you are familiar with git and have shell access to your server, you can obtain the extension, with all its tags and branches, as follows:

cd extensions
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/RandomInCategory.git

Installation[edit | edit source]

  • Download and extract the file(s) in a directory called RandomInCategory in your extensions/ folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/RandomInCategory/RandomInCategory.php";
  • Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.