Difference between revisions of "Template:Db-notice/doc"

From blackwiki
Jump to navigation Jump to search
imported>KDS4444
(→‎Parameters: replacing previous table with templatedata table, copying over most of the removed text)
imported>Vanisaac
m (→‎See also: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{Documentation subpage}}
 
{{Documentation subpage}}
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
−
{{speedy deletion notices}}
+
{{substituted}}{{speedy deletion notices}}
  
 
This template is a meta-template used to create speedy deletion notifications. It is typically [[WP:TRANSCLUDE|transcluded]] into another template.
 
This template is a meta-template used to create speedy deletion notifications. It is typically [[WP:TRANSCLUDE|transcluded]] into another template.
Line 11: Line 11:
 
Basic usage:
 
Basic usage:
  
−
<pre>{{<includeonly>safesubst:</includeonly>db-notice
+
<pre>{{SAFESUBST:<noinclude />db-notice
 
|namespace    = {{{namespace|}}}
 
|namespace    = {{{namespace|}}}
 
|target        = {{{1}}}
 
|target        = {{{1}}}
Line 24: Line 24:
 
All fields:
 
All fields:
  
−
<pre>{{<includeonly>safesubst:</includeonly>db-notice
+
<pre>{{SAFESUBST:<noinclude />db-notice
 
|namespace        = {{{namespace|}}}
 
|namespace        = {{{namespace|}}}
 
|target            = {{{1}}}
 
|target            = {{{1}}}
Line 46: Line 46:
 
<templatedata>
 
<templatedata>
 
{
 
{
−
"description": "This template is a meta-template used to create speedy deletion notifications. It is typically transcluded into another template.
+
"description": "This template is a meta-template used to create speedy deletion notifications. It is typically transcluded into another template.\n All of the speedy deletion notification templates that use the Wikipedia tool known as Twinkle are based on this template. Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page. The information below is intended for users who are creating their own deletion templates and as reference for those interested in modifying existing templates.",
−
 
 
−
All of the speedy deletion notification templates that use the Wikipedia tool known as Twinkle are based on this template. Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page. The information below is intended for users who are creating their own deletion templates and as reference for those interested in modifying existing templates.",
 
 
"params": {
 
"params": {
−
"first parameter": {
+
"namespace": {
−
"label": "namespace",
+
"label": "Namespace",
 
"description": "The namespace of the article proposed/ nominated for deletion. This should be passed through from the daughter template.",
 
"description": "The namespace of the article proposed/ nominated for deletion. This should be passed through from the daughter template.",
 
"required": false,
 
"required": false,
−
"suggested": false,
+
"example":"File:",
−
                        "example":"File:",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"second parameter": {
+
"target": {
−
"label": "target",
+
"label": "Target",
 
"description": "This is the name of the page targeted for deletion, given without brackets of any kind",
 
"description": "This is the name of the page targeted for deletion, given without brackets of any kind",
 
"required": true,
 
"required": true,
−
"suggested": false,
+
"example": "Ham sandwich with mustard and mayo",
−
                        "example": "Ham sandwich with mustard and mayo",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "wiki-page-name"
 
"type": "wiki-page-name"
−
},
+
},
−
"third parameter": {
+
"nowelcome": {
−
"label": "nowelcome",
+
"label": "No welcome",
 
"description": "This parameter automatically welcomes users with {{first article}} template if their user talk page was previously a red link (i.e., the deletion template is the first edit to the page). If this parameter is set to 'yes', then this welcome is omitted. This should usually be passed through from the daughter template, unless a welcome is never desired (for example for G10 'attack pages').",
 
"description": "This parameter automatically welcomes users with {{first article}} template if their user talk page was previously a red link (i.e., the deletion template is the first edit to the page). If this parameter is set to 'yes', then this welcome is omitted. This should usually be passed through from the daughter template, unless a welcome is never desired (for example for G10 'attack pages').",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
 
},
 
},
−
"fourth parameter": {
+
"header": {
−
"label": "header",
+
"label": "Header",
 
"description": "If this is set to 'no', no section heading is generated before the deletion notification. This should be passed through from the daughter template to give deletion template creators control over whether they want to include a section heading or not.  If left blank, a new section heading is generated.",
 
"description": "If this is set to 'no', no section heading is generated before the deletion notification. This should be passed through from the daughter template to give deletion template creators control over whether they want to include a section heading or not.  If left blank, a new section heading is generated.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"fifth parameter": {
+
"header-text": {
−
"label": "header-text",
+
"label": "Header text",
 
"description": "This allows users to specify custom text for the section heading before the deletion notice. This should usually be passed through from the daughter template.",
 
"description": "This allows users to specify custom text for the section heading before the deletion notice. This should usually be passed through from the daughter template.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "",
 
−
"default": "",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"sixth parameter": {
+
"nothanks": {
−
"label": "nothanks",
+
"label": "No thanks",
 
"description": "If the page the notification template is used on was previously a red link, and this parameter contains any text, then the text 'thank you for your contributions' is omitted from the welcome message. This is used when the contributions are assumed not to be useful, such as in templates for vandalism or attack pages.",
 
"description": "If the page the notification template is used on was previously a red link, and this parameter contains any text, then the text 'thank you for your contributions' is omitted from the welcome message. This is used when the contributions are assumed not to be useful, such as in templates for vandalism or attack pages.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"seventh parameter": {
+
"icon": {
−
"label": "icon",
+
"label": "Icon",
 
"description": "The filename of the image used in the top-left-hand corner of the notice.  Most deletion notices are information notices (as opposed to warning notices), so the information icon4 is usually chosen.",
 
"description": "The filename of the image used in the top-left-hand corner of the notice.  Most deletion notices are information notices (as opposed to warning notices), so the information icon4 is usually chosen.",
−
"required": false,
+
"example": "Information icon4.svg",
−
"suggested": false,
 
−
                        "example": "Information icon4.svg",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "",
 
 
"type": "wiki-page-name"
 
"type": "wiki-page-name"
−
},
+
},
−
"eighth parameter": {
+
"wizard": {
−
"label": "wizard",
+
"label": "Wizard",
 
"description": "Optionally shows a message box with advice about creating new articles.",
 
"description": "Optionally shows a message box with advice about creating new articles.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "yes",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"ninth parameter": {
+
"text": {
−
"label": "text",
+
"label": "Text",
 
"description": "The main text of the notice. This does not include the last paragraph, which is included automatically in every notice. Some aspects of the last paragraph can be changed with other parameters, however.",
 
"description": "The main text of the notice. This does not include the last paragraph, which is included automatically in every notice. Some aspects of the last paragraph can be changed with other parameters, however.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"tenth parameter": {
+
"if you think that": {
−
"label": "if you think that",
+
"label": "If you think that",
 
"description": "If this parameter exists, it will replace the text 'the page was nominated in error' with the text it contains.",
 
"description": "If this parameter exists, it will replace the text 'the page was nominated in error' with the text it contains.",
−
"required": false,
+
"default": "this page should not be deleted for this reason",
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"eleventh parameter": {
+
"button": {
−
"label": "button",
+
"label": "Button",
 
"description": "Setting this to 'no' removes the text about clicking on the button labelled 'Click here to contest this speedy deletion' in the speedy deletion tag. Useful if the related speedy deletion template doesn't have such a button.",
 
"description": "Setting this to 'no' removes the text about clicking on the button labelled 'Click here to contest this speedy deletion' in the speedy deletion tag. Useful if the related speedy deletion template doesn't have such a button.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"twelfth parameter": {
+
"willprovide": {
−
"label": "willprovide",
+
"label": "Will provide",
 
"description": "By default, the template will include the sentence, 'If the page is deleted, and you wish to retrieve the deleted material for future reference or improvement, you can place a request here.' If willprovide is equal to 'no' then this sentence will be omitted. Template:Db-copyvio-notice, for instance, is set up to not include this sentence.",
 
"description": "By default, the template will include the sentence, 'If the page is deleted, and you wish to retrieve the deleted material for future reference or improvement, you can place a request here.' If willprovide is equal to 'no' then this sentence will be omitted. Template:Db-copyvio-notice, for instance, is set up to not include this sentence.",
−
"required": false,
+
"example": "no",
−
"suggested": false,
 
−
                        "example": "no",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"thirteenth parameter": {
+
"additionally": {
−
"label": "additionally",
+
"label": "Additionally",
 
"description": "This optional text will be appended to the very end of the notice.",
 
"description": "This optional text will be appended to the very end of the notice.",
−
"required": false,
 
−
"suggested": false,
 
−
                        "example": "",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "default value",
 
 
"type": "string"
 
"type": "string"
−
},
+
},
−
"fourteenth parameter": {
+
"rfudlink": {
−
"label": "rfudlink",
+
"label": "RFUD link",
 
"description": "If this parameter exists, the text prompting the user to go to WP:RFUD won't display. Useful as an alternative to the willprovide parameter if one can contact the deleting administrator to retrieve the article but for some reason can't place a request on that page (such as when the user in question has been blocked from editing Wikipedia). Template:Db-notability-notice, for example, is set up to omit this part of the sentence.",
 
"description": "If this parameter exists, the text prompting the user to go to WP:RFUD won't display. Useful as an alternative to the willprovide parameter if one can contact the deleting administrator to retrieve the article but for some reason can't place a request on that page (such as when the user in question has been blocked from editing Wikipedia). Template:Db-notability-notice, for example, is set up to omit this part of the sentence.",
−
"required": false,
+
"example": "yes",
−
"suggested": false,
 
−
                        "example": "yes",
 
−
"deprecated": false,
 
−
"aliases": [],
 
−
"autovalue": "auto value",
 
−
"default": "[blank]",
 
 
"type": "string"
 
"type": "string"
−
}
+
}
 
}
 
}
 
}
 
}
Line 223: Line 136:
  
 
==See also==
 
==See also==
−
 
 
*{{tl|db notice doc}}
 
*{{tl|db notice doc}}
 +
*{{tl|db-deleted}}
  
−
<includeonly>
+
<includeonly>{{Sandbox other||
−
{{substituted}}
 
 
<!--
 
<!--
 
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, INSIDE INCLUDEONLY TAGS, THANK YOU. -->
 
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, INSIDE INCLUDEONLY TAGS, THANK YOU. -->
 
[[Category:CSD warning templates]]
 
[[Category:CSD warning templates]]
−
 
+
}}</includeonly>
−
</includeonly>
 

Latest revision as of 23:02, 24 April 2020

Template:SubstitutedTemplate:Speedy deletion notices

This template is a meta-template used to create speedy deletion notifications. It is typically transcluded into another template.

All of the speedy deletion notification templates that Twinkle uses are based on this template. Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page.

Usage

Basic usage:

{{SAFESUBST:<noinclude />db-notice
|namespace     = {{{namespace|}}}
|target        = {{{1}}}
|nowelcome     = {{{nowelcome|}}}
|header        = {{{header|}}}
|header-text   = {{{header-text|}}}
|text          = 
}}<!-- Template:Db-XX-notice --> <noinclude>
{{documentation}}
</noinclude>

All fields:

{{SAFESUBST:<noinclude />db-notice
|namespace         = {{{namespace|}}}
|target            = {{{1}}}
|nowelcome         = {{{nowelcome|}}}
|header            = {{{header|}}}
|header-text       = {{{header-text|}}}
|nothanks          = 
|icon              = 
|wizard            = 
|text              = 
|if you think that = 
|button            = 
|willprovide       = 
|additionally      = 
}}<!-- Template:Db-XX-notice --> <noinclude>
{{documentation}}
</noinclude>

The template should usually be used with safesubst, so that the template can be both transcluded and substituted. In most cases templates made with this meta-template will be substituted on user talk pages, but sometimes transclusion is necessary, for example when creating template documentation.

This template is a meta-template used to create speedy deletion notifications. It is typically transcluded into another template. All of the speedy deletion notification templates that use the Wikipedia tool known as Twinkle are based on this template. Twinkle will automatically add this message to a user's talk page whenever a page that user has created is nominated for Speedy Deletion. As such, users are unlikely to ever have cause to manually add this template to any page. The information below is intended for users who are creating their own deletion templates and as reference for those interested in modifying existing templates.

Template parameters

ParameterDescriptionTypeStatus
Namespacenamespace

The namespace of the article proposed/ nominated for deletion. This should be passed through from the daughter template.

Example
File:
Stringoptional
Targettarget

This is the name of the page targeted for deletion, given without brackets of any kind

Example
Ham sandwich with mustard and mayo
Pagerequired
No welcomenowelcome

This parameter automatically welcomes users with {{first article}} template if their user talk page was previously a red link (i.e., the deletion template is the first edit to the page). If this parameter is set to 'yes', then this welcome is omitted. This should usually be passed through from the daughter template, unless a welcome is never desired (for example for G10 'attack pages').

Example
yes
Stringoptional
Headerheader

If this is set to 'no', no section heading is generated before the deletion notification. This should be passed through from the daughter template to give deletion template creators control over whether they want to include a section heading or not. If left blank, a new section heading is generated.

Example
no
Stringoptional
Header textheader-text

This allows users to specify custom text for the section heading before the deletion notice. This should usually be passed through from the daughter template.

Stringoptional
No thanksnothanks

If the page the notification template is used on was previously a red link, and this parameter contains any text, then the text 'thank you for your contributions' is omitted from the welcome message. This is used when the contributions are assumed not to be useful, such as in templates for vandalism or attack pages.

Example
yes
Stringoptional
Iconicon

The filename of the image used in the top-left-hand corner of the notice. Most deletion notices are information notices (as opposed to warning notices), so the information icon4 is usually chosen.

Example
Information icon4.svg
Pageoptional
Wizardwizard

Optionally shows a message box with advice about creating new articles.

Example
yes
Stringoptional
Texttext

The main text of the notice. This does not include the last paragraph, which is included automatically in every notice. Some aspects of the last paragraph can be changed with other parameters, however.

Stringoptional
If you think thatif you think that

If this parameter exists, it will replace the text 'the page was nominated in error' with the text it contains.

Default
this page should not be deleted for this reason
Stringoptional
Buttonbutton

Setting this to 'no' removes the text about clicking on the button labelled 'Click here to contest this speedy deletion' in the speedy deletion tag. Useful if the related speedy deletion template doesn't have such a button.

Example
no
Stringoptional
Will providewillprovide

By default, the template will include the sentence, 'If the page is deleted, and you wish to retrieve the deleted material for future reference or improvement, you can place a request here.' If willprovide is equal to 'no' then this sentence will be omitted. Template:Db-copyvio-notice, for instance, is set up to not include this sentence.

Example
no
Stringoptional
Additionallyadditionally

This optional text will be appended to the very end of the notice.

Stringoptional
RFUD linkrfudlink

If this parameter exists, the text prompting the user to go to WP:RFUD won't display. Useful as an alternative to the willprovide parameter if one can contact the deleting administrator to retrieve the article but for some reason can't place a request on that page (such as when the user in question has been blocked from editing Wikipedia). Template:Db-notability-notice, for example, is set up to omit this part of the sentence.

Example
yes
Stringoptional

See also