Changes: Help:Template types

Revision as of 23:40, 26 July 2020

Help-Template-types-1 — Template type choices

Template classification is the act of assigning your templates a type that then determines how that template will appear on mobile web.

Types also make your wiki smarter and your templates easier to manage. They enhance Insights and group your templates automatically on Special:Templates.

Classifying a template is easy, and many templates never require any work on your part. Most of the ones that need classification are new ones that you create.

How it works

Help-Template-types-2 — Template type shown on a template page

A template's current type is shown just under the page title on a template page. This type can be changed by logged-in users who have edit permissions on that template.

Updates can be made via the template page and via the right rail of the editor when you're editing the template. Clicking the listed type or the pencil icon next to it will open a dialog that lets you select the template type.

Additionally, a dialog will ask you for the template type when creating a new template or when publishing an edit to a template page which has no type set.

Any automated classifications - those detected by the "machine" systems - are overridden by your classification choices.

Bulk edits

Admins can bulk edit template types via category pages. If a category contains one or more templates, an option to 'Bulk edit template type' will appear under the 'Edit' button dropdown.

When a bulk edit is saved, all previously set types will be overwritten.

If the category contains 150+ pages in any namespace, there may be a delay between saving your changes and seeing the correct type populated.

Log

Changes made to a template's classification can be seen on Special:Log and be filtered under the 'Template type' option.

Template types

The current template types are listed below. There are some overlaps between the types, so we recommend you choose the type that is most specific to each template.

Note: These may be updated in the future based on your feedback - feel free to send in your thoughts to Special:Contact/feedback.

Infobox

Infoboxes display the most essential information about an article in a box at the top of the page. These usually float to the right side of the page but sometimes they span the entire width of the page.

Examples

Quote

Many communities use quote templates to highlight notable snippets of text such as lyrics, book passages, spoken dialog, or extracts from interviews or news articles. These templates often contain either a quote from one source or dialog between multiple people.

Examples

Navbox

Navbox templates display a list of organized links in a box for readers to navigate to related articles, usually at the bottom of the page.

Elements that use the navbox class are hidden by default on mobile web, unless the immediate parent element has the article-table class.

Examples

Notice

Also known as hatnotes or alerts, these templates notify the reader about the status of the article itself, such as if it is a stub, if there is an associated disambiguation page, or if the article contains spoilers.

Notice templates often appear at the very top of an article page but also appear in certain sections or at the bottom of the page.

Hidden by default on mobile web.

Examples:

Context-link

These templates suggest another page that is related to the current page or section. The two most frequent uses of this type are "Main article" or "See also" and display as italicized text. These are used at the top of an article page or at the top of a section within an article page.

On mobile web, this type is an indented block element, offset by significant vertical space.
Examples

Infoicon

These templates are used for creating a link or text with a small icon. These are very popular on gaming communities to represent currency, items, or controller symbols. The icons are sometimes linked to other pages.

Infoicons can appear inside paragraph text, inside infoboxes, or in bulleted lists.

On mobile web, these templates render only the icon, with no corresponding text nor any other content beyond the image.

Visual Examples

Horde

↑ image is part of Infoicon template, but text is not

X-button

↑ image is part of Infoicon template, but text is not

Example Templates

Scrollbox

These templates display their contents in a scrollable box. Scrollboxes are used to conserve space on article pages for very long lists.

Examples

Citation or reference

These templates organize and standardize the display how sources of content on an article page are annotated. These can be either used to place a single reference in an article or to build a references list at the bottom of the article page.

These templates can optionally use <ref> tags or build in-line citations.

Examples

Image, video, or gallery

The purpose of any template in the image, video, or gallery type is to standardize or modify the display of one or more images or videos on an article page.

These are often used to build a gallery or to format how an image thumbnail displays.

Examples

Data

Any templates that do not fall into the types above but add information or data to an article page should be classified as data. This includes (but is certainly not limited to) templates that are used to build tables, templates that are used to generate math equations, or pieces of data (e.g. price of an item, release version of a game, etc.) that are inserted on multiple pages.

Examples

Design

If a template's sole purpose is to modify how an article page (or a piece of an article page) looks, it should be classified as design. Common uses include adding tabs, modifying the visual display of text or tables, or relocating the table of contents.

Examples

Navigation

If a template's sole purpose is to help readers or other editors find another article page or category it should be classified as navigation. Example uses include page-top icons, recommended links to other websites, categorizers, or succession boxes.

The most popular types of navigation templates are navboxes and context links, which are listed above.

Navigation templates that contain <div>, <table>, or <p> elements are hidden by default on mobile web.

Example

https://scrubs.fandom.com/wiki/Template:Music_floater

Non-article

Assign this type if a template is not used on any article (content) pages. For example, if the template is only used on talk pages, template pages, file pages, user pages, or only on your community's main page.

Examples:

Unknown

The 'default' type, when no other template type has been chosen.

Template types and categories

The template types feature is separate from template categories. Since the usage of such categories vary hugely across Fandom, template classification and categories do not affect each other. You can continue to use template categories exactly as the same as before.

Further help and feedback

Browse and search other help pages at Help:Contents
Check Fandom Community Central for sources of further help and support
Check Contacting Fandom for how to report any errors or unclear steps in this article

@@ Line 1: / Line 1: @@
-[[File:Help-Template-types-1.png|thumb|300px|Template type choices]]
+[[File:Help-Template-types-1.png|thumb|250px|Template type choices]]
+'''Template classification''' is the act of '''assigning your [[help:templates|templates]] a type''' that then determines how that template will appear on [[help:mobile web|mobile web]].
-'''Template types''' involves classifying each template with a type, such as "infobox," "navbox," or "quote."
-Adding types to your templates is going to make your FANDOM community smarter and your templates easier to manage! Information about template types is going to enhance [[Help:Insights|Insights]] and group your templates automatically on [[Special:Templates]]. Additionally, this information will help FANDOM display your articles in the best possible way on our mobile skin by emphasizing some types (quotes, context links, infoboxes) and de-emphasizing others that don't work so well (navboxes, for example).
+Types also make your wiki smarter and your templates easier to manage. They enhance [[Help:Insights|Insights]] and group your templates automatically on [[Special:Templates]].
-Classifying a template is easy, and we have also worked on automatic (or "machine") type detection that will likely cover a lot of cases - so classification should not require much work from you. You will need to help out our machines a bit, though, they're not as smart as you are.
-'''For more background on this feature, please read [[homepage:w:User_blog:DaNASCAT/Template_Types:_A_Smarter_Categorization_System|DaNASCAT's Template Types blog post]]!'''
+Classifying a template is easy, and many templates never require any work on your part. Most of the ones that need classification are new ones that you create.
 == How it works ==
 [[File:Help-Template-types-2.png|thumb|250px|Template type shown on a template page]]
-[[File:Help-Template-types-3.png|thumb|250px|Classic editor template type option]]
+{{TOCright}}
-A template's current type is shown just under the page title on a template page. This type can be changed by logged in users who have edit permissions on that template. This requires the [[Help:Preferences#Appearance|default FANDOM layout]]<!-- or <code>?useskin=wikia</code> -->.
+A template's current type is shown just under the page title on a template page. This type can be changed by logged-in users who have edit permissions on that template.
 Updates can be made via the template page and via the right rail of the editor when you're editing the template. Clicking the listed type or the pencil icon next to it will open a dialog that lets you select the template type.
@@ Line 19: / Line 16: @@
 Any automated classifications - those detected by the "machine" systems - are overridden by your classification choices.
 === Bulk edits ===
+Admins can bulk edit template types via category pages. If a category contains one or more templates, an option to 'Bulk edit template type' will appear under the 'Edit' button dropdown.
-[[File:Help_-_Template_Classification_bulk_edit_button.png|thumb|250px]]
+When a bulk edit is saved, all previously set types will be overwritten.
-Admins can bulk edit template types via category pages. If a category contains one or more templates, an option to 'Bulk edit template type' will appear under the 'Edit' button dropdown.
-When a bulk edit is saved, all previously set types will be overwritten.
 If the category contains 150+ pages in any namespace, there may be a delay between saving your changes and seeing the correct type populated.
+[[File:Help - Template Classification bulk edit button.png|200px]]
 === Log ===
 Changes made to a template's classification can be seen on [[Special:Log]] and be filtered under the 'Template type' option.
-==Template types==
+== Template types ==
 The current template types are listed below. There are some overlaps between the types, so we recommend you choose the type that is most specific to each template.
-Note: these may be updated in the future based on your feedback - feel free to send in your thoughts to [[Special:Contact/feedback]].
+Note: These may be updated in the future based on your feedback - feel free to send in your thoughts to [[Special:Contact/feedback]].
-===Infobox===
+=== Infobox ===
 [[Help:Infoboxes|Infoboxes]] display the most essential information about an article in a box at the top of the page. These usually float to the right side of the page but sometimes they span the entire width of the page.
 ;Examples
-* http://indianajones.wikia.com/wiki/Template:Infobox_Artifact
+* https://indianajones.fandom.com/wiki/Template:Infobox_Artifact
-* http://scrubs.wikia.com/wiki/Template:Character
+* https://scrubs.fandom.com/wiki/Template:Character
-* http://dragonball.wikia.com/wiki/Template:Volume_Infobox
+* https://dragonball.fandom.com/wiki/Template:Volume_Infobox
+=== Quote ===
-===Quote===
 Many communities use quote templates to highlight notable snippets of text such as lyrics, book passages, spoken dialog, or extracts from interviews or news articles. These templates often contain either a quote from one source or dialog between multiple people.
 ; Examples
-* http://thehungergames.wikia.com/wiki/Template:Quote
+* https://thehungergames.fandom.com/wiki/Template:Quote
-* http://gameofthrones.wikia.com/wiki/Template:Dialogue_a-b
+* https://gameofthrones.fandom.com/wiki/Template:Dialogue_a-b
-* http://ben10.wikia.com/wiki/Template:Quote
+* https://ben10.fandom.com/wiki/Template:Quote
-===Navbox===
+=== Navbox ===
 Navbox templates display a list of organized links in a box for readers to navigate to related articles, usually at the bottom of the page.
+:''Elements that use the <code>navbox</code> class are hidden by default on mobile web, unless the immediate parent element has the <code>article-table</code> class.''
-:''Hidden by default on the mobile skin.''
 ;Examples
-* http://runescape.wikia.com/wiki/Template:Weapon
+* https://runescape.fandom.com/wiki/Template:Weapon
-* http://undertale.wikia.com/wiki/Template:Navbox_characters
+* https://undertale.fandom.com/wiki/Template:Navbox_characters
-* http://disney.wikia.com/wiki/Template:Rescue_Rangers
+* https://disney.fandom.com/wiki/Template:Rescue_Rangers
+=== Notice ===
+Also known as [https://en.wiktionary.org/wiki/hatnote hatnotes] or alerts, these templates notify the reader about the status of the article itself, such as if it is a stub, if there is an associated disambiguation page, or if the article contains spoilers.
-===Notice===
-Also known as hatnotes or alerts, these templates notify the reader about the status of the article itself, such as if it is a stub, if there is an associated disambiguation page, or if the article contains spoilers.
 Notice templates often appear at the very top of an article page but also appear in certain sections or at the bottom of the page.
-:''Hidden by default on the mobile skin.''
+:''Hidden by default on mobile web.''
-; Examples
+; '''Examples:'''
-* http://fallout.wikia.com/wiki/Template:Update
+* https://fallout.fandom.com/wiki/Template:Update
-* http://finalfantasy.wikia.com/wiki/Template:Stub
+* https://finalfantasy.fandom.com/wiki/Template:Stub
-* http://warframe.wikia.com/wiki/Template:Speculation
+* https://warframe.fandom.com/wiki/Template:Speculation
-===Context-link===
-These templates suggest another page that is related to the current page or section. The two most frequent uses of this type are “Main article” or “See also” and display as italicized text. These are used at the top of an article page or at the top of a section within an article page.
+=== Context-link ===
+These templates suggest another page that is related to the current page or section. The two most frequent uses of this type are "Main article" or "See also" and display as italicized text. These are used at the top of an article page or at the top of a section within an article page.
+:''On mobile web, this type is an indented block element, offset by significant vertical space.''
 ; Examples
-* http://vampirediaries.wikia.com/wiki/Template:Main
+* https://vampirediaries.fandom.com/wiki/Template:Main
-* http://mlp.wikia.com/wiki/Template:See_also
+* https://mlp.fandom.com/wiki/Template:See_also
-* http://powerlisting.wikia.com/wiki/Template:For
+* https://powerlisting.fandom.com/wiki/Template:For
-===Infoicon===
+=== Infoicon ===
 These templates are used for creating a link or text with a small icon. These are very popular on gaming communities to represent currency, items, or controller symbols. The icons are sometimes linked to other pages.
 Infoicons can appear inside paragraph text, inside infoboxes, or in bulleted lists.
-:''In the mobile skin, these templates render only the icon, with no corresponding text nor any other content beyond the image.''
+:''On mobile web, these templates render only the icon, with no corresponding text nor any other content beyond the image.''
 ; Visual Examples
-* [[File:Horde_icon.png|20px]] [[w:wow:Horde|Horde]]
+* [[File:Horde icon.png|20px]] [[w:c:wow:Horde|Horde]]
 :&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&uarr; image is part of Infoicon template, but text is not
-* [[File:PlayStation_X_Button.png|20px]] X-button
+* [[File:PlayStation X Button.png|20px]] X-button
 :&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&uarr; image is part of Infoicon template, but text is not
 * [[File:Smiley.gif|20px]]
 ; Example Templates
-* http://fallout.wikia.com/wiki/Template:Icon
+* https://fallout.fandom.com/wiki/Template:Icon
-* http://wowwiki.wikia.com/wiki/Template:Horde_Icon_Small
+* https://wowwiki.fandom.com/wiki/Template:Horde_Icon_Small
-===Scrollbox===
+=== Scrollbox ===
 These templates display their contents in a scrollable box. Scrollboxes are used to conserve space on article pages for very long lists.
 ; Examples
-* http://starwars.wikia.com/wiki/Template:Scrollbox
+* https://starwars.fandom.com/wiki/Template:Scrollbox
-* http://simpsons.wikia.com/wiki/Template:Scroll
+* https://simpsons.fandom.com/wiki/Template:Scroll
-* http://lotr.wikia.com/wiki/Template:Scroll
+* https://lotr.fandom.com/wiki/Template:Scroll
+=== Citation or reference ===
-===Citation or reference===
 These templates organize and standardize the display how sources of content on an article page are annotated. These can be either used to place a single reference in an article or to build a references list at the bottom of the article page.
@@ Line 123: / Line 112: @@
 ; Examples
-* http://arresteddevelopment.wikia.com/wiki/Template:Ep
+* https://arresteddevelopment.fandom.com/wiki/Template:Ep
-* http://fringe.wikia.com/wiki/Template:Crossref
+* https://fringe.fandom.com/wiki/Template:Crossref
-* http://logos.wikia.com/wiki/Template:Reflist
+* https://logos.fandom.com/wiki/Template:Reflist
-===Image, video, or gallery===
+=== Image, video, or gallery ===
 The purpose of any template in the '''image, video, or gallery''' type is to standardize or modify the display of one or more images or videos on an article page.
@@ Line 134: / Line 122: @@
 ; Examples
-* http://onepiece.wikia.com/wiki/Template:Gallery
+* https://onepiece.fandom.com/wiki/Template:Gallery
-* http://lostpedia.wikia.com/wiki/Template:I
+* https://lostpedia.fandom.com/wiki/Template:I
-* http://dragonage.wikia.com/wiki/Template:Icon
+* https://dragonage.fandom.com/wiki/Template:Icon
+=== Data ===
-===Data===
 Any templates that do not fall into the types above but add information or data to an article page should be classified as '''data'''. This includes (but is certainly not limited to) templates that are used to build tables, templates that are used to generate math equations, or pieces of data (e.g. price of an item, release version of a game, etc.) that are inserted on multiple pages.
 ; Examples
-* http://yugioh.wikia.com/wiki/Template:DM_card
+* https://yugioh.fandom.com/wiki/Template:DM_card
-* http://borderlands.wikia.com/wiki/Template:Item_table_row
+* https://borderlands.fandom.com/wiki/Template:Item_table_row
-* http://wowwiki.wikia.com/wiki/Template:Battlepet_ability_row
+* https://wowwiki.fandom.com/wiki/Template:Battlepet_ability_row
-* http://arresteddevelopment.wikia.com/wiki/Template:Season_3_Episodes
+* https://arresteddevelopment.fandom.com/wiki/Template:Season_3_Episodes
+=== Design ===
-===Design ===
 If a template's sole purpose is to modify how an article page (or a piece of an article page) looks, it should be classified as '''design.''' Common uses include adding tabs, modifying the visual display of text or tables, or relocating the table of contents.
 ; Examples
-* http://starwars.wikia.com/wiki/Template:Credits
+* https://starwars.fandom.com/wiki/Template:Credits
-* http://simpsons.wikia.com/wiki/Template:Tab
+* https://simpsons.fandom.com/wiki/Template:Tab
-* http://ladygaga.wikia.com/wiki/Template:Scroll_box
+* https://ladygaga.fandom.com/wiki/Template:Scroll_box
-===Navigation===
+=== Navigation ===
-If a template’s sole purpose is to help readers or other editors find another article page or category it should be classified as '''navigation.''' Example uses include page-top icons, recommended links to other websites, categorizers, or succession boxes.
+If a template's sole purpose is to help readers or other editors find another article page or category it should be classified as '''navigation.''' Example uses include page-top icons, recommended links to other websites, categorizers, or succession boxes.
 The most popular types of navigation templates are navboxes and context links, which are listed above.
+:''Navigation templates that contain <nowiki><div></nowiki>, <nowiki><table></nowiki>, or <nowiki><p></nowiki> elements are hidden by default on mobile web.''
-:''Hidden by default on the mobile skin.''
 ; Example
-* http://scrubs.wikia.com/wiki/Template:Music_floater
+* https://scrubs.fandom.com/wiki/Template:Music_floater
+=== Non-article ===
-===Non-article===
 Assign this type if a template is not used on any article (content) pages. For example, if the template is only used on talk pages, template pages, file pages, user pages, or only on your community's main page.
 Examples:
-* http://theodoretugboat.wikia.com/wiki/Template:Talk_header
+* https://theodoretugboat.fandom.com/wiki/Template:Talk_header
-* http://assassinscreed.wikia.com/wiki/Template:CC-BY-SA
+* https://assassinscreed.fandom.com/wiki/Template:CC-BY-SA
-* http://rickandmorty.wikia.com/wiki/Template:Main_Page_Character_Gallery
+* https://rickandmorty.fandom.com/wiki/Template:Main_Page_Character_Gallery
+=== Unknown ===
-===Unknown===
 The 'default' type, when no other template type has been chosen.
-== Template Types and Categories ==
+== Template types and categories ==
-The Template Types feature is separate from [[Help:Category|template categories]]. Since the usage of such categories vary hugely across FANDOM, template classification and categories do not affect each other. You can continue to use template categories exactly as the same as before.
+The template types feature is separate from [[Help:Category|template categories]]. Since the usage of such categories vary hugely across Fandom, template classification and categories do not affect each other. You can continue to use template categories exactly as the same as before.
-==See also==
+== See also ==
+For more general background on this feature, please read [[homepage:w:User blog:DaNASCAT/Template Types: A Smarter Categorization System|this blog post]]. Since this feature mostly has to do with how templates appear on mobile, you may also want to check out [[w:c:p:Understanding template classification|this mobile-centric view]].
-* [[Help:Templates]]
-* [[w:c:p:Understanding_template_classification|Understanding template classification]] provides additional detail on how template types affect display.
-==Further help and feedback==
+== Further help and feedback ==
 {{Help and feedback section}}
 [[de:Hilfe:Vorlagenklassifizierung]]
 [[es:Ayuda:Clasificación de plantillas]]
@@ Line 201: / Line 181: @@
 [[pt:Ajuda:Tipos de predefinição]]
 [[ru:Справка:Классификация шаблонов]]
+[[tr:Yardım:Şablon türleri]]
+[[uk:Довідка:Класифікація шаблонів]]
 [[vi:Trợ giúp:Loại bản mẫu]]
 [[zh:Help:模板類型]]