MediaWiki extensions manual
Release status: stable
Implementation Special page
Description Adds some new special pages and a parser hook for link submitting/approval/reject
Latest version 3.5.0 (2017-07-11)
MediaWiki 1.39+
Database changes Yes
Tables link
License GNU General Public License 2.0 or later
  • $wgLinkPageDisplay
  • $wgLinkFilterTypes
  • linkadmin
Quarterly downloads 0
Translate the LinkFilter extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

LinkFilter is an extension to allow users to submit news (etc.) links and wiki admins/other privileged users to approve them.

In addition to the new special pages, LinkFilter also provides ‎<linkfilter> parser hook tag.

New special pages edit

  • Special:LinkSubmit
  • Special:LinkApprove (available to users with linkadmin right)
  • Special:LinkEdit (redirects to LinkSubmit form, allowing to edit the link details, target etc.)
  • Special:LinksHome
  • Special:LinkRedirect

Install edit

  • Download and move the extracted LinkFilter 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/LinkFilter
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'LinkFilter' );
  • Run the update script which will automatically create the necessary database tables that this extension needs.
    • If a pre-r90829 version of SocialProfile extension is installed on the wiki, you'll need to patch the existing user_stats table by running patch-columns_for_user_stats.sql against it (try php maintenance/sql.php extensions/LinkFilter/patch-columns_for_user_stats.sql from command line)
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration edit

  • $wgLinkFilterTypes — an array of link types that will be available in the dropdown menu on Special:LinkSubmit. If this is not defined, LinkFilter will use the defaults in Link::$link_types. The defaults are the same as Link::$link_types currently:
$wgLinkFilterTypes = array(
	1 => 'Arrest Report',
	2 => 'Awesome',
	3 => 'Cool',
	4 => 'Funny',
	6 => 'Interesting',
	7 => 'Obvious',
	8 => 'OMG WTF?!?',
	9 => 'Rumor',
	10 => 'Scary',
	11 => 'Stupid',
  • $wgLinkPageDisplay — not really a configuration variable per se. Used to display different stuff on LinkFilter pages. For example, setting $wgLinkPageDisplay['in_the_news'] = true; will display "In the News" section on Special:LinksHome.

Customization edit

You can edit the general instructions displayed to everyone on Special:LinkSubmit by editing MediaWiki:Linkfilter-instructions.

Admins instructions can be edited through MediaWiki:Linkfilter-admin-instructions.

User rights edit

The extension adds one new user right, linkadmin. Users with this right are able to use LinkFilter's administrative functions, such as approve/reject links. By default, linkadmin, staff and sysop groups have this right.