Wikipedia:Administrators' guide/Edit filters

This is an old revision of this page, as edited by Samwalton9 (talk | contribs) at 10:19, 21 September 2015 (added Category:Wikipedia edit filter using HotCat). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.

All administrators have a user right which allows them to view hidden filters created through the Edit filter extension. Additionally, admins can assign themselves the 'Edit filter manager' user right which allows them to edit the contents and settings of edit filters. Great care should be taken if editing edit filters as even the smallest mistake can cause huge disruption.

See Wikipedia:Edit filter for a full overview of the tool and MediaWiki:Extension:AbuseFilter/Rules format for technical help.

Viewing hidden filters

With the administrator user right you can now view the contents of hidden filters, as listed at Special:AbuseFilter. Hidden filters are private to avoid abusive users from learning out how to circumvent them, and thus their contents should not be shared publicly. If you wish to discuss the details of a hidden filter, the discussion should take place via email either with an edit filter manager directly or through the mailing list.

As well as being able to view the content and settings of a private filter, you can also view the logs associated with it. If you are interested in anti-vandal work you might consider periodically checking some of these logs for flagged edits and users.

Editing filters

Administrators cannot by default edit the conditions and settings of any edit filter, but may assign themselves the edit filter manager user right to do so. Assigning this right to yourself if you do not plan to edit filters is discouraged.

If you think a change should be made to an edit filter but you're not 100% confident how to enact that change, contact an experienced filter manager for advice or simply ask them to make the change; even the smallest mistake can cause huge disruption. Alternatively, you can help out at requested edit filters and false positive reports to learn how edit filters work and build up the skills required to help directly.

If you are confident in your knowledge of regular expressions and have read the relevant edit filter instruction pages, you may wish to start editing and creating edit filters. To avoid harm from mistakes, test all new filters in log only mode initially, and do not edit filters which have the disallow setting enabled without first temporarily switching them to log only mode unless you are completely confident in the change you are making. The test interface should also be used to check your syntax and test the filter against recent edits or edits by a particular user.