Teamplaid:Category handler/blacklist
Actual code of this blacklist:
</noinclude>{{If pagename
<!-- Start of blacklist -->
| Main Page = hide <!-- Don't categorise the main page -->
<!-- Don't categorise on centralised cascade page or its subpages -->
| Wikipedia:Cascade-protected items/+ = hide
<!-- Don't categorise userboxes in their own "template space" -->
| User:UBX/+ = hide
| User talk:UBX/+ = hide
| Wikipedia:Template messages/* = hide <!-- Don't categorise on its subpages -->
| /archiv* = hide <!-- Don't categorise on /archive pages -->
<!-- End of blacklist -->
| page = {{{page|}}} <!-- Never change this one, see the doc -->
}}
This is the {{Category handler/blacklist}} sub-template.
Do not use this template directly, use {{Category handler}} instead. This template is called from {{Category 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
[deasaich]This template contains a blacklist of the pages and page types where templates should not auto-categorise. This blacklist is used by {{Category handler}} to decide when not to categorise. 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 categorise, then it should return "hide". And when placed on any other page it should return an empty string.
Testing the blacklist
[deasaich]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:
+{{Category 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 [[Teamplaid:Pgn/testcases|/testcases]] subpage of this template. Like this:
+{{Category handler/blacklist| page = User:Example }}++{{Category handler/blacklist| page = User:Example/Archive 5}}+
Which returns this:
Technical details
[deasaich]Currently this template is only called from {{Category handler}}, and indirectly from all templates that use {{Category handler}}. But in the future this template might also be directly called from other templates similar to {{Category handler}}. This means we can update the category suppression blacklist in one place.
See also
[deasaich]- Wikipedia:Category suppression for a "how-to" guide.
- Wikipedia:WikiProject Category Suppression
| The above documentation is transcluded from Teamplaid:Category handler/blacklist/documentation. (edit | history) Editors can experiment in this template's sandbox (create | mirror) and testcases (create) pages. Please add categories to the /documentation subpage. Subpages of this template. |
| This page is not a sandbox. It should not be used for test editing. To experiment, please use the Wikipedia sandbox, your user sandbox, or the other sandboxes. |