Extension:RottenLinks

MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
RottenLinks
Release status: stable
Ext-RottenLinks (2019).png
Description Provides the Special page Special:RottenLinks.
Maintainer(s) Miraheze system administrators
Latest version continuous updates
MediaWiki 1.35.3+
PHP 7.2+
Database changes Yes
License GNU General Public License 3.0 or later
Download
README
CHANGELOG

  • $wgRottenLinksBadCodes
  • $wgRottenLinksCurlTimeout
  • $wgRottenLinksExcludeProtocols
  • $wgRottenLinksExcludeWebsites
  • $wgRottenLinksExternalLinkTarget

Check usage and version matrix.

The RottenLinks extension provides the special page "Special:RottenLinks", which shows a table of all external links on your wiki pages, and tells you their status.

For reporting an issue or a bug, please use Miraheze Phabricator. See here for the workboard.

InstallationEdit

  • Download and place the file(s) in a directory called RottenLinks in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'RottenLinks' );
    
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • Configure as required.
  • Run the following script to populate the special page "Special:RottenLinks":
    php extensions/RottenLinks/maintenance/updateExternalLinks.php
    
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

ConfigurationEdit

$wgRottenLinksBadCodes
Holds a list of HTTP codes that are considered bad. Defaults to [ "0", "400", "401", "403", "404", "405", "502", "503", "504" ].
$wgRottenLinksCurlTimeout
Sets the timeout for cURL in seconds. Defaults to 30.
$wgRottenLinksExcludeProtocols
Holds a list of protocols that should not be checked for validity. Defaults to [ "tel", "mailto" ].
$wgRottenLinksExternalLinkTarget
Sets the external link target (_self for the current tab or _blank for new tab). Defaults to _self.
$wgRottenLinksExcludeWebsites
List of websites to blacklist checking of response codes for. Defaults to false. Omit the protocol, e.g. use $wgRottenLinksExcludeWebsites = [ "www.example.com" ];

UsageEdit

Run the "updateExternalLinks.php" script provided with the extension every time you would like to create or update the list of rotten links shown on special page "Special:RottenLinks".