This is an old revision of this page, as edited by Jonesey95 (talk | contribs) at 18:39, 1 October 2024 (Add __EXPECTUNUSEDTEMPLATE__ to exclude historical template pages from Special:UnusedTemplates (see Tech News: 2024-36)). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.
Revision as of 18:39, 1 October 2024 by Jonesey95 (talk | contribs) (Add __EXPECTUNUSEDTEMPLATE__ to exclude historical template pages from Special:UnusedTemplates (see Tech News: 2024-36))(diff) ← Previous revision | Latest revision (diff) | Newer revision → (diff) | Template:Deprecated template is deprecated. Please use ] instead. |
Template documentation[view] [edit] [history] [purge]
Shortcuts- {{Tdeprecated}}
- {{TemplateObsolete}}
- {{Deprecated}}
The {{Deprecated template}} template notifies users that a given template has been superseded or replaced by another template, or has simply been deprecated (i.e., advised to no longer be used) without a direct replacement. It is useful when a redirect is ineffective due to usage differences, or when reducing the number of redirects is desired to simplify bot parsing.
If the template is fully deprecated, the deprecated template’s content should be fully replaced/overridden by the message from {{Deprecated template}}, ensuring that anyone using the template will only see the notification, and not invoke the deprecated template.
Usage
Templates not fully deprecated
If the deprecated template is not yet ready for full deprecation since it is still in use (transcluded) on pages, add <noinclude>...</noinclude> tags around the {{Deprecated template}} template in the source code of the deprecated template. This ensures that the deprecation notice appears only on the template’s documentation page and not on every page where the template is transcluded.
Fully deprecated templates
Once a template has been fully deprecated and is no longer transcluded on any pages, you can remove the <noinclude>...</noinclude> tags surrounding the {{Deprecated template}} in the deprecated template’s source code. This will display the deprecation notice on any pages still using the deprecated template.
Afterward, consider nominating the template for deletion through Misplaced Pages:Templates for discussion or marking it with {{Historical template}} to indicate its deprecated status.
{{Deprecated template|old template name|new template name}}
Usage without a second (replacement) template name simply produces:
| Template:Deprecated template is deprecated. |
Parameters
- Standard
{{Deprecated template|Old|New}}
| Template:Old is deprecated. Please use Template:New instead. |
- Additional
The template can show parameters as follows:
{{Deprecated template|Old|New|parameter}}
{{Deprecated template|Old|New|<nowiki>parameter=foo</nowiki>}}
| Template:Old is deprecated. Please use {{New|parameter}} instead. |
| Template:Old is deprecated. Please use {{New|parameter=foo}} instead. |
The template can also show a note:
{{Deprecated template|Old|New|note=Further details can be inserted here}}
| Template:Old is deprecated. Please use Template:New instead. Further details can be inserted here, such as why the template is retained, or the particulars of the replacement process |
The |note= parameter can also be given as |reason= or |result=.
- Special parameters for templates outside template namespace.
|old= and |new= can be used with the full names including namespace.
{{Deprecated template|old=Template:Old|new=Misplaced Pages:New}}
| Template:Old is deprecated. Please see Misplaced Pages:New instead. |
To link to a category full of templates, use :Category:Name of category here, with a leading colon.
The |new= parameter cannot be used with the third unnamed parameter (the one illustrating a parameter of the third template). For example, this is not valid:
{{Deprecated template|Old|new=User:SnorkelWeasel/MyTemplate|<nowiki>chickens=yes</nowiki>}}
Such a feature could be added, but it has never been needed yet.
- Category suppression
The template can be prevented from categorizing by adding |nocat=true. This is only intended for examples, e.g. in the template's own documentation. In that case, not only the page itself will not be categorized, but transclusions of such pages will also be prevented from categorizing in Category:Pages using deprecated templates. Do not use this parameter to passive-aggressively contest a template's documentation. Take up the matter on the template's talk page or that of a relevant other venue, such as WP:Village pump (technical).
See also
- {{Deprecated stub}} – for deprecated stub templates
- {{Historical template}} - for deprecated templates that are kept for historical reasons
- Category:Deprecated templates – the category where this template lists templates it is used on
- {{Xtd}} (and related templates) – for indicating deprecated (and good, bad and neutral) examples in guidelines, how-tos and template documentation
- {{Dc}} – inline
deprecated code or text; {{Dc2}} variant hasstrikethrough(both explicitly use the<del>element, and can be used in articles, e.g. about HTML or other specifications that may have deprecated features) - {{Superseded}} – for Misplaced Pages pages
- {{Obsolete}} – for media files
- {{Deleted template}} – for deleting a template without breaking old revisions
TemplateData
This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Deprecated template in articles based on its TemplateData.TemplateData for Deprecated template
Notifies users that a given template has been superseded or replaced by another template, or has simply been deprecated (i.e., advised to no longer be used) without a direct replacement.
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Deprecated template name | old 1 | Name of the template to be replaced
| Line | suggested |
| Replacement | new 2 | The page name of a template which supersedes the deprecated template. It is unnecessary to use namespace prefix, but it may be used, even for other namespaces. To link to a category full of templates, use :Category:Name of category here, with a leading colon. | Line | suggested |
| Parameter | 3 | The template can show parameters for the new template, must use <nowiki></nowiki> tags
| Content | suggested |
| Note | note reason result | Explanation of why the template is deprecated, documentation on how it should be replaced, or any other helpful information. | Content | suggested |
| Deprecated by | by | Who/what deprecated the template? | Line | suggested |
| Kept for historical reasons? | historical | Any value will output: "and is preserved only for historical reasons"
| Boolean | optional |
| Suppress categorisation | nocat | The template can be prevented from categorizing by adding |nocat=true. This is only intended for examples, e.g. in the template's own documentation. In that case, not only the page itself will not be categorized, but transclusions of such pages will also be prevented from categorizing in Category:Pages using deprecated templates. Do not use this parameter to passive-aggressively contest a template's documentation. Take up the matter on the template's talk page or that of a relevant other venue, such as WP:Village pump (technical).
| Boolean | optional |
Editors can experiment in this template's sandbox (edit | diff) and testcases (edit) pages.
Add categories to the /doc subpage. Subpages of this template. Categories: