Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match_all(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 876

Warning: Invalid argument supplied for foreach() in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 877

Warning: preg_replace(): Compilation failed: group name must start with a non-digit at offset 4 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 881

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902

Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902
<!DOCTYPE html>
<html lang="en" dir="ltr" class="client-nojs">
<head>
<title>View source for Template:Category handler/doc - HGRPG Wiki</title>
<meta charset="UTF-8" />
<meta name="generator" content="MediaWiki 1.21.1" />
<meta name="robots" content="noindex,nofollow" />
<link rel="next" href="http://ripred.net/wiki/index.php?title=Template:Category_handler/doc" />
<link rel="shortcut icon" href="/favicon.ico" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/opensearch_desc.php" title="HGRPG Wiki (en)" />
<link rel="EditURI" type="application/rsd+xml" href="http://ripred.net/wiki/api.php?action=rsd" />
<link rel="alternate" type="application/atom+xml" title="HGRPG Wiki Atom feed" href="/wiki/index.php?title=Special:RecentChanges&amp;feed=atom" />
<link rel="stylesheet" href="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=mediawiki.legacy.commonPrint&amp;only=styles&amp;skin=vector&amp;*" />
<link rel="stylesheet" href="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=mediawiki.legacy.shared&amp;only=styles&amp;skin=vector&amp;*" />
<link rel="stylesheet" href="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=skins.vector&amp;only=styles&amp;skin=vector&amp;*" />
<link rel="stylesheet" href="/wiki/skins/vector/screen.css?303" media="screen" /><meta name="ResourceLoaderDynamicStyles" content="" />
<link rel="stylesheet" href="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=site&amp;only=styles&amp;skin=vector&amp;*" />
<style>a:lang(ar), a:lang(ckb), a:lang(fa),a:lang(kk-arab), a:lang(mzn), a:lang(ps), a:lang(ur) { text-decoration: none; }</style>

<script src="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=startup&amp;only=scripts&amp;skin=vector&amp;*"></script>
<script>if(window.mw){
mw.config.set({"wgCanonicalNamespace":"Template","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":10,"wgPageName":"Template:Category_handler/doc","wgTitle":"Category handler/doc","wgCurRevisionId":162,"wgArticleId":77,"wgIsArticle":false,"wgAction":"edit","wgUserName":null,"wgUserGroups":["*"],"wgCategories":[],"wgBreakFrames":true,"wgPageContentLanguage":"en","wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""],"wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgMonthNamesShort":["","Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"],"wgRelevantPageName":"Template:Category_handler/doc","wgRestrictionEdit":[],"wgRestrictionMove":[],"wgWikiEditorEnabledModules":{"toolbar":true,"dialogs":true,"hidesig":true,"templateEditor":false,"templates":false,"preview":true,"previewDialog":false,"publish":true,"toc":false}});
}</script><script>if(window.mw){
mw.loader.implement("user.options", function () {
mw.user.options.set({"ccmeonemails":0,"cols":80,"date":"default","diffonly":0,"disablemail":0,"disablesuggest":0,"editfont":"default","editondblclick":0,"editsection":1,"editsectiononrightclick":0,"enotifminoredits":0,"enotifrevealaddr":0,"enotifusertalkpages":1,"enotifwatchlistpages":0,"extendwatchlist":0,"externaldiff":0,"externaleditor":0,"fancysig":0,"forceeditsummary":0,"gender":"unknown","hideminor":0,"hidepatrolled":0,"imagesize":2,"justify":0,"math":1,"minordefault":0,"newpageshidepatrolled":0,"nocache":0,"noconvertlink":0,"norollbackdiff":0,"numberheadings":0,"previewonfirst":0,"previewontop":1,"quickbar":5,"rcdays":7,"rclimit":50,"rememberpassword":0,"rows":25,"searchlimit":20,"showhiddencats":0,"showjumplinks":1,"shownumberswatching":1,"showtoc":1,"showtoolbar":1,"skin":"vector","stubthreshold":0,"thumbsize":2,"underline":2,"uselivepreview":0,"usenewrc":0,"watchcreations":0,"watchdefault":0,"watchdeletion":0,"watchlistdays":3,"watchlisthideanons":0,"watchlisthidebots":0,"watchlisthideliu":0,"watchlisthideminor":0,"watchlisthideown":0,"watchlisthidepatrolled":0,"watchmoves":0,"wllimit":250,"upwiz_deflicense":"default","upwiz_def3rdparty":"default","upwiz_deflicensetype":"default","upwiz_maxsimultaneous":"default","usebetatoolbar":1,"usebetatoolbar-cgd":1,"wikieditor-preview":1,"wikieditor-publish":1,"variant":"en","language":"en","searchNs0":true,"searchNs1":false,"searchNs2":false,"searchNs3":false,"searchNs4":false,"searchNs5":false,"searchNs6":false,"searchNs7":false,"searchNs8":false,"searchNs9":false,"searchNs10":false,"searchNs11":false,"searchNs12":false,"searchNs13":false,"searchNs14":false,"searchNs15":false,"searchNs460":false,"searchNs461":false});
;

}, {}, {});
}</script>
<script>if(window.mw){
mw.loader.implement("user.tokens", function () {
mw.user.tokens.set({"editToken":"+\\","patrolToken":false,"watchToken":false});
;

}, {}, {});
}</script>
<script>if(window.mw){
mw.loader.load(["mediawiki.page.startup","mediawiki.legacy.wikibits","mediawiki.legacy.ajax"]);
}</script>
<!--[if lt IE 7]><style type="text/css">body{behavior:url("/wiki/skins/vector/csshover.min.htc")}</style><![endif]--></head>
<body class="mediawiki ltr sitedir-ltr ns-10 ns-subject page-Template_Category_handler_doc skin-vector action-edit vector-animateLayout">
		<div id="mw-page-base" class="noprint"></div>
		<div id="mw-head-base" class="noprint"></div>
		<!-- content -->
		<div id="content" class="mw-body" role="main">
			<a id="top"></a>
			<div id="mw-js-message" style="display:none;"></div>
						<!-- firstHeading -->
			<h1 id="firstHeading" class="firstHeading" lang="en"><span dir="auto">View source for Template:Category handler/doc</span></h1>
			<!-- /firstHeading -->
			<!-- bodyContent -->
			<div id="bodyContent">
								<!-- subtitle -->
				<div id="contentSub"></div>
				<!-- /subtitle -->
																<!-- jumpto -->
				<div id="jump-to-nav" class="mw-jump">
					Jump to:					<a href="#mw-navigation">navigation</a>, 					<a href="#p-search">search</a>
				</div>
				<!-- /jumpto -->
								<!-- bodycontent -->
				<div id="mw-content-text"><hr />
<textarea readonly="" accesskey="," id="wpTextbox1" cols="80" rows="25" style="" lang="en" dir="ltr" name="wpTextbox1">{{documentation subpage}}
{{high-risk| 2,100,000+ }}
&lt;!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This is the {{tl|category handler}} meta-template.

It helps other templates to automate both categorization and [[Wikipedia:Category suppression|category suppression]]. 

Already when used with its default settings this template prevents auto-categorization in some namespaces and on some pages where we usually don't want categorization. Thus even the most basic usage like "&lt;code>&lt;nowiki>{{category handler|[[Category:Somecat]]}}&lt;/nowiki>&lt;/code>" sees to that templates don't auto-categorize in the wrong places.

This template makes it easy to choose in what namespaces a template should and should not categorize. And it makes it easy to use different categories in different namespaces. And this template uses a central blacklist where we can add pages and page types where templates should not auto-categorize.

=== When not to use this template ===

If a template only needs to categorize in one of the namespaces main (articles), file (images) or category, then using this template is overkill. Then instead use one of {{tl|main other}}, {{tl|file other}}, or {{tl|category other}}. But if your template needs to categorize in any other namespace, then we recommend you use this template, since it provides proper category suppression and makes it easy to select how to categorize in the different namespaces.

=== Namespaces ===

This template detects and groups all the different [[Wikipedia:Namespace|namespaces]] used on Wikipedia into several types. These types are used as parameter names in this template.

:'''main''' = Main/article space, as in normal Wikipedia articles.
:'''talk''' = Any talk space, such as page names that start with "Talk:", "User talk:", "File talk:" and so on.
:'''user, wikipedia, file, mediawiki, template, help, category, portal''' and '''book''' = The other namespaces except the talk pages.
:'''other''' = Any namespaces that were not specified as a parameter to the template. See examples below.

=== Basic usage ===

This template takes two or more parameters. Here's an example with the full template code for an article message box:

&lt;pre>
{{ambox
| text = This is a box used in articles.
}}{{category handler
| [[Category:Somecat]]
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}&lt;noinclude>

{{documentation}}
&lt;!--Add categories and interwikis to the /doc subpage-->
&lt;/noinclude>
&lt;/pre>

The above example uses the default settings for {{tlf|category handler}}. That means the box will categorize on pages in the following namespaces: 
:'''main''', '''file''', '''help''', '''category''', '''portal''' and '''book'''
But it will ''not'' categorize in the following namespaces:
:'''talk''', '''user''', '''wikipedia''', '''mediawiki''' and '''template'''

And it will ''not'' categorize on blacklisted pages. (See section [[#Blacklist|blacklist]] below.)

The reason this template does not categorize in some of the namespaces is that in those namespaces most templates are just demonstrated or listed, not used. Thus most templates should not categorize in those namespaces. 

Any template that is meant for one or more of the namespaces where this template categorizes can use the basic syntax as shown above.

=== Advanced usage ===

This template takes one or more parameters named after the different page types as listed in section [[#Namespaces|namespaces]] above. By using those parameters you can specify exactly in which namespaces your template should categorize. Like this:

&lt;pre>
{{mbox
| text = This is a box for articles and talk pages.
}}{{category handler
| main = [[Category:Somecat1]]   &lt;!--Categorize in main (article) space-->
| talk = [[Category:Somecat2]]   &lt;!--Categorize in talk space-->
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true" works-->
}}
&lt;/pre>

The above box will only categorize in main and talk space. But it will not categorize on /archive pages since they are blacklisted. (See section [[#Blacklist|blacklist]] below.) And if you need to demonstrate (discuss) that box on a talkpage, then you can feed "&lt;code>nocat=true&lt;/code>" to prevent that template from categorizing. (See section [[#Nocat|nocat]] below.) Like this:

&lt;pre>
== My new template ==
Hey guys, have you seen my new template?
{{mytemp|nocat=true}}
Nice, isn't it?
--~~~~
&lt;/pre>

Sometimes we want to use the same category in several namespaces, then do like this:

&lt;pre>
{{mbox
| text = This is a box used in several namespaces.
}}{{category handler
| main = [[Category:Somecat1]]
| 1 = [[Category:Somecat2]]   &lt;!--For help and user space-->
| help = 1
| user = 1
| talk =     &lt;!--No categories on talk pages-->
| other = [[Category:Somecat3]]   &lt;!--For all other namespaces-->
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}
&lt;/pre>

In the above example we use a numbered parameter to feed one of the categories, and then we tell this template to use that numbered parameter for both the help and user space.

This template understands the numbered parameters 1 to 10.

The '''other''' parameter defines what should be used in the remaining namespaces that have not explicitly been fed data.

Note the empty but defined '''talk''' parameter. That stops this template from showing what has been fed to the '''other''' parameter, when in talk space.

This template also has a parameter called '''all'''. It works like this:

&lt;pre>
{{mbox
| text = This is a box used in all namespaces.
}}{{category handler
| all = [[Category:Somecat1]]   &lt;!--Categorize in all namespaces-->
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}
&lt;/pre>

The above example will categorize in all namespaces, but not on blacklisted pages. If you want to demonstrate that box on a page, then use "&lt;code>nocat=true&lt;/code>" to prevent the template from categorizing. 

We suggest avoiding the '''all''' parameter, since templates should preferably only categorize in the namespaces they need to.

The all parameter can also be combined with the rest of the parameters. Like this:

&lt;pre>
{{mbox
| text = This is a box used in all namespaces.
}}{{category handler
| all = [[Category:Somecat1]]   &lt;!--Categorize in all namespaces-->
| main = [[Category:Somecat2]]   &lt;!--And add this in main space-->
| other = [[Category:Somecat3]]   &lt;!--And add this in all other namespaces-->
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}
&lt;/pre>

If the above box is placed on an article, then it will add the categories "Somecat1" and "Somecat2". But on all other types of pages it will instead add "Somecat1" and "Somecat3". As the example shows, the all parameter works independently of the rest of the parameters.

=== Subpages ===

This template understands the '''subpage''' parameter. Like this:

&lt;pre>
{{category handler
| subpage = no    &lt;!--Don't categorize on subpages-->
| wikipedia = [[Category:Somecat]]
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}
&lt;/pre>

If "&lt;code>subpage=no&lt;/code>" then this template will ''not'' categorize on subpages. For the rare occasion you ''only'' want to categorize on subpages, then use "&lt;code>subpage=only&lt;/code>". If '''subpage''' is empty or undefined then this template categorizes both on basepages and on subpages.

=== Blacklist ===

This template has a blacklist of the pages and page types where templates should not auto-categorize. Thus templates that use this meta-template will for instance not categorize on /archive pages and on the subpages of [[Wikipedia:Template messages]].

If you want a template to categorize on a blacklisted page, then feed "&lt;code>&lt;nowiki>nocat = false&lt;/nowiki>&lt;/code>" to the template when you place it on the page, thus skipping the blacklist check. Note that this template only categorizes if it has data for the namespace. For instance, if the basic syntax is used (see [[#Basic usage|basic usage]] above), then even if you set "&lt;code>nocat = false&lt;/code>" the template will not categorize on a talk page, since it has no data for talk pages. But it has data for help space, so on a blacklisted help page it will categorize.

The blacklist is in the sub-template {{tl|category handler/blacklist}}. To see or update the blacklist, go there.

=== The "nocat" parameter ===

This template understands the '''nocat''' parameter:

* If "&lt;code>nocat = true&lt;/code>" then this template does ''not'' categorize. 
* If '''nocat''' is empty or undefined then this template categorizes as usual. 
* If "&lt;code>nocat = false&lt;/code>" this template categorizes even when on blacklisted pages. (See section [[#Blacklist|blacklist]] above.)

Templates that use {{tlf|category handler}} should forward '''nocat''', so they too understand '''nocat'''. The code "&lt;code>&lt;nowiki>nocat = {{{nocat|}}}&lt;/nowiki>&lt;/code>" shown in the examples on this page does that.

=== The "categories" parameter ===

For backwards compatibility this template also understands the '''categories''' parameter. It works the same as '''nocat'''. Like this:

* If "&lt;code>categories  = no&lt;/code>" then this template does ''not'' categorize. 
* If '''categories''' is empty or undefined then this template categorizes as usual. 
* If "&lt;code>categories = yes&lt;/code>" this template categorizes even when on blacklisted pages.

When adding this template to a template that already uses the "&lt;code>categories = no&lt;/code>" logic, then you can do like this to not break any existing usage:

&lt;pre>
{{category handler
| [[Category:Somecat]]
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
| categories = {{{categories|}}}   &lt;!--So "categories=no" works-->
}}
&lt;/pre>

=== The "category2" parameter ===

For backwards compatibility this template kind of supports the old "category =" parameter. But the parameter name "category" is already used in this template to feed category data for when in category space. So instead this template uses '''category2''' for the usage similar to '''nocat'''. Like this:

* If "&lt;code>category2 =&lt;/code>" (empty but defined), or "&lt;code>category2 = no&lt;/code>", or if '''category2''' is fed any other data (except as described in the next two points), then this template does ''not'' categorize.
* If '''category2''' is undefined or if "&lt;code>category2 = ¬&lt;/code>", then this template categorizes as usual.
* If "&lt;code>category2 = yes&lt;/code>" this template categorizes even when on blacklisted pages.

When adding this template to a template that already uses the "&lt;code>category =&lt;/code>" logic, then you can do like this to not break any existing usage:

&lt;pre>
{{category handler
| [[Category:Somecat]]
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
| category2 = {{{category|¬}}}   &lt;!--So "category =" works-->
}}
&lt;/pre>

Note that the "&lt;code>¬&lt;/code>" is necessary, it helps this template to detect if the '''category''' parameter is defined but empty, or undefined.

=== Categories and text ===

Besides from categories, you can feed anything else to this template, for instance some text. Like this:

&lt;pre>
{{tmbox
| text = This is a talk page message box.
}}{{category handler
| talk = [[Category:Somecat]]
| other = :::::This template should only be used on talk pages.
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}
&lt;/pre>

When the template above is shown on anything else than a talk page, it will look like this (note the text below the box):

{{tmbox
| text = This is a talk page message box.
| nocat = true    &lt;!--So this box doesn't add "Category:Talk message boxes"-->
}}{{category handler
| talk = [[Category:Somecat]]
| other = :::::This template should only be used on talk pages.
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
}}

That text will not show on blacklisted pages, so don't use this method to show any important information. Feeding "&lt;code>nocat = true&lt;/code>" to the template hides the text, just as it suppresses any categories.

=== The "page" parameter ===

For testing and demonstration purposes this template can take a parameter named '''page'''. Like this:

&lt;pre>
{{category handler
| main = Category:Some cat
| talk = Category:Talk cat
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
| page = User talk:Example
}}
&lt;/pre>

In the above code we on purpose left out the brackets around the category names so we see the output on the page. No matter on what kind of page the code above is used it will return this:

:{{category handler
| main = Category:Some cat
| talk = Category:Talk cat
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
| page = User talk:Example
}}

The '''page''' parameter makes this template behave exactly as if on that page. Even the blacklist works. The pagename doesn't have to be an existing page.

If the '''page''' parameter is empty or undefined, the name of the current page determines the result.

You can make it so your template also understands the '''page''' parameter. That means you can test how your template will categorize on different pages, without having to actually edit those pages. Then do like this:

&lt;pre>
{{category handler
| main = Category:Some cat
| talk = Category:Talk cat
| nocat = {{{nocat|}}}   &lt;!--So "nocat=true/false" works-->
| page = {{{page|}}}   &lt;!--For testing-->
}}
&lt;/pre>

=== Parameters ===

List of all parameters:

&lt;pre>
{{category handler
| [[Category:Somecat]]
| subpage = no / only
| 1 =
...
| 10 =
| all = [[Category:Somecat]] / Text
| main = 1 / ... / 10 / [[Category:Somecat]] / Text
...
| other = 1 / ... / 10 / [[Category:Somecat]] / Text

| nocat = {{{nocat|}}} / true / false
| categories = {{{categories|}}} / no / yes
| category2 = {{{category|¬}}} / 'empty' / no / 'not defined' / ¬ / yes

| page  = {{{page|}}} / User:Example
}}
&lt;/pre>

Note that empty values to the "main" ... "other" parameters have special meaning (see examples above). The "all" parameter doesn't understand numbered parameters, since there should never be a need for that.

=== Technical details ===

The centralised category suppression blacklist is in the sub-template {{tl|category handler/blacklist}}. To see or update the blacklist, go there.

For its internal parameter processing, this template uses the sub-template {{tl|category handler/numbered}}.

For more technical details see the [[Template talk:Category handler|talk page]].

=== See also ===

* [[Wikipedia:Category suppression]] – The how-to guide.
* [[Wikipedia:WikiProject Category Suppression]] – The WikiProject.
* [[Wikipedia:Namespace]] – Lists all the namespaces.

&lt;includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox||
&lt;!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Wikipedia metatemplates]]
}}&lt;/includeonly>

&lt;includeonly>
[[as:সাঁচ:Cat handler]]
[[pt:Predefinição:Cat handler]]
&lt;/includeonly>
</textarea><div class="templatesUsed"><div class="mw-templatesUsedExplanation"></div><ul>
<li><a href="/wiki/index.php?title=Template:Category_handler" title="Template:Category handler">Template:Category handler</a> (<a href="/wiki/index.php?title=Template:Category_handler&amp;action=edit" title="Template:Category handler">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Category_handler/blacklist" title="Template:Category handler/blacklist">Template:Category handler/blacklist</a> (<a href="/wiki/index.php?title=Template:Category_handler/blacklist&amp;action=edit" title="Template:Category handler/blacklist">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Category_handler/numbered" title="Template:Category handler/numbered">Template:Category handler/numbered</a> (<a href="/wiki/index.php?title=Template:Category_handler/numbered&amp;action=edit" title="Template:Category handler/numbered">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Documentation_subpage" title="Template:Documentation subpage">Template:Documentation subpage</a> (<a href="/wiki/index.php?title=Template:Documentation_subpage&amp;action=edit" title="Template:Documentation subpage">view source</a>) </li><li><a href="/wiki/index.php?title=Template:High-risk" title="Template:High-risk">Template:High-risk</a> (<a href="/wiki/index.php?title=Template:High-risk&amp;action=edit" title="Template:High-risk">view source</a>) </li><li><a href="/wiki/index.php?title=Template:If_pagename" title="Template:If pagename">Template:If pagename</a> (<a href="/wiki/index.php?title=Template:If_pagename&amp;action=edit" title="Template:If pagename">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Namespace_detect" title="Template:Namespace detect">Template:Namespace detect</a> (<a href="/wiki/index.php?title=Template:Namespace_detect&amp;action=edit" title="Template:Namespace detect">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Ombox" title="Template:Ombox">Template:Ombox</a> (<a href="/wiki/index.php?title=Template:Ombox&amp;action=edit" title="Template:Ombox">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Ombox/core" title="Template:Ombox/core">Template:Ombox/core</a> (<a href="/wiki/index.php?title=Template:Ombox/core&amp;action=edit" title="Template:Ombox/core">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Tl" title="Template:Tl">Template:Tl</a> (<a href="/wiki/index.php?title=Template:Tl&amp;action=edit" title="Template:Tl">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Tlf" title="Template:Tlf">Template:Tlf</a> (<a href="/wiki/index.php?title=Template:Tlf&amp;action=edit" title="Template:Tlf">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Tmbox" title="Template:Tmbox">Template:Tmbox</a> (<a href="/wiki/index.php?title=Template:Tmbox&amp;action=edit" title="Template:Tmbox">view source</a>) </li><li><a href="/wiki/index.php?title=Template:Tmbox/core" title="Template:Tmbox/core">Template:Tmbox/core</a> (<a href="/wiki/index.php?title=Template:Tmbox/core&amp;action=edit" title="Template:Tmbox/core">view source</a>) </li></ul></div><p id="mw-returnto">Return to <a href="/wiki/index.php?title=Template:Category_handler/doc" title="Template:Category handler/doc">Template:Category handler/doc</a>.</p>
</div>				<!-- /bodycontent -->
								<!-- printfooter -->
				<div class="printfooter">
				Retrieved from "<a href="http://ripred.net/wiki/index.php?title=Template:Category_handler/doc">http://ripred.net/wiki/index.php?title=Template:Category_handler/doc</a>"				</div>
				<!-- /printfooter -->
												<!-- catlinks -->
				<div id='catlinks' class='catlinks catlinks-allhidden'></div>				<!-- /catlinks -->
												<div class="visualClear"></div>
				<!-- debughtml -->
								<!-- /debughtml -->
			</div>
			<!-- /bodyContent -->
		</div>
		<!-- /content -->
		<div id="mw-navigation">
			<h2>Navigation menu</h2>
			<!-- header -->
			<div id="mw-head">
				
<!-- 0 -->
<div id="p-personal" role="navigation" class="">
	<h3>Personal tools</h3>
	<ul>
<li id="pt-createaccount"><a href="/wiki/index.php?title=Special:UserLogin&amp;returnto=Template%3ACategory+handler%2Fdoc&amp;returntoquery=action%3Dedit&amp;type=signup">Create account</a></li><li id="pt-login"><a href="/wiki/index.php?title=Special:UserLogin&amp;returnto=Template%3ACategory+handler%2Fdoc&amp;returntoquery=action%3Dedit" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o">Log in</a></li>	</ul>
</div>

<!-- /0 -->
				<div id="left-navigation">
					
<!-- 0 -->
<div id="p-namespaces" role="navigation" class="vectorTabs">
	<h3>Namespaces</h3>
	<ul>
					<li  id="ca-nstab-template" class="selected"><span><a href="/wiki/index.php?title=Template:Category_handler/doc"  title="View the template [c]" accesskey="c">Template</a></span></li>
					<li  id="ca-talk" class="new"><span><a href="/wiki/index.php?title=Template_talk:Category_handler/doc&amp;action=edit&amp;redlink=1"  title="Discussion about the content page [t]" accesskey="t">Discussion</a></span></li>
			</ul>
</div>

<!-- /0 -->

<!-- 1 -->
<div id="p-variants" role="navigation" class="vectorMenu emptyPortlet">
	<h3 id="mw-vector-current-variant">
		</h3>
	<h3><span>Variants</span><a href="#"></a></h3>
	<div class="menu">
		<ul>
					</ul>
	</div>
</div>

<!-- /1 -->
				</div>
				<div id="right-navigation">
					
<!-- 0 -->
<div id="p-views" role="navigation" class="vectorTabs">
	<h3>Views</h3>
	<ul>
					<li id="ca-view"><span><a href="/wiki/index.php?title=Template:Category_handler/doc" >Read</a></span></li>
					<li id="ca-viewsource" class="selected"><span><a href="/wiki/index.php?title=Template:Category_handler/doc&amp;action=edit"  title="This page is protected.&#10;You can view its source [e]" accesskey="e">View source</a></span></li>
					<li id="ca-history" class="collapsible"><span><a href="/wiki/index.php?title=Template:Category_handler/doc&amp;action=history"  title="Past revisions of this page [h]" accesskey="h">View history</a></span></li>
			</ul>
</div>

<!-- /0 -->

<!-- 1 -->
<div id="p-cactions" role="navigation" class="vectorMenu emptyPortlet">
	<h3><span>Actions</span><a href="#"></a></h3>
	<div class="menu">
		<ul>
					</ul>
	</div>
</div>

<!-- /1 -->

<!-- 2 -->
<div id="p-search" role="search">
	<h3><label for="searchInput">Search</label></h3>
	<form action="/wiki/index.php" id="searchform">
				<div>
			
Warning: preg_match(): Compilation failed: group name must start with a non-digit at offset 8 in /hermes/walnacweb07/walnacweb07aa/b2060/moo.riprednet/wiki/includes/MagicWord.php on line 902
<input type="search" name="search" title="Search HGRPG Wiki [f]" accesskey="f" id="searchInput" />			<input type="submit" name="go" value="Go" title="Go to a page with this exact name if exists" id="searchGoButton" class="searchButton" />			<input type="submit" name="fulltext" value="Search" title="Search the pages for this text" id="mw-searchButton" class="searchButton" />					<input type='hidden' name="title" value="Special:Search"/>
		</div>
	</form>
</div>

<!-- /2 -->
				</div>
			</div>
			<!-- /header -->
			<!-- panel -->
			<div id="mw-panel">
				<!-- logo -->
					<div id="p-logo" role="banner"><a style="background-image: url(/wiki/skins/common/images/goodlogo.png);" href="/wiki/index.php?title=Main_Page"  title="Visit the main page"></a></div>
				<!-- /logo -->
				
<!-- navigation -->
<div class="portal" role="navigation" id='p-navigation'>
	<h3>Navigation</h3>
	<div class="body">
		<ul>
			<li id="n-mainpage-description"><a href="/wiki/index.php?title=Main_Page" title="Visit the main page [z]" accesskey="z">Main page</a></li>
			<li id="n-portal"><a href="/wiki/index.php?title=HGRPG_Wiki:Community_portal" title="About the project, what you can do, where to find things">Community portal</a></li>
			<li id="n-currentevents"><a href="/wiki/index.php?title=HGRPG_Wiki:Current_events" title="Find background information on current events">Current events</a></li>
			<li id="n-recentchanges"><a href="/wiki/index.php?title=Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r">Recent changes</a></li>
			<li id="n-randompage"><a href="/wiki/index.php?title=Special:Random" title="Load a random page [x]" accesskey="x">Random page</a></li>
			<li id="n-help"><a href="/wiki/index.php?title=Help:Contents" title="The place to find out">Help</a></li>
		</ul>
	</div>
</div>

<!-- /navigation -->

<!-- SEARCH -->

<!-- /SEARCH -->

<!-- TOOLBOX -->
<div class="portal" role="navigation" id='p-tb'>
	<h3>Toolbox</h3>
	<div class="body">
		<ul>
			<li id="t-whatlinkshere"><a href="/wiki/index.php?title=Special:WhatLinksHere/Template:Category_handler/doc" title="A list of all wiki pages that link here [j]" accesskey="j">What links here</a></li>
			<li id="t-recentchangeslinked"><a href="/wiki/index.php?title=Special:RecentChangesLinked/Template:Category_handler/doc" title="Recent changes in pages linked from this page [k]" accesskey="k">Related changes</a></li>
			<li id="t-specialpages"><a href="/wiki/index.php?title=Special:SpecialPages" title="A list of all special pages [q]" accesskey="q">Special pages</a></li>
			<li id="t-info"><a href="/wiki/index.php?title=Template:Category_handler/doc&amp;action=info">Page information</a></li>
		</ul>
	</div>
</div>

<!-- /TOOLBOX -->

<!-- LANGUAGES -->

<!-- /LANGUAGES -->

<!-- googleadsense -->
<div class="portal" role="navigation" id='p-googleadsense'>
	<h3>Google AdSense</h3>
	<div class="body">
		<script type="text/javascript"><!--
google_ad_client = "ca-pub-3778205741590868";
/* 5257198455 */
google_ad_slot = "9567862052";
google_ad_width = 120;
google_ad_height = 600;
// -->
</script>
<script type="text/javascript"
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
</script>	</div>
</div>

<!-- /googleadsense -->
			</div>
			<!-- /panel -->
		</div>
		<!-- footer -->
		<div id="footer" role="contentinfo">
							<ul id="footer-places">
											<li id="footer-places-privacy"><a href="/wiki/index.php?title=HGRPG_Wiki:Privacy_policy" title="HGRPG Wiki:Privacy policy">Privacy policy</a></li>
											<li id="footer-places-about"><a href="/wiki/index.php?title=HGRPG_Wiki:About" title="HGRPG Wiki:About">About HGRPG Wiki</a></li>
											<li id="footer-places-disclaimer"><a href="/wiki/index.php?title=HGRPG_Wiki:General_disclaimer" title="HGRPG Wiki:General disclaimer">Disclaimers</a></li>
									</ul>
										<ul id="footer-icons" class="noprint">
					<li id="footer-poweredbyico">
						<a href="//www.mediawiki.org/"><img src="/wiki/skins/common/images/poweredby_mediawiki_88x31.png" alt="Powered by MediaWiki" width="88" height="31" /></a>
					</li>
				</ul>
						<div style="clear:both"></div>
		</div>
		<!-- /footer -->
		<script>if(window.mw){
mw.loader.state({"site":"loading","user":"missing","user.groups":"ready"});
}</script>
<script>if(window.mw){
mw.loader.load(["mediawiki.user","mediawiki.page.ready","mediawiki.searchSuggest","mediawiki.hidpi","skins.vector.js"], null, true);
}</script>
<script src="http://ripred.net/wiki/load.php?debug=true&amp;lang=en&amp;modules=site&amp;only=scripts&amp;skin=vector&amp;*"></script>
<!-- Served in 1.280 secs. -->
	</body>
</html>