From mediawiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
Release status: experimental
Implementation User rights
Description Allows to override per page permissions based on a whitelist
Author(s) WikiWorks team
License GNU General Public License 2.0 or later
  • $wgGroupWhitelistSourcePage
  • $wgGroupWhitelistAPIAllow
  • $wgGroupWhitelistRights
  • $wgGroupWhitelistGroup
Translate the GroupWhitelist extension if it is available at translatewiki.net

Check usage and version matrix.

The extension allows to grant users from selected group with a special per-page rights specifying affected pages list on a regular wiki page.

This extension was created for WikiWorks.


  • Download and place the file(s) in a directory called GroupWhitelist in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'GroupWhitelist' );
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parameters[edit]

  • $wgGroupWhitelistRights - A list of actions to be allowed
  • $wgGroupWhitelistGroup - A group affected by the extension
  • $wgGroupWhitelistSourcePage - A page to look for list of whitelisted pages
  • $wgGroupWhitelistAPIAllow - API modules to be always granted with the right

The default configuration is:

$wgGroupWhitelistRights = ['edit'];
$wgGroupWhitelistGroup = 'user';
$wgGroupWhitelistSourcePage = 'Mediawiki:Whitelist';
$wgGroupWhitelistAPIAllow = [];

and the Mediawiki:Whitelist contents could be:

* SomePage1
// Comments are allowed
* SomePage2
* SomaPage3

The settings above allow users from a `user` group to `edit` pages specified in the `Mediawiki:Whitelist` page contents (`SomePage1`, `SomePage2`, `SomePage3`).

See also[edit]

Wikiteq - logo.png This extension is professionally maintained by the WikiTeq team.