View source for Template:Banner holder/doc

{{Documentation subpage}}
{{Lua|Module:Banner shell}}
{{Uses TemplateStyles|Module:Message box/tmbox.css|Module:Banner shell/styles.css}}

== Usage ==
To group multiple banners, such as merge histories, into a box, and optionally collapse them into one banner to save vertical space.

===Basic syntax===
<syntaxhighlight lang="wikitext">
{{Banner holder |
{{First banner}}
{{Second banner}}
{{Third banner}}
...
}}
</syntaxhighlight>

===All parameters===
<syntaxhighlight lang="wikitext">
{{Banner holder |collapsed=yes |text=Some text here |image=someicon.jpog |size=48 |
{{First banner}}
{{Second banner}}
{{Third banner}}
...
}}
</syntaxhighlight>

Note that the vertical bar (<code>|</code>) at the end of the first line must be included.

====Optional parameters====
# Adding {{para|collapsed|yes}} will cause the outer table to be collapsed, hiding the banners. Adding {{para|collapsed|no}} (the default) will cause the outer table not to be collapsed, showing the banners.
# Adding {{para|text|some string...}} will cause the collapse bar title to be altered to ''some string''. If left blank or not used, the default string is ''Other talkpage banners.''.
# Adding {{para|image|file name}} (not including the 'Image:' or 'File' prefix) changes the puzzle piece to the specified image.
# Adding {{para|size|number}} changes the size of the image icon to the number of pixels specified.

{{gallery |mode=nolines |noborder=yes |title=Some icons which might be useful as images |height=27 |width=60
|File:Splitsection.svg|
|File:Merge-split-transwiki default.svg|
|File:Merge-arrow-3.svg|
|File:Merge-arrow 2.svg|
|File:OOjs UI icon language-ltr.svg|
|File:Translate (CoreUI Icons v1.0.0).svg|
|File:Translation_to_english_arrow.svg|
}}

==Examples==

This example shows a banner holder grouping multiple {{tl|Copied}} and {{tl|Translated page}} templates, with an altered image icon:
<syntaxhighlight lang="wikitext">
{{Banner holder |collapsed=yes |text=This page contains text [[BP:CWW|copied]] or [[BP:TFOLWP|translated]] from other articles |image=Merge-arrow-3.svg |size=36 |
{{Copied |from=SRC |from_oldid=rev |to=DEST |to_diff=dest-rev |to_oldid=prev-rev |date=DATE}}
{{translated page|de|ICE 1|version=45565777|insertversion=210289191}}
}}</syntaxhighlight> and generates:

{{Banner holder |collapsed=yes |text=This page contains text [[BP:CWW|copied]] or [[BP:TFOLWP|translated]] from other articles |image=Merge-arrow-3.svg |size=36 |
{{Copied |from=SRC |from_oldid=rev |to=DEST |to_diff=destrev |to_oldid=prev-rev |date=DATE}}
{{translated page|de|ICE 1|version=45565777|insertversion=210289191|nocat=true<!--avoid categorizing this page-->}}
}}

==Choosing banners to collapse==
The choice of which banners to collapse is left up to editors' discretion. Some banners have dedicated collapse headers, such as:
* WikiProjects {{snd}}{{tl|WikiProject banner shell}}
* Redirect categories{{snd}}{{tl|Redirect category shell}}
* {{tl|On this day}} templates{{snd}}self-collapsing

==See also==
* {{tl|Article history}} – For a template to condense Peer Reviews and other Good- or Featured-article history
* {{tl|Old XfD multi}} – For listing multiple deletion debates
* {{tl|Skip to talk}} – To skip past the many banners and templates straight to the table of contents
* {{tl|Talk header}} – Used at the top of some pages 
* Other banner shells:
** {{tl|WikiProject banner shell}} – for [[:Category:WikiProject templates|WikiProject banners]]
** {{tl|Redirect category shell}}  –  For [[:Category:Redirect templates|Redirect templates]]

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Bharatdata -->
[[Category:Non-subject-matter-related article-talk header templates]]
[[Category:WikiProject banner templates]]
[[Category:Template shell templates]]
[[Category:Templates that are not mobile friendly]]

}}</includeonly>