From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg

Release status:Extension status stable

ImplementationTemplate:Extension#type Special page
DescriptionTemplate:Extension#description Adds some new special pages and a parser hook for link submitting/approval/reject
Author(s)Template:Extension#username Aaron Wright
David Pean
Jack Phoenix
Latest versionTemplate:Extension#version 3.5.0 (2017-07-11)
MediaWikiTemplate:Extension#mediawiki 1.21+
Database changesTemplate:Extension#needs-updatephp Yes
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
  • $wgLinkFilterTypes
  • $wgLinkPageDisplay
Added rightsTemplate:Extension#rights


Hooks usedTemplate:Extension#hook

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

Check usage and version matrix.


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


  • Download and place the file(s) in a directory called LinkFilter in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'LinkFilter' );
  • Run the update script which will automatically create the necessary database tables that this extension needs.
    • If a pre-r90829 version of the 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)
  • YesY Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


  • $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.


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.