Extension:RottenLinks
 Release status: stable |
|
|---|---|
.png) |
|
| Description | Provides the Special page Special:RottenLinks. |
| Author(s) | John Lewis, Universal Omega |
| Maintainer(s) | Miraheze system administrators |
| Latest version | continuous updates |
| MediaWiki | 1.39+ |
| PHP | 7.2+ |
| Database changes | Yes |
| Composer | miraheze/rotten-links |
| License | GNU General Public License 3.0 or later |
| Download | GitHub: README CHANGELOG |
|
|
|
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.
Installation
- Download and place the file(s) in a directory called
RottenLinksin yourextensions/folder. - Add the following code at the bottom of your LocalSettings.php file:
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.
If you would like to use RottenLinks with MediaWiki 1.39, you have to use the REL1_39 branch.
Configuration
$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. $wgRottenLinksHTTPProxy- Sets a proxy to use for requests. Defaults to
""(use no proxy). Example:$wgRottenLinksHTTPProxy = "http://username:password@proxy.example.com:8080"; $wgRottenLinksExcludeProtocols- Holds a list of protocols that should not be checked for validity. Defaults to
[ "tel", "mailto" ]. $wgRottenLinksExternalLinkTarget- Sets the external link target (
_selffor the current tab or_blankfor 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" ];
Usage
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".
| This extension is included in the following wiki farms/hosts and/or packages: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |
| This extension is maintained by Miraheze. Some Miraheze extensions are very Miraheze-specific and you may encounter issues you don't see on Miraheze. To report a bug or request a configuration change, please do so on the Miraheze Issue Tracker and not on Wikimedia Phabricator. |