MediaWiki extensions manual

LinkFilter Release status: stableCategory:Stable extensions
Implementation	Special page Category:Special page extensions
Description	Adds some new special pages and a parser hook for link submitting/approval/reject
Author(s)	Aaron Wright David Pean Jack Phoenix
Latest version	3.5.0 (2017-07-11)
MediaWiki	1.43+Category:Extensions with manual MediaWiki version
Database changes	Yes
Tables	link
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control
Parameters $wgLinkPageDisplay $wgLinkFilterTypes
Added rights linkadmin
Hooks used APIGetAllowedParams Category:APIGetAllowedParams extensions ArticleDelete Category:ArticleDelete extensions ArticleFromTitle Category:ArticleFromTitle extensions Comment::add Category:Comment::add extensions Comment::delete Category:Comment::delete extensions LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions PageMoveComplete Category:PageMoveComplete extensions ParserFirstCallInit Category:ParserFirstCallInit extensions
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

• 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

• 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/run.php sql extensions/LinkFilter/sql/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

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

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

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.