Editing Template:Pp-meta/doc (section)

===="Usually" required parameters====
;<code>type</code>:The '''type''' parameter applies most default settings for the broad classes of protection templates. It can have values equal to any of the following: <code>full</code>, <code>semi</code>, <code>pc1</code>, <code>pc2</code>, <code>indef</code>, <code>move</code>, <code>create</code>, and <code>office</code> (all case-insensitive). These values apply default boilerplate text, images, and links. This parameter should almost always be used, as the default settings require little other input, making the code of templates such as <span style="font-family:monospace;"><nowiki>{{</nowiki>[[Template:Pp-protected|pp-protected]]<nowiki>}}</nowiki></span> very clean. Note that not supplying this parameter causes the image to default to [[:Image:Transparent.gif]].
;<code>small</code>: The '''small''' parameter lets the template decide whether to display a small icon version or a large boilerplate version. It can take any value, but the only one which will be acted on is "<code>yes</code>" (case-insensitive). As instance templates should be able to decide, using their input, whether or not to apply <code>small</code>, this should usually be set to <code><nowiki>{{{small|}}}</nowiki></code>, which defaults to non-small but allows small to be specified. Not supplying this parameter will cause the template to always be expanded big.
;<code>right</code>: The '''right''' parameter sets the horizontal location of the small version of the template. The default value is 55px. Templates should pass this through, changing the default value if necessary.
;<code>expiry</code>: This '''expiry''' parameter allows, when <code>type</code> is defined normally, the expiry date to be automatically displayed properly for both the tooltip of the small version and in text for the large version. It should typically take the input <code><nowiki>{{{expiry|}}}</nowiki></code>, which allows instances using this template to be provided input specifying the expiry date. It should be left blank for templates where <code>type</code> is set to <code>indef</code>, as it has no effect because indefinite protection templates clearly do not need expiry dates to be specified.
;<code>dispute</code>:The '''dispute''' parameter adds some boilerplate text disclaiming against endorsement of the protected version or title. It is not dependent on the <code>type</code> parameter, but the <code>explanation-text</code> parameter described below overrides it when applicable.
;<code>reason</code>:The '''reason''' parameter allows a particular reason to be applied to the template to explain why the page is protected. The code used in this parameter should be prefixed with <code>&amp;#32;</code> so that there are proper spaces between words as <code><nowiki>{{{reason|}}}</nowiki></code> in the code is not prefixed with a space, such that the requisite full stop is not prefixed by a space when <code>reason</code> is null. Instances which want to pass through the reason should use code along the general lines of <code><nowiki>{{{reason|a default reason}}}</nowiki></code>.
;<code>categories</code>: The '''categories''' parameter is relatively strict in the input form instances of this template should use: if the template has categories that it should apply to pages upon which it is placed, they should be implemented within the container of <code><nowiki>{{{categories|</nowiki></code> and <code><nowiki>}}}</nowiki></code>, which will cause categories to be disabled in the instances if they are given <code>|categories=no</code> as an argument. If the template applies no categories, there is no use for this parameter.
;<code>demospace</code>: Although the '''demospace''' parameter is primarily useful for testing purposes, its name betrays its purpose: demonstration. Instances should generally use the code <code>demospace=<nowiki>{{{demospace|}}}</nowiki></code> so as to allow them to be forced to display as though they were in a particular namespace. If a template is to be always used in a particular namespace and never in another, it is also possible to set <code>demospace</code> to any of <code>main</code>, <code>talk</code>, or <code>other</code> (all case-insensitive) to specify the messagebox type typical for that namespace or namespace family such that it will never change from that type.
;<code>demolevel</code>: The '''demolevel''' parameter, like the <code>demospace</code> parameter, is useful for demonstration and testing. Instances should generally use the code <code>demospace=<nowiki>{{{demolevel|undefined}}}</nowiki></code> so as to allow them to be forced to display as though they were on a page with a particular level of protection. This must have the default of "undefined" if it is used, as a null value will cause the template to fail. Failing the demolevel test causes the template to disappear and the page to be placed into [[:Category:Wikipedia pages with incorrect protection templates]].