Community Central
Community Central
No edit summary
m (Changes.)
Tag: Help
(22 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
[[File:Help-Template-types-1.png|thumb|250px|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 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]]. Types also make your wiki smarter and your templates easier to manage.
   
  +
The biggest difference is what happens in the mobile experience. Classification tells the software whether to employ certain editing tools – like the Infobox Builder GUI – and it helps give an accurate census on which to base Fandom's development priorities.
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 many templates never require any work on your part. Most of the ones that need classification are new ones that you create.
   
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 ==
 
== How it works ==
 
[[File:Help-Template-types-2.png|thumb|250px|Template type shown on a template page]]
 
[[File:Help-Template-types-2.png|thumb|250px|Template type shown on a template page]]
  +
 
{{TOCright}}
 
{{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.
+
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.
 
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 17: Line 19:
   
 
=== Bulk edits ===
 
=== Bulk edits ===
[[File:Help - Template Classification bulk edit button.png|thumb|left|200px]]
 
 
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.
 
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.
   
Line 23: Line 24:
   
 
If the category contains 150+ pages in any namespace, there may be a delay between saving your changes and seeing the correct type populated.
 
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 ===
 
=== Log ===
Line 29: Line 32:
 
== 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.
 
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 ===
 
=== 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.
+
[[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. Giving an infobox the classification of "Infobox" will help the server's census to identify infoboxes correctly.
  +
  +
A template should only be classed as an infobox when its contents only and entirely create an infobox. Templates that help constitute an infobox – that is, parts of an infobox – are better classed as "non-article" templates. Conversely, if the infobox is merely a part of a template that creates a page – or a substantial part of a page – then it's actually better to use "Design".
   
 
;Examples
 
;Examples
* https://indianajones.wikia.com/wiki/Template:Infobox_Artifact
+
* https://indianajones.fandom.com/wiki/Template:Infobox_Artifact
* https://scrubs.wikia.com/wiki/Template:Character
+
* https://scrubs.fandom.com/wiki/Template:Character
* https://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.
+
Many communities use quote templates to highlight notable snippets of text such as lyrics, book passages, spoken phrases, or extracts from interviews or news articles. These templates usually contain a quote from a single source.
  +
  +
:''Quote templates strip most formatting on mobile web and enclose the text as an italicized and indented block. As such, this classification should not be used for dialogue between two parties (where "Design" is suggested).''
   
 
; Examples
 
; Examples
* https://thehungergames.wikia.com/wiki/Template:Quote
+
* https://thehungergames.fandom.com/wiki/Template:Quote
* https://gameofthrones.wikia.com/wiki/Template:Dialogue_a-b
+
* https://ben10.fandom.com/wiki/Template:Quote
* https://ben10.wikia.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.
 
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.''
:''Sometimes hidden by default on the mobile skin.''
 
   
 
;Examples
 
;Examples
* https://runescape.wikia.com/wiki/Template:Weapon
+
* https://runescape.fandom.com/wiki/Template:Weapon
* https://undertale.wikia.com/wiki/Template:Navbox_characters
+
* https://undertale.fandom.com/wiki/Template:Navbox_characters
* https://disney.wikia.com/wiki/Template:Rescue_Rangers
+
* https://disney.fandom.com/wiki/Template:Rescue_Rangers
   
 
=== Notice ===
 
=== 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.
+
Also known as message boxes, alerts, or maintenance tags, these templates notify the reader about the status of the article itself. Most notices are editing notes (like "delete this page", "update these sections", or "clean up the links") – notes that most non-editing mobile users will disregard.
   
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.
+
Notice templates often appear at the very top of an article page or section.
   
:''Hidden by default on the mobile skin.''
+
:''Hidden by default on mobile web.''
   
; Examples
+
; '''Examples:'''
* https://fallout.wikia.com/wiki/Template:Update
+
* https://fallout.fandom.com/wiki/Template:Update
* https://finalfantasy.wikia.com/wiki/Template:Stub
+
* https://finalfantasy.fandom.com/wiki/Template:Stub
* https://warframe.wikia.com/wiki/Template:Speculation
+
* https://warframe.fandom.com/wiki/Template:Speculation
  +
  +
: Notices meant for all readers should be classified as "Design"; if it links to an internal article (for example, a "spoiler warning" notice linked to the spoilers policy), Context-link may also be appropriate.
   
 
=== Context-link ===
 
=== 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.
+
These templates (often called "hatnotes") 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
 
; Examples
* https://vampirediaries.wikia.com/wiki/Template:Main
+
* https://vampirediaries.fandom.com/wiki/Template:Main
* https://mlp.wikia.com/wiki/Template:See_also
+
* https://mlp.fandom.com/wiki/Template:See_also
* https://powerlisting.wikia.com/wiki/Template:For
+
* https://powerlisting.fandom.com/wiki/Template:For
   
 
=== Infoicon ===
 
=== Infoicon ===
Line 83: Line 89:
 
Infoicons can appear inside paragraph text, inside infoboxes, or in bulleted lists.
 
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
 
; 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
 
:&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
Line 93: Line 99:
   
 
; Example Templates
 
; Example Templates
* https://fallout.wikia.com/wiki/Template:Icon
+
* https://fallout.fandom.com/wiki/Template:Icon
* https://wowwiki.wikia.com/wiki/Template:Horde_Icon_Small
+
* https://wowwiki.fandom.com/wiki/Template:Horde_Icon_Small
   
 
=== Scrollbox ===
 
=== Scrollbox ===
Line 100: Line 106:
   
 
; Examples
 
; Examples
* https://starwars.wikia.com/wiki/Template:Scrollbox
+
* https://starwars.fandom.com/wiki/Template:Scrollbox
* https://simpsons.wikia.com/wiki/Template:Scroll
+
* https://simpsons.fandom.com/wiki/Template:Scroll
* https://lotr.wikia.com/wiki/Template:Scroll
+
* https://lotr.fandom.com/wiki/Template:Scroll
   
 
=== Citation or reference ===
 
=== Citation or reference ===
Line 110: Line 116:
   
 
; Examples
 
; Examples
* https://arresteddevelopment.wikia.com/wiki/Template:Ep
+
* https://arresteddevelopment.fandom.com/wiki/Template:Ep
* https://fringe.wikia.com/wiki/Template:Crossref
+
* https://fringe.fandom.com/wiki/Template:Crossref
* https://logos.wikia.com/wiki/Template:Reflist
+
* https://logos.fandom.com/wiki/Template:Reflist
   
 
=== Image, video, or gallery ===
 
=== Image, video, or gallery ===
Line 120: Line 126:
   
 
; Examples
 
; Examples
* https://onepiece.wikia.com/wiki/Template:Gallery
+
* https://onepiece.fandom.com/wiki/Template:Gallery
* https://lostpedia.wikia.com/wiki/Template:I
+
* https://lostpedia.fandom.com/wiki/Template:I
* https://dragonage.wikia.com/wiki/Template:Icon
+
* https://dragonage.fandom.com/wiki/Template:Icon
   
 
=== Data ===
 
=== Data ===
Line 128: Line 134:
   
 
; Examples
 
; Examples
* https://yugioh.wikia.com/wiki/Template:DM_card
+
* https://yugioh.fandom.com/wiki/Template:DM_card
* https://borderlands.wikia.com/wiki/Template:Item_table_row
+
* https://borderlands.fandom.com/wiki/Template:Item_table_row
* https://wowwiki.wikia.com/wiki/Template:Battlepet_ability_row
+
* https://wowwiki.fandom.com/wiki/Template:Battlepet_ability_row
* https://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.
+
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. This is also the suggested classification for multi-person dialogue, due to quote handling on mobile devices.
   
 
; Examples
 
; Examples
* https://starwars.wikia.com/wiki/Template:Credits
+
* https://starwars.fandom.com/wiki/Template:Credits
* https://simpsons.wikia.com/wiki/Template:Tab
+
* https://simpsons.fandom.com/wiki/Template:Tab
* https://ladygaga.wikia.com/wiki/Template:Scroll_box
+
* https://ladygaga.fandom.com/wiki/Template:Scroll_box
 
* https://gameofthrones.fandom.com/wiki/Template:Dialogue_a-b
   
 
=== Navigation ===
 
=== Navigation ===
Line 145: Line 152:
   
 
The most popular types of navigation templates are navboxes and context links, which are listed above.
 
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
 
; Example
* https://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.
+
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 of what can go into this classification are documentation templates, main page modules, sub-templates, and image licensing templates.
  +
  +
"Non-article" does not mean, "This template won't appear on article pages". It means only that the template is not meant to be used directly on article pages. Template documentation pages (namely, those in /doc sub-pages) should always be "Non-article", regardless of what they're documenting.
   
 
Examples:
 
Examples:
* https://theodoretugboat.wikia.com/wiki/Template:Talk_header
+
* https://theodoretugboat.fandom.com/wiki/Template:Talk_header
* https://assassinscreed.wikia.com/wiki/Template:CC-BY-SA
+
* https://assassinscreed.fandom.com/wiki/Template:CC-BY-SA
* https://rickandmorty.wikia.com/wiki/Template:Main_Page_Character_Gallery
+
* https://rickandmorty.fandom.com/wiki/Template:Main_Page_Character_Gallery
   
 
=== Unknown ===
 
=== Unknown ===
Line 162: Line 171:
   
 
== 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]].
+
For more general background on this feature, please read [[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]].
  +
 
== Further help and feedback ==
 
== Further help and feedback ==
 
{{Help and feedback section}}
 
{{Help and feedback section}}
 
 
[[de:Hilfe:Vorlagenklassifizierung]]
 
[[de:Hilfe:Vorlagenklassifizierung]]
 
[[es:Ayuda:Clasificación de plantillas]]
 
[[es:Ayuda:Clasificación de plantillas]]
Line 178: Line 188:
 
[[pt:Ajuda:Tipos de predefinição]]
 
[[pt:Ajuda:Tipos de predefinição]]
 
[[ru:Справка:Классификация шаблонов]]
 
[[ru:Справка:Классификация шаблонов]]
  +
[[tr:Yardım:Şablon türleri]]
 
[[uk:Довідка:Класифікація шаблонів]]
 
[[uk:Довідка:Класифікація шаблонів]]
 
[[vi:Trợ giúp:Loại bản mẫu]]
 
[[vi:Trợ giúp:Loại bản mẫu]]

Revision as of 04:13, 10 February 2021

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.

The biggest difference is what happens in the mobile experience. Classification tells the software whether to employ certain editing tools – like the Infobox Builder GUI – and it helps give an accurate census on which to base Fandom's development priorities.

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.

Help - Template Classification bulk edit button

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.

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. Giving an infobox the classification of "Infobox" will help the server's census to identify infoboxes correctly.

A template should only be classed as an infobox when its contents only and entirely create an infobox. Templates that help constitute an infobox – that is, parts of an infobox – are better classed as "non-article" templates. Conversely, if the infobox is merely a part of a template that creates a page – or a substantial part of a page – then it's actually better to use "Design".

Examples

Quote

Many communities use quote templates to highlight notable snippets of text such as lyrics, book passages, spoken phrases, or extracts from interviews or news articles. These templates usually contain a quote from a single source.

Quote templates strip most formatting on mobile web and enclose the text as an italicized and indented block. As such, this classification should not be used for dialogue between two parties (where "Design" is suggested).
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 message boxes, alerts, or maintenance tags, these templates notify the reader about the status of the article itself. Most notices are editing notes (like "delete this page", "update these sections", or "clean up the links") – notes that most non-editing mobile users will disregard.

Notice templates often appear at the very top of an article page or section.

Hidden by default on mobile web.
Examples:
Notices meant for all readers should be classified as "Design"; if it links to an internal article (for example, a "spoiler warning" notice linked to the spoilers policy), Context-link may also be appropriate.

Context-link

These templates (often called "hatnotes") 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
     ↑ image is part of Infoicon template, but text is not
  • PlayStation X Button X-button
     ↑ image is part of Infoicon template, but text is not
  • Smiley
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. This is also the suggested classification for multi-person dialogue, due to quote handling on mobile devices.

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

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 of what can go into this classification are documentation templates, main page modules, sub-templates, and image licensing templates.

"Non-article" does not mean, "This template won't appear on article pages". It means only that the template is not meant to be used directly on article pages. Template documentation pages (namely, those in /doc sub-pages) should always be "Non-article", regardless of what they're documenting.

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.

See also

For more general background on this feature, please read this blog post. Since this feature mostly has to do with how templates appear on mobile, you may also want to check out this mobile-centric view.

Further help and feedback