View source for Template:WPBannerMeta/doc

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{intricate template}}
{{high-use|all-pages=yes}}
{{Template display|nomobile}}
{{Uses TemplateStyles|Template:WPBannerMeta/styles.css|Module:Message box/tmbox.css}}

'''WPBannerMeta''' is a meta-template, which can be used to create [[:Category:WikiProject banner templates|WikiProject banners]], enabling new projects to easily create a banner to place on article [[WP:TALK|talk pages]], ensuring standardisation between projects.  A list of all WikiProject banners using this meta-template can be found at [//en.wikipedia.org/w/index.php?title=Special:WhatLinksHere/Template:WPBannerMeta&namespace=10&hidelinks=1&hideredirs=1&limit=250 What links here: WPBannerMeta]

This is a [[Wikipedia:Meta|meta]] template.  It is used to build other templates.  Do not transclude this template directly on to talk pages when you want to tag a page.  Instead, use the template provided by the WikiProject.

==Syntax==
WPBannerMeta can be used at varying levels of complexity, from the very simple to the extremely complicated. Simple options are listed here first, with complexity increasing down the page.

WPBannerMeta takes two different types of parameters: formatting and display. The formatting parameters customise the meta-template for a particular project, defining link targets, categories, images, and text. All formatting parameters use UPPERCASE and underscores (_), instead of spaces (e.g. <code><nowiki>|PROJECT=</nowiki></code> and <code><nowiki>|NOTE_1_CAT= </nowiki></code>). Display parameters customise the template output for each individual ''article'' that the banner is displayed on. These are the parameters which are entered on the talk page (<code><nowiki>|class=</nowiki></code>, <code><nowiki>|importance=</nowiki></code>, etc.) and they must be 'passed through' the project banner to the meta-template underneath. To 'pass' the parameter <code>foo</code>, you need to include the code {{nowrap|<code><nowiki>foo={{{foo|}}}</nowiki></code>}}.

===Parameters===
{| style="float:left;clear:both;background:transparent; width=100%"
|
{| class="wikitable"
!Common parameters
|-
|<syntaxhighlight lang="xml" style="font-size:100%; width=100%">
{{WPBannerMeta
|PROJECT           = 
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|DOC               = auto
|IMAGE_LEFT        = 
 |IMAGE_LEFT_SIZE  = 
 <!--|class={{{class|}}}-->
 <!--|auto={{{auto|}}}-->
 <!--|importance={{{importance|}}}-->
|ASSESSMENT_CAT    = 
|ASSESSMENT_LINK   = 
|MAIN_TEXT         = 
|MAIN_ARTICLE      = 
|PORTAL            = 
|MAIN_CAT          = 
<!--|attention={{{attention|}}}-->
 |ATTENTION_CAT    = 
<!--|infobox={{{needs-infobox|}}}-->
 |INFOBOX_CAT      = 
}}
</syntaxhighlight>
|}
|-
|
{| class="wikitable mw-collapsible mw-collapsed" style="background:transparent; width=100%;"
|-
!Full parameters
|-
|<syntaxhighlight lang="xml" style="font-size:100%; width=100%;">
{{WPBannerMeta
|PROJECT             = 
 |BANNER_NAME        = {{subst:FULLPAGENAME}}
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|PROJECT_LINK        = 
|DOC                 = 
|IMAGE_LEFT          = 
 |IMAGE_LEFT_SIZE    = 
|IMAGE_RIGHT         = 
 |IMAGE_RIGHT_SIZE   = 
|QUALITY_SCALE       = 
 <!--|class={{{class|}}}-->
 <!--|auto={{{auto|}}}-->
  |AUTO_ASSESS_CAT   = 
 |b1={{{**PARAMETER**|{{{b1|}}}}}}
 |b2={{{**PARAMETER**|{{{b2|}}}}}}
 |b3={{{**PARAMETER**|{{{b3|}}}}}}
 |b4={{{**PARAMETER**|{{{b4|}}}}}}
 |b5={{{**PARAMETER**|{{{b5|}}}}}}
 |b6={{{**PARAMETER**|{{{b6|}}}}}}
|IMPORTANCE_SCALE    = 
 <!--|importance={{{importance|}}}-->
|ASSESSMENT_CAT      = 
|ASSESSMENT_LINK     = 
|MAIN_TEXT           = 
|MAIN_ARTICLE        = 
|PORTAL              = 
|MAIN_CAT            = 
<!--|attention={{{**PARAMETER**|}}}-->
 |ATTENTION_CAT      = 
<!--|infobox={{{**PARAMETER**|}}}-->
 |INFOBOX_CAT        = 
|note 1={{{**PARAMETER**|}}}
 |NOTE_1_TEXT        = 
 |NOTE_1_IMAGE       = 
 |NOTE_1_CAT         = 
|note 2={{{**PARAMETER**|}}}
 |NOTE_2_TEXT        = 
 |NOTE_2_IMAGE       = 
 |NOTE_2_CAT         = 
|note 3={{{**PARAMETER**|}}}
 |NOTE_3_TEXT        = 
 |NOTE_3_IMAGE       = 
 |NOTE_3_CAT         = 
|note 4={{{**PARAMETER**|}}}
 |NOTE_4_TEXT        = 
 |NOTE_4_IMAGE       = 
 |NOTE_4_CAT         = 
|note 5={{{**PARAMETER**|}}}
 |NOTE_5_TEXT        = 
 |NOTE_5_IMAGE       = 
 |NOTE_5_CAT         = 
|NOTE_SIZE           = 
|COLLAPSED           = 
|COLLAPSED_HEAD      = 
|BOTTOM_TEXT         =
|tf 1={{{**PARAMETER**|}}}
 |TF_1_LINK          = 
 |TF_1_NAME          = 
 |TF_1_NESTED        = 
 |TF_1_IMAGE         = 
 |TF_1_TEXT          = 
 |TF_1_QUALITY       = 
 |tf 1 importance={{{**PARAMETER**|}}}
 |TF_1_ASSESSMENT_CAT= 
 |TF_1_MAIN_CAT      = 
|tf 2={{{**PARAMETER**|}}}
 |TF_2_LINK          = 
 |TF_2_NAME          = 
 |TF_2_NESTED        = 
 |TF_2_IMAGE         = 
 |TF_2_TEXT          = 
 |TF_2_QUALITY       = 
 |tf 2 importance={{{**PARAMETER**|}}}
 |TF_2_ASSESSMENT_CAT= 
 |TF_2_MAIN_CAT      = 
|tf 3={{{**PARAMETER**|}}}
 |TF_3_LINK          = 
 |TF_3_NAME          = 
 |TF_3_NESTED        = 
 |TF_3_IMAGE         = 
 |TF_3_TEXT          = 
 |TF_3_QUALITY       = 
 |tf 3 importance={{{**PARAMETER**|}}}
 |TF_3_ASSESSMENT_CAT= 
 |TF_3_MAIN_CAT      = 
|tf 4={{{**PARAMETER**|}}}
 |TF_4_LINK          = 
 |TF_4_NAME          = 
 |TF_4_NESTED        = 
 |TF_4_IMAGE         = 
 |TF_4_TEXT          = 
 |TF_4_QUALITY       = 
 |tf 4 importance={{{**PARAMETER**|}}}
 |TF_4_ASSESSMENT_CAT= 
 |TF_4_MAIN_CAT      = 
|tf 5={{{**PARAMETER**|}}}
 |TF_5_LINK          = 
 |TF_5_NAME          = 
 |TF_5_NESTED        = 
 |TF_5_IMAGE         = 
 |TF_5_TEXT          = 
 |TF_5_QUALITY       = 
 |tf 5 importance={{{**PARAMETER**|}}}
 |TF_5_ASSESSMENT_CAT= 
 |TF_5_MAIN_CAT      = 
|TF_SIZE             = 
|HOOK_NESTED         = 
|HOOK_ASSESS         = 
|HOOK_TF             = 
|HOOK_NOTE           = 
|HOOK_BOTTOM         = 
|HOOK_COLLAPSED      = 
|HOOK_IMPORTANCE     = 
}}
</syntaxhighlight>
|}
|}
{{clear}}
In the examples below, a WikiProject banner will be constructed for the (currently) nonexistent [[Wikipedia:WikiProject Tulips|WikiProject Tulips]].

===Simple options===
*<code>'''PROJECT'''</code> ''(Required)''&nbsp;– the name of the project without the word "WikiProject", used in a variety of contexts; first letter should usually be capitalised. {{nowrap|''Eg: <code>'''Tulips'''</code>''}}
**<code>'''<code><nowiki>BANNER_NAME={{subst:FULLPAGENAME}}</nowiki></code>'''</code> &ndash; it is assumed that page name of the banner template is '''<code>"Template:WikiProject <PROJECT>"</code>'''. If this is not the case then define the page name in this parameter. {{nowrap|''Eg: '''<code><nowiki>Template:Tulips project</nowiki></code>'''''}}
**<code>'''PROJECT_LINK'''</code> &ndash; it is assumed that the project is located at '''<code>"Wikipedia:WikiProject &lt;PROJECT>"</code>'''. If this is not the case, then define the full link to the project page in this parameter. {{nowrap|''Eg: '''<code>Wikipedia:WikiProject Tulips</code>'''''}}
**<code>'''PROJECT_NAME'''</code> &ndash; if your project is not called '''<code>"WikiProject &lt;PROJECT>"</code>''' then define the exact name of the project with this parameter.
*<code>'''DOC'''</code> &ndash; if {{para|DOC|auto}} is set then automatically generated documentation will be added to the template page. Other options are:
**{{para|DOC|custom}} &ndash; this will transclude the /doc page to allow custom (not automatic) documentation to be displayed. This can be used instead of the customary <syntaxhighlight lang="xml" inline><noinclude>{{Documentation}}</noinclude></syntaxhighlight> at the bottom of the template.
**{{para|DOC|auto+custom}} &ndash; this will include the automatic documentation and additionally transclude the /doc page. This allows extra instructions and categories to be included.
**{{para|DOC|none}} &ndash; (or left blank) will not include any documentation.
*<code>'''substcheck'''</code> &ndash; this allows the template to detect if it has been substituted instead of transcluded and give an error message. '''''<syntaxhighlight lang="xml" inline>substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly></syntaxhighlight>'''''
*<code>'''category'''</code> ''(Required)'' &ndash; the 'category' parameter ''must'' be passed through the template to enable category optout. ''E.g.: '''<code><nowiki>category={{{category|}}}</nowiki></code>'''''.
*<code>'''listas'''</code> ''(Required)'' &ndash; the 'listas' parameter ''must'' be passed through the template. {{nowrap|''Eg: '''<code><nowiki>listas={{{listas|}}}</nowiki></code>'''''}}
*<code>'''IMAGE_LEFT'''</code> &ndash; the location of an image to use in the top-left corner of the banner. '''''Do not''''' include the "''File:''" prefix. Images used on WikiProject banners '''''must''''' be free images&nbsp;– [[WP:FU|fair use]] images are '''''not''''' permitted. {{nowrap|''Eg: '''<code>[[:File:Tulipa suaveolens floriade to Canberra.jpg|Tulipa suaveolens floriade to Canberra.jpg]]</code>'''''}}
**<code>'''IMAGE_LEFT_SIZE'''</code> &ndash; the size of <code>IMAGE_LEFT</code>. Default is 80px. {{nowrap|''Eg: '''<code><nowiki>50px</nowiki></code>'''''}}
*<code>'''IMAGE_RIGHT'''</code> &ndash; the location of an image to use in the top-right corner of the banner. '''''Do not''''' include the "''File:''" prefix. Images used on WikiProject banners '''''must''''' be free images&nbsp;– [[WP:FU|fair use]] images are '''''not''''' permitted. {{nowrap|''Eg: '''<code>[[:File:Tulipa suaveolens floriade to Canberra.jpg|Tulipa suaveolens floriade to Canberra.jpg]]</code>'''''}}
**<code>'''IMAGE_RIGHT_SIZE'''</code> &ndash; the size of <code>IMAGE_RIGHT</code>. Default is 80px. {{nowrap|''Eg: '''<code><nowiki>50px</nowiki></code>'''''}}
*<code>'''MAIN_TEXT'''</code> &ndash; the default text is "''This article is within the scope of '''<nowiki>[[WikiProject {{{PROJECT_LINK}}}]]</nowiki>''', a collaborative effort to improve the coverage of '''<nowiki>{{{PROJECT or MAIN_ARTICLE}}}</nowiki>''' articles on Wikipedia. If you would like to participate, please visit the project page, where you can join the '''<nowiki>[[Talk:{{{PROJECT_LINK}}}]]</nowiki>''' discussion and see a list of open tasks.''" If defined, the alternate message will be displayed.
**<code>'''MAIN_ARTICLE'''</code> &ndash; the default article is <code>PROJECT</code>; alternatively, the linked article can be changed to either a raw article title or more complicated text. {{nowrap|''Eg: (default) '''<code><nowiki>tulips</nowiki></code>''' &rarr; '''"...the coverage of [[tulip]]s on Wikipedia..."'''''}} or (alternate) '''<code><nowiki>[[tulip]]s, [[liliaceae]] and related articles</nowiki></code>''' &rarr; '''"...the coverage of [[tulip]]s, [[liliaceae]] and related articles on Wikipedia..."'''
*<code>'''PORTAL'''</code> &ndash; if the WikiProject maintains a [[WP:Portal|portal]], define this parameter with the portal name. The associated image is held centrally at [[Module:Portal/images]]. {{nowrap|''Eg: '''<code><nowiki>Tulips</nowiki></code>'''''}}
*<code>'''MAIN_CAT'''</code> &ndash; the default is ''no'' main category created; if defined, all pages displaying the template will be sorted into [[:Category:MAIN_CAT|Category:<code>MAIN_CAT</code>]]. {{nowrap|''Eg: '''<code><nowiki>WikiProject Tulips articles</nowiki></code>''' → [[:Category:WikiProject Tulips articles]]''}}
*<code>'''BOTTOM_TEXT'''</code> &ndash; if defined, contains text that will appear across the bottom of the banner and above the [[#Collapsed|collapsed section]] (if one is present). Please '''''do not''''' use this parameter to '[[hooking|hook]]' extra code to the bottom of the template &ndash; see the [[#Hooks|''hooks'']] section below for a better solution.
{{-}}

'''Example:'''
{|style="background:none" width="50%"
|<syntaxhighlight lang="xml" style="font-size:100%">
{{WPBannerMeta
|PROJECT          = Tulips
 |BANNER_NAME     = Template:WikiProject Tulips
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|PROJECT_LINK     = Wikipedia:Somewhere about tulips
|IMAGE_LEFT       = Tulipa suaveolens floriade to Canberra.jpg
|IMAGE_LEFT_SIZE = 50px
|MAIN_ARTICLE     = [[tulip]]s, [[liliaceae]] and related articles
}}</syntaxhighlight>
|}
:Produces:
{{WPBannerMeta
|PROJECT          = Tulips
 |BANNER_NAME     = Template:WikiProject Tulips
|PROJECT_LINK     = Wikipedia:Somewhere about tulips
|IMAGE_LEFT       = Tulipa suaveolens floriade to Canberra.jpg
|IMAGE_LEFT_SIZE = 50px
|MAIN_ARTICLE     = [[tulip]]s, [[liliaceae]] and related articles
|category=no
}}

===Assessment===
Many projects use the [[Wikipedia:Content assessment|Version 1.0 Assessment]] schema to grade their articles by quality and the corresponding [[Wikipedia:Version_1.0_Editorial_Team/Release_Version_Criteria#Importance_of_topic|importance scale]] to place their articles in order of priority. In order to implement [[WP:1.0]], which uses a bot to automatically compile its statistics tables, you will need to follow the instructions at {{nowrap|[[Wikipedia:Version 1.0 Editorial Team/Using the bot|/Using the bot]]}}, as well as those outlined here.
*<code>'''class'''</code> ''(Required)''&ndash; the class parameter must be passed through, if the quality scale is used. {{nowrap|''Eg: '''<code><nowiki>class={{{class|}}}</nowiki></code>'''''}}
**<code>'''QUALITY_SCALE'''</code> &ndash; configures the quality scale; possible options are:
***standard &ndash; enables the 'standard' quality scale ([[WP:FA|FA]], [[WP:ACLASS|A]], [[WP:GA|GA]], [[WP:BCLASS|B]], C, Start, [[WP:STUB|Stub]], [[WP:FL|FL]], List, NA). (This is the default behaviour, if the ''class'' parameter is used.)
***extended &ndash; enables the 'standard' quality scale plus some additional values (Category, Disambig, Draft, File, Portal, Project and Template).
***inline &ndash; allows for a simple custom quality scale to be used, generally used with {{tl|Class mask}}.
***subpage &ndash; allows for a more complex custom quality scale to be used using a subpage called ''/class''. See [[#Custom masks|custom masks]] below for further details.
**{{anchor|auto}}<code>'''auto'''</code> the auto parameter must be passed through, if the auto assess option is needed. {{nowrap|''Eg: '''<code><nowiki>auto={{{auto|}}}</nowiki></code>'''''}} Projects which use [[WP:BOT|bots]] to automatically categorise articles can have the bot add the following parameter to the project banner, which triggers the display of a small notice that the article was tagged by a bot rather than a human:
**:<code><nowiki>|auto=stub</nowiki></code>, for an article which includes a stub template, to indicate that it has automatically been rated Stub-class;
**:<code><nowiki>|auto=inherit</nowiki></code>, to show that the class has automatically been inherited from other WikiProject's assessments on the same page;
**:<code><nowiki>|auto=length</nowiki></code>, to show that the class has automatically been deduced from the length of the article.
***<code>'''AUTO_ASSESS_CAT'''</code>&nbsp;– if defined, all articles with the {{para|auto}} parameter will be categorised into [[:Category:AUTO_ASSESS_CAT|Category:<code>AUTO_ASSESS_CAT</code>]]. By default, they are categorised into [[:Category:Automatically assessed PROJECT articles|Category:Automatically assessed <code>PROJECT</code> articles]]. {{nowrap|''Eg: '''<code><nowiki>Automatically assessed Tulip and Daffodil articles</nowiki></code>''' → [[:Category:Automatically assessed Tulip and Daffodil articles]]''}}
**<code>'''b1'''</code>, <code>'''b2'''</code>, <code>'''b3'''</code>, <code>'''b4'''</code>, <code>'''b5'''</code>, <code>'''b6'''</code> &ndash; the six B-class criteria parameters should only be passed through if the [[Template:WPBannerMeta/hooks/bchecklist|B-class checklist hook]] is used.
*<code>'''importance'''</code>&ndash; if defined, enables the standard importance scale (Top, High, Mid, Low, NA, Unknown). {{nowrap|''Eg: '''<code><nowiki>importance={{{importance|}}}</nowiki></code>'''''}}
**<code>'''IMPORTANCE_SCALE'''</code> &ndash; configures the importance scale, if used. The possible options are:
***standard &ndash; enables the 'standard' importance scale (Top, High, Mid, Low, NA and Unknown). (This is the default behaviour.)
***inline &ndash; allows for a simple custom importance scale to be defined, generally with {{tl|Importance mask}}.
***subpage &ndash; allows for a more complex custom importance scale to be used using a subpage called ''/importance''.
*<code>'''ASSESSMENT_LINK'''</code> &ndash; the link to a WikiProject-specific quality (and/or importance) scale. If there is a page at '''<code>"Wikipedia:WikiProject &lt;PROJECTLINK>/Assessment"</code>''' then this will be used by default. To override this, you can set this parameter to '''no'''. For more details, see [[Template:WPBannerMeta/Assessment link|here]].
*<code>'''ASSESSMENT_CAT'''</code> &ndash; articles are sorted into categories based on their quality; so [[WP:FA|"Featured Articles"]] on Tulips would be categorised by default into [[:Category:FA-Class Tulips articles]]. To change the default, define this parameter so that featured articles are instead categorised into [[:Category:FA-Class ASSESSMENT_CAT|Category:FA-Class {{code|ASSESSMENT_CAT}}]]. {{nowrap|''Eg: '''<code><nowiki>|ASSESSMENT_CAT=Liliaceae articles</nowiki></code>''' → [[:Category:FA-Class Liliaceae articles]]''}}

'''Example:'''
{|style="background:none" width="50%"
|<syntaxhighlight lang="xml" style="font-size:100%">
{{WPBannerMeta
|PROJECT             = Tulips
 |BANNER_NAME        = Template:WikiProject Tulips
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|IMAGE_LEFT          = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE       = extended
 |class={{{class|}}}
 |auto={{{auto|}}}
 |importance={{{importance|}}}
|ASSESSMENT_LINK     = Wikipedia:WikiProject Tulips/Article grading
}}</syntaxhighlight>
|}
:Produces:
{{WPBannerMeta
|PROJECT          = Tulips
 |BANNER_NAME     = Template:WikiProject Tulips
 |category=no
 |listas={{{listas|}}}
|IMAGE_LEFT       = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE    = extended
 |class  = GA
 |importance = Top
|ASSESSMENT_LINK  = Wikipedia:WikiProject Tulips/Article grading
}}

===Alerts and notes===
Built into WPBannerMeta is the ability to display a number of other fields that contain useful information about the article. There are also three predefined fields for:
# articles which have been [[WP:AUTOASSESS|automatically assessed]] by a bot (see [[#auto|above]]);
# articles in need of immediate attention;
# articles in need of an [[Wikipedia:Manual of Style/Infoboxes|infobox]].
The parameters are:
*<code>'''attention'''</code> &ndash; pass this parameter through to enable the use of the attention note. {{nowrap|''Eg: '''<code><nowiki>attention={{{attention|}}}</nowiki></code>'''''}}, then by including <code><nowiki>|attention=yes</nowiki></code> on the talk page.
**<code>'''ATTENTION_CAT'''</code> &ndash; if defined, all articles displaying the attention note will be categorised into [[:Category:ATTENTION_CAT|Category:<code>ATTENTION_CAT</code>]]. By default, they are categorised into [[:Category:PROJECT articles needing attention|Category:<code>PROJECT</code> articles needing attention]]. {{nowrap|''Eg: '''<code><nowiki>Floridiae taskforce articles needing attention</nowiki></code>''' → [[:Category:Floridiae taskforce articles needing attention]]''}}. A value of <code>none</code> results in no categorisation.
*<code>'''infobox'''</code> &ndash; pass this parameter through to enable the use of the needs-infobox note. {{nowrap|''Eg: '''<code><nowiki>infobox={{{needs-infobox|}}}</nowiki></code>'''''}}, then by including <code><nowiki>|needs-infobox=yes</nowiki></code> on the talk page.
**<code>'''INFOBOX_CAT'''</code> &ndash; if defined, all articles displaying the needs-infobox note will be categorised into [[:Category:INFOBOX_CAT|Category:<code>INFOBOX_CAT</code>]]. By default, they are categorised into [[:Category:PROJECT articles needing infoboxes|Category:<code>PROJECT</code> articles needing infoboxes]]. {{nowrap|''Eg: '''<code><nowiki>Floridiae taskforce articles needing infoboxes</nowiki></code>''' → [[:Category:Floridiae taskforce articles needing infoboxes]]''}}. A value of <code>none</code> results in no categorisation.
*<code>'''note 1'''</code>&ndash; pass this parameter through to trigger any defined note. {{nowrap|''Eg: '''<code><nowiki>note 1={{{needs-photo|}}}</nowiki></code>'''''}}, then by including <code><nowiki>|needs-photo=yes</nowiki></code> on the talk page. Up to five notes can be specified in the core banner.
**<code>'''NOTE_1_TEXT'''</code> &ndash; the text of note 1. ''E.g.: This page has been marked as needing a [[photograph]]''. If this is left blank there is no visual output.
**<code>'''NOTE_1_IMAGE'''</code> &ndash; an image can be defined for each note. Remember that all images '''''must''''' be free, not fair-use.  {{nowrap|''Eg: '''<code><nowiki>Gnome-dev-camera.svg</nowiki></code>'''''}}
**<code>'''NOTE_1_CAT'''</code> &ndash; if defined, all articles displaying note 1 will be categorised into [[:Category:NOTE_1_CAT|Category:<code>NOTE_1_CAT</code>]]. {{nowrap|''Eg: '''<code><nowiki>Wikipedia requested photographs of Floridiae</nowiki></code>''' → [[:Category:Wikipedia requested photographs of Floridiae]]''}}
*<code id=Collapsed>'''COLLAPSED'''</code> &ndash; when more than a threshold number of notes and alerts are triggered on a page, they are automagically collapsed into a show/hide box.  The threshold number can be customised by setting this parameter to the maximum number of notes on a page that will ''not'' trigger the collapse.  The default is 3, so if three notes are triggered on a page, they will not be collapsed, but if a fourth is also triggered, the collapse box appears.  So setting {{para|COLLAPSED|0}} will ''always'' create a collapse box (if there are any notes to fill it), while {{para|COLLAPSED|999}} will never trigger a collapse box. See also the [[Template:WPBannerMeta/hooks/notecounter|/notecounter hook]]. {{nowrap|''Eg: '''<code><nowiki>6</nowiki></code>'''''}}
**<code>'''COLLAPSED_HEAD'''</code> &ndash; the heading for the collapsed section; the default is ''More information:'' {{nowrap|''Eg: '''<code><nowiki>Additional information:</nowiki></code>'''''}}
*<code>'''NOTE_SIZE'''</code> &ndash; the size of the image used for the icons. (It is recommended to precede the size with "x" as this specifies the height of the image instead of the width, which results in a neater banner because all rows have equal height.) The default is a height of 25px. {{nowrap|''Eg: '''<code><nowiki>x30px</nowiki></code>'''''}}

'''Example:'''
{|style="background:none" width="50%"
|<syntaxhighlight lang="xml" style="font-size:100%">
{{WPBannerMeta
|PROJECT            = Tulips
 |BANNER_NAME       = Template:WikiProject Tulips
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|IMAGE_LEFT         = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE      = extended
 |class={{{class|}}}
|ASSESSMENT_LINK    = Wikipedia:WikiProject Tulips/Article grading
|auto={{{auto|}}}
 |AUTO_ASSESS_CAT   =
|attention={{{attention|}}}
 |ATTENTION_CAT     = 
|infobox={{{needs-infobox|}}}
 |INFOBOX_CAT       = 
|note 1={{{needs-photo|}}}
 |NOTE_1_TEXT       = This page has been marked as needing a [[photograph]].
 |NOTE_1_IMAGE      = Gnome-dev-camera.svg
 |NOTE_1_CAT        = Wikipedia requested photographs of Floridiae
|note 2 = {{{audio-file|}}}
 |NOTE_2_TEXT       = An [[audio file format|audio file]] has been created of this article.
 |NOTE_2_IMAGE      = Nuvola apps arts.svg
 |NOTE_2_CAT        = Tulips articles with audio files
}}</syntaxhighlight>
|}
:Produces:
{{WPBannerMeta
|PROJECT             = Tulips
 |BANNER_NAME        = Template:WikiProject Tulips
 |category=no
 |listas = {{{listas|}}}
|IMAGE_LEFT          = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE       = extended
 |class  = stub
|ASSESSMENT_LINK     = Wikipedia:WikiProject Tulips/Article grading
|auto=stub
 |AUTO_ASSESS_CAT   =
|attention=yes
 |ATTENTION_CAT      = 
|infobox=yes
 |INFOBOX_CAT        = 
|note 1=yes
 |NOTE_1_TEXT        = This page has been marked as needing a [[photograph]].
 |NOTE_1_IMAGE       = Gnome-dev-camera.svg
|note 2 = yes
 |NOTE_2_TEXT        = An [[audio file format|audio file]] has been created of this article.
 |NOTE_2_IMAGE       = Nuvola apps arts.svg
}}

===Task forces===
WPBannerMeta can accommodate up to five [[Wikipedia:WikiProject Council/Guide/Task forces|task forces]], each with its own image, links and importance scale, if desired. (More than five task forces can be supported through the use of [[Template:WPBannerMeta/hooks|hooks]].) The following parameters are available:
*<code>'''tf 1'''</code> &ndash; this parameter ''must'' be passed through to enable and trigger the display of the task force section. {{nowrap|''Eg: '''<code><nowiki>tf 1={{{floridiae|}}}</nowiki></code>'''''}}
**<code>'''TF_1_LINK'''</code> &ndash; the full page name of the task force's project page. {{nowrap|''Eg: '''<code><nowiki>Wikipedia:WikiProject Tulips/Task forces/Floridiae</nowiki></code>'''''}}
**<code>'''TF_1_NAME'''</code> &ndash; the name of the task force. This is used as the label for the task force link (unless {{para|TF_1_TEXT}} is used instead). {{nowrap|''Eg: '''<code><nowiki>the Floridiae task force</nowiki></code>'''''}}
**<code>'''TF_1_NESTED'''</code> &ndash; if defined, a link of the form "'''/ <nowiki>[[{{{TF_1_LINK}}}|{{{TF_1_NESTED}}}]]</nowiki>'''" is added after the main project's name when the banner is collapsed inside a {{tl|WikiProject banner shell}}. {{nowrap|''Eg: '''<code><nowiki>Floridiae</nowiki></code>'''''}}
**<code>'''TF_1_TEXT'''</code> &ndash; if defined, replaces the default "This page is supported by..." text. ''E.g.:&nbsp;'''<code><nowiki>This page is within the scope of the [[Wikipedia:WikiProject Tulips/Task forces/Floridiae|Floridiae task force]]. New members are always welcome!</nowiki></code>''''' If defined to be "none", then no output will be displayed, although appropriate categories will still be added.
**<code>'''TF_1_IMAGE'''</code> &ndash; an image can be defined for each task force. Remember that all images '''''must''''' be free, not fair-use. {{nowrap|''Eg: '''<code><nowiki>Tulipa florenskyi 4.jpg</nowiki></code>'''''}}
**<code>'''TF_1_QUALITY'''</code> &ndash; if defined, enables the quality categorisations for the main project (e.g.: [[:Category:FA-Class Tulips articles]]) to be duplicated for the task force. The class arising from {{para|class}} and {{para|QUALITY_SCALE}} will be used; {{nowrap|''Eg: '''<code><nowiki>yes</nowiki></code>'''''}}
**<code>'''tf 1 importance'''</code>&ndash; if defined, enables the use of a separate importance (or priority, if used) scale for the task force.{{nowrap|''Eg: '''<code><nowiki>tf 1 importance={{{floridiae-importance|}}}</nowiki></code>'''''}}
**<code>'''TF_1_ASSESSMENT_CAT'''</code> ''(Required if quality or importance assessments are used)'' &ndash; the assessment category to be used for the task force-specific quality and importance assessments. Identical in syntax to {{para|ASSESSMENT_CAT}}. {{nowrap|''Eg: '''<code><nowiki>Floridiae articles</nowiki></code>''' → [[:Category:FA-Class Floridiae articles]]''}}
**<code>'''TF_1_MAIN_CAT'''</code> &ndash; if defined, all pages displaying "tf 1" will be categorised into [[:Category:TF_1_MAIN_CAT|Category:<code>TF_1_MAIN_CAT</code>]]. {{nowrap|''Eg: '''<code><nowiki>Floridiae articles</nowiki></code>''' → [[:Category:Floridiae articles]]''}}
*<code>'''TF_SIZE'''</code> &ndash; the size of the taskforce icons. (It is recommended to precede the size with "x" as this specifies the height of the image instead of the width, which results in a neater banner because all rows have equal height.) The default is a height of 25px. {{nowrap|''Eg: '''<code><nowiki>x30px</nowiki></code>'''''}}

'''Example:'''
{|style="background:none" width="50%"
|<syntaxhighlight lang="xml" style="font-size:100%">
{{WPBannerMeta
|PROJECT              = Tulips
 |BANNER_NAME         = Template:WikiProject Tulips
 |substcheck=<includeonly>{{subst:</includeonly><includeonly>substcheck}}</includeonly>
 |category={{{category|}}}
 |listas={{{listas|}}}
|IMAGE_LEFT           = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE        = standard
 |class={{{class|}}}
|tf 1={{{floridiae|}}}
 |TF_1_LINK           = Wikipedia:Wikiproject Tulips/Task forces/Floridiae
 |TF_1_NAME           = the Floridiae task force
 |TF_1_NESTED         = Floridiae
 |TF_1_TEXT           = 
 |TF_1_IMAGE          = Tulipa florenskyi 4.jpg
 |tf 1 importance={{{floridiae-importance}}}
 |TF_1_ASSESSMENT_CAT = Floridiae articles
 |TF_1_MAIN_CAT       = Floridiae articles
}}</syntaxhighlight>
|}
:Produces:
{{WPBannerMeta
|PROJECT          = Tulips
 |BANNER_NAME     = Template:WikiProject Tulips
|IMAGE_LEFT       = Tulipa suaveolens floriade to Canberra.jpg
|QUALITY_SCALE    = standard
 |class  = FA
|tf 1 = yes
 |TF_1_LINK       = Wikipedia:Wikiproject Tulips/Task forces/Floridiae
 |TF_1_NAME       = the Floridiae task force
 |TF_1_NESTED     = Floridiae
 |TF_1_TEXT       = 
 |TF_1_IMAGE      = Tulipa florenskyi 4.jpg
 |tf 1 importance= Top
 |TF_1_ASSESSMENT_CAT= Floridiae articles
 |TF_1_MAIN_CAT   = Floridiae articles
|category=no
}}

==Advanced features==
===Hooks===
{{selfref|For further details, see: [[Template:WPBannerMeta/hooks]]}}
WPBannerMeta incorporates a number of '[[hooking|hooks]]' where advanced or customised features can be added. These should take the form of a subtemplate passed to the relevant hook parameter. Any relevant parameters should then be passed to the hook template &ndash; it may be necessary to repeat parameters that are already passed to the main template ({{para|category|<nowiki>{{{category|}}}</nowiki>}} and {{para|class|<nowiki>{{{class|}}}</nowiki>}} are commonly used). If you write a hook that you think other projects could use, please copy or move it to a subpage of [[Template:WPBannerMeta/hooks]] and add it to the list on that page.

===Custom masks===
{{selfref|For further details, see: [[Template:Class mask/doc]]}}
WPBannerMeta uses a [[mask (computing)|mask]] to normalise the values given to the {{para|class}} parameter, to ensure that invalid inputs are discarded (e.g. {{para|class|cheesecake}}) and that equivalent inputs appear the same (e.g. {{para|class|FA}} and {{para|class|fA}}).  This mask effectively controls which extended assessment scale values are accepted by the template (e.g. "Template-Class", "Redirect-Class", etc.).  Projects which want to use more obscure assessment classes (e.g. "Future-Class", "Bplus-Class", etc.) or to ''not'' use all of the standard classes (e.g. not using "C-Class") can define their own custom mask, which will override WPBannerMeta's default.

==Other details==
This meta-template ''automatically'' categorises all instances (i.e. specific project banners) into a subcategory of [[:Category:WikiProject banner templates]]. It is not necessary to include a category link in the documentation for each project banner. Any project banners with errors are automatically added to [[:Category:WikiProject banners with formatting errors]].

The core WPBannerMeta template:
*[[Template:WPBannerMeta/core|/core]]

To reduce the byte-count of banners that do not make full use of WPBannerMeta's features, most of the optional features are broken out into subpages:
*[[Template:WPBannerMeta/doc|/doc]] &ndash; the documentation you are now reading.
*[[Template:WPBannerMeta/importancescale|/importancescale]] &ndash; the importance classification system.
**[[Template:WPBannerMeta/importance|/importance]] &ndash; used in conjunction with [[Template:Importance mask]] to normalise the value of the {{para|importance}} parameter.
*[[Template:WPBannerMeta/istemplate|/istemplate]] &ndash; tests the type of the current page (i.e. article talk page, templatepage, or demonstration).
*[[Template:WPBannerMeta/locwarning|/locwarning]] &ndash; warns when the banner template is used on a non-talk page.
**[[Template:WPBannerMeta/substwarning|/substwarning]] &ndash; warns when a banner template is substituted.
*[[Template:WPBannerMeta/note|/note]] &ndash; an individual note.
*[[Template:WPBannerMeta/taskforce|/taskforce]] &ndash; the code for each task force display.
*[[Template:WPBannerMeta/templatepage|/templatepage]] &ndash; the categories and notes that only appear on the template page.
*[[Template:WPBannerMeta/qualityscale|/qualityscale]] &ndash; the quality classification system.
**[[Template:WPBannerMeta/class|/class]] &ndash; used in conjunction with [[Template:Class mask]] to normalise the {{para|class}} input and account for B-Class checklist status, if enabled.

==See also==
* {{tl|B}} &ndash; convenience tool for frequent users of {{tl|WPBannerMeta}}'s <code>B_CHECKLIST</code> and <code>b1</code> through <code>b6</code> features
* {{tl|Inactive WikiProject banner}} – for use if a WikiProject becomes inactive or defunct
* {{tl|WikiProject banner shell}} – template to combine multiple WikiProject Banners
* {{tl|WPBannerDoc}} – convenience template that generates standardised parameter documentation for use on the /doc page
* {{section link|Wikipedia:WikiProject Council/Guide#Tagging pages with WikiProject banners}} – guideline about tagging articles for a project

{{Music theory essays}}
{{WikiProject Footer}}
{{Wikipedia technical help}}
{{Wikipedia templates}}
<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
{{#ifeq:{{FULLPAGENAME}}|Template:WPBannerMeta|
[[Category:Pages related to the WikiProject meta banner|*]]
[[Category:WikiProject banner templates|Meta]]
[[Category:Wikipedia metatemplates|WPBannerMeta]]}}

}}</includeonly><noinclude>
[[Category:Subtemplates of WPBannerMeta]]
</noinclude>