Jump to content

Extension:ThrottleOverride

From mediawiki.org
MediaWiki extensions manual
ThrottleOverride
Release status: beta
Implementation User rights , Special page
Description Allows administrative overriding of IP-address throttles (editing, page moves, account creation, etc.)
Author(s) Tyler Romeo (Parent5446talk)
Latest version 0.6.0 (2016-10-05)
MediaWiki 1.25+
PHP 5.3+
Database changes Yes
License GNU General Public License 3.0 or later
Download
  • $wgThrottleOverrideTypes
  • $wgThrottleOverrideCentralWiki
  • $wgThrottleOverrideCIDRLimit
throttleoverride
Quarterly downloads 2 (Ranked 138th)
Translate the ThrottleOverride extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The ThrottleOverride extensions provides an interface for overriding certain rate limits in MediaWiki for temporary or indefinite amounts of time. Throttle exemptions are applied to IP addresses or IP address ranges, and can affect the page edit, page move, account creation, password recovery, and user email throttles. This is useful if a wiki administrator is expecting and authorizes a large number of edits, account creations, etc. from a single IP address.

Download

[edit]

The extension can be retrieved directly from Git [?]:

  • Browse code
  • Some extensions have tags for stable releases.
  • Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).

Extract the snapshot and place it in the extensions/ThrottleOverride/ directory of your MediaWiki installation.

If you are familiar with Git and have shell access to your server, you can also obtain the extension as follows:

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

Installation

[edit]
  • Download and move the extracted ThrottleOverride folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ThrottleOverride
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'ThrottleOverride' );
    // Who can use Special:OverrideThrottle ?
    // If you want that sysops can use it:
    $wgGroupPermissions['sysop']['throttleoverride'] = true;
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Usage

[edit]

The user-facing part of the extension are the special pages Special:OverrideThrottle and Special:ThrottleOverrideList. On the former, throttles can be overridden and existing throttles can be changed. On the latter, a list of all throttle exemptions that are currently active is shown.