Template:Pp/doc: Difference between revisions
(Created page with "{{Documentation subpage}} {{lua|Module:Protection banner}} This is a general template for producing '''p'''rotection banners and '''p'''adlock icons. It can be used with any protection reason, any protection action, and any protection level. == Usage == {{pp | 1 = ''reason'' | small = ''yes'' | action = ''action'' | date = ''protection date'' | user = ''username'' | section = ''talk page section name'' | category = ''no'' }} ==...") |
mNo edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{Documentation subpage}} | {{Documentation subpage}} | ||
{{lua|Module:Protection banner}} | {{lua|Module:Protection banner}} | ||
__NOTOC__ | |||
This is a general template for producing '''p'''rotection banners and '''p'''adlock icons. It can be used with any protection reason, any protection action, and any protection level. | This is a general template for producing '''p'''rotection banners and '''p'''adlock icons. It can be used with any protection reason, any protection action, and any protection level. | ||
== Usage == | == Usage == | ||
{{Pre| | |||
| 1 = | {{{{fcb|#4169e1|pp}} | ||
| small = | | {{fcb|#2e8b57|1}} = {{font color|#933|reason}} | ||
| action = | | {{fcb|#2e8b57|small}} = {{font color|#933|yes}} | ||
| date = | | {{fcb|#2e8b57|action}} = {{font color|#933|action}} | ||
| user = | | {{fcb|#2e8b57|date}} = {{font color|#933|protection date}} | ||
| section = | | {{fcb|#2e8b57|user}} = {{font color|#933|username}} | ||
| category = | | {{fcb|#2e8b57|section}} = {{font color|#933|talk page section name}} | ||
| {{fcb|#2e8b57|category}} = {{font color|#933|no}} | |||
}} }} | |||
== Parameters == | == Parameters == | ||
Line 46: | Line 48: | ||
== Visibility == | == Visibility == | ||
This template will hide itself (not display a padlock icon) if it is used on a page that is not currently protected. [[User:Penguinplushie]] may also automatically remove the template wikicode from pages that are not currently protected. | This template will hide itself (not display a padlock icon) if it is used on a page that is not currently protected. [[User:Penguinplushie]] may also automatically remove the template wikicode from pages that are not currently protected. | ||
== TemplateData == | |||
<templatedata> | |||
{ | |||
"description": "Produces banners to describe why a page is protected and padlock icons", | |||
"params": { | |||
"1": { | |||
"label": "Reason", | |||
"description": "Reason for protection, may be one of: blp, dispute, dmca, mainpage, office, reset, sock, template, usertalk, vandalism", | |||
"example": "blp", | |||
"type": "string", | |||
"suggested": true | |||
}, | |||
"small": { | |||
"description": "Specifies whether the small format is used. If set to \"yes\", \"y\", \"1\", or \"true\", a padlock icon is generated instead of a full protection banner.", | |||
"example": "yes", | |||
"type": "boolean", | |||
"default": "no", | |||
"suggested": true | |||
}, | |||
"action": { | |||
"description": "Protection action. Must be one of \"edit\" (for normal protection), \"move\" (for move-protection) or \"autoreview\" (for pending changes). The default value is \"edit\".", | |||
"example": "edit", | |||
"type": "string", | |||
"default": "edit" | |||
}, | |||
"date": { | |||
"description": "Protection date. This must be valid input to the second parameter of the #time parser function. This argument only has an effect for the \"office\" and \"reset\" reasons.", | |||
"type": "date" | |||
}, | |||
"user": { | |||
"description": "Username of the user to generate links for. This only has an effect when the \"usertalk\" reason is specified.", | |||
"type": "wiki-user-name" | |||
}, | |||
"section": { | |||
"description": "Section name of the protected page's talk page where discussion is taking place. This works for most, but not all, values of reason.", | |||
"type": "string" | |||
}, | |||
"category": { | |||
"description": "Categories are suppressed if this is set to \"no\", \"n\", \"0\", or \"false\".", | |||
"type": "boolean" | |||
} | |||
} | |||
} | |||
</templatedata> | |||
<includeonly>{{sandbox other||{{testcases other|| | <includeonly>{{sandbox other||{{testcases other|| | ||
<!-- Categories below this line, please --> | <!-- Categories below this line, please --> | ||
[[Category:Protection templates]] | |||
[[Category:Protection | |||
}}}}</includeonly> | }}}}</includeonly> |
Latest revision as of 01:19, 20 August 2023
It contains usage information, categories and other content that is not part of the original template page.
|
This template uses Lua: |
This is a general template for producing protection banners and padlock icons. It can be used with any protection reason, any protection action, and any protection level.
Usage
{{pp | 1 = reason | small = yes | action = action | date = protection date | user = username | section = talk page section name | category = no }}
Parameters
All parameters are optional:
|1=
– The reason that the page was protected. If set, this must be one of the values listed in the reasons table.|small=
– If set to "yes", "y", "1", or "true", a padlock icon is generated instead of a full protection banner.|action=
– The protection action. Must be one of "edit" (for normal protection), "move" (for move-protection) or "autoreview" (for pending changes). The default value is "edit".|date=
– The protection date. This must be valid input to the second parameter of the #time parser function. This argument only has an effect for the "office" and "reset" reasons.|user=
– The username of the user to generate links for. As of July 2014, this only has an effect when the "usertalk" reason is specified.|section=
– The section name of the protected page's talk page where discussion is taking place. This works for most, but not all, values of reason.|category=
– Categories are suppressed if this is set to "no", "n", "0", or "false".
Reasons
The following table contains the available reasons, plus the actions for which they are available. Reasons are used to customize the banner text, to place articles in more specific hidden categories such as Category:Pages semi-protected against vandalism, and sometimes to change the icon of the banner (e.g. office actions).
Reason | Action | Description |
---|---|---|
template | edit | For all templates and Lua modules |
vandalism | edit | For pages protected against vandalism |
vandalism | move | For pages protected against vandalism |
Syntax examples
Padlock icons
Padlock icon for a page protected due to vandalism:
{{pp|vandalism|small=yes}}
Padlock icon for a page temporarily protected due to editing disputes:
{{pp|dispute|small=yes}}
Banners
Banner for a page temporarily move-protected due to page-move vandalism:
{{pp|vandalism|action=move}}
Visibility
This template will hide itself (not display a padlock icon) if it is used on a page that is not currently protected. User:Penguinplushie may also automatically remove the template wikicode from pages that are not currently protected.
TemplateData
Produces banners to describe why a page is protected and padlock icons
Parameter | Description | Type | Status | |
---|---|---|---|---|
Reason | 1 | Reason for protection, may be one of: blp, dispute, dmca, mainpage, office, reset, sock, template, usertalk, vandalism
| String | suggested |
small | small | Specifies whether the small format is used. If set to "yes", "y", "1", or "true", a padlock icon is generated instead of a full protection banner.
| Boolean | suggested |
action | action | Protection action. Must be one of "edit" (for normal protection), "move" (for move-protection) or "autoreview" (for pending changes). The default value is "edit".
| String | optional |
date | date | Protection date. This must be valid input to the second parameter of the #time parser function. This argument only has an effect for the "office" and "reset" reasons. | Date | optional |
user | user | Username of the user to generate links for. This only has an effect when the "usertalk" reason is specified. | User | optional |
section | section | Section name of the protected page's talk page where discussion is taking place. This works for most, but not all, values of reason. | String | optional |
category | category | Categories are suppressed if this is set to "no", "n", "0", or "false". | Boolean | optional |