සැකිල්ල:Cat handler/blacklist/doc

This is a documentation subpage for සැකිල්ල:Cat handler/blacklist.
It may contain usage information, categories and other content that is not part of the original සැකිල්ල page.

This template is used on 1,000,000+ pages.
To avoid large-scale disruption and unnecessary server load, any changes to this template should first be tested in its /sandbox or /testcases subpages or in your own user subpage. The tested changes can then be added to this page in one single edit. Please consider discussing any changes on the talk page before implementing them.

This is the {{cat handler/blacklist}} sub-template.

Do not use this template directly, use {{cat handler}} instead. This template is called from {{cat handler}}, see user documentation there.

But if you came here to see or update the category suppression blacklist, then you are in the right place.

Updating the blacklist

This template contains a blacklist of the pages and page types where templates should not auto-categorize. This blacklist is used by {{cat handler}} to decide when not to categorize. To update the blacklist, edit this template.

This template uses {{if pagename}} to do the pagename-detection, thus see {{if pagename}} for the syntax to use for the blacklist rules.

When this template is placed on a page that should not categorize, then it should return "hide". And when placed on any other page it should return an empty string.

Testing the blacklist

There are two ways you can test what this blacklist returns for a page:

You can put this template on the page you want to test, and see what output it produces. You can use edit preview, no need to save. Like this:

+{{cat handler/blacklist}}+

Which here on this page returns this:

++

The ++ used here is a simple way to make it visible when a template returns an empty string.

Or you can feed the pagename you want to test to this template. Then you can do all the testing for instance on the [[සැකිල්ල:Pgn/testcases|/testcases]] subpage of this template. Like this:

+{{cat handler/blacklist| page = User:Example }}+

+{{cat handler/blacklist| page = User:Example/Archive 5}}+

Which returns this:

++

+hide+

Technical details

Currently this template is only called from {{cat handler}}, and indirectly from all templates that use {{cat handler}}. But in the future this template might also be directly called from other templates similar to {{cat handler}}. This means we can update the category suppression blacklist in one place.

Updating the blacklist

Testing the blacklist

Technical details

See also