Extension:LinkFilter

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear action run.svg
LinkFilter
Release status: stable
Implementation Special page
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.21+
Database changes Yes
License GNU General Public License 2.0 or later
Download
Parameters
  • $wgLinkFilterTypes
  • $wgLinkPageDisplay
Added rights
linkadmin
Hooks used
TitleMoveComplete
ArticleDelete
ArticleFromTitle
ParserFirstCallInit
LoadExtensionSchemaUpdates
CanonicalNamespaces
RenameUserSQL
Translate the LinkFilter extension if it is available at translatewiki.net
Check usage and version matrix.
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 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)
  • Yes 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.