Extension:MassEditRegex

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

Release status: stable

MassEditRegex.png
Implementation Page action, Special page
Description Use regular expressions to edit multiple pages at once
Author(s) Adam Nielsen (Malvineoustalk)
Latest version 8.0.0 (2015-02-07)
MediaWiki 1.23+
License GPL
Download
Added rights

masseditregex

Hooks used
SkinTemplateNavigation::Universal

BaseTemplateToolbox

Translate the MassEditRegex extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

The MassEditRegex extension allows administrators to perform a single edit across multiple pages in one step, by running a regular expression over the content of each page. This is well suited to performing simple edits such as renaming a template, adding pages to a category, or correcting typos (all of which can be done in the same edit operation by supplying multiple regular expressions.)

Usage[edit | edit source]

Once the extension has been installed and permission masseditregex to use MassEditRegex has been given, go to "Special:MassEditRegex" and fill out the edit form (see screenshot). Familiarity with regular expressions is required to use this extension.

Features[edit | edit source]

  • New in version 8.0.0: Page iteration can be done on the client side, so PHP maximum execution time is no longer an issue when editing large numbers of pages.
  • Transform each page using one or more regular expressions in a single step
  • Edits appear as "bot" so they don't show up in the normal edit list (unless the user chooses to show bot edits)
  • Only users with the masseditregex permission can perform changes
  • A new 'edit all' tab appears on category pages and on Special:WhatLinksHere, for editing all listed pages at once
  • Pages to edit can be specified as:
    • A list of page names
    • A list of page name prefixes (e.g. "Test" will match pages called "Testing" and "Tested")
    • A list of categories (all pages within the categories will be edited)
    • A list of backlinks (pages edited are those linking to the ones in the list)

Installation[edit | edit source]

  • Download and place the file(s) in a directory called MassEditRegex in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/MassEditRegex/MassEditRegex.php";

Configuration[edit | edit source]

The user right "masseditregex" will have to be set for an existing user group, e.g. "sysop" or preferably for a new user group:

$wgGroupPermissions['sysop']['masseditregex'] = true;
$wgGroupPermissions['masseditregex']['masseditregex'] = true;

Bugs / Known Issues[edit | edit source]

  • Server-side execution is the default as it (should) be faster. However editing large numbers of pages will cause server timeouts due to PHP limits on script execution time. To work around this (and perhaps to get better feedback on progress) you can tick 'execute in browser' to have the job tracking done on the client-side. This should mean timeouts are no longer a problem.

See also[edit | edit source]