View source for Template:Infobox musician awards/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

'''{{Tl|Infobox musician awards}}''' is the infobox for [[musician]] articles and lists to show a summary of notable awards won and award nominations.

== Usage ==
The following are examples of use which should be placed in an article at the top of the page, before the introduction.

=== Using pre-set award names ===
<pre>{{Infobox musician awards
| name = 
| image = 
| image_size = 
| alt = 
| caption = 

| wins = 0
| nominations = 0

| AmericanW = 0
| AmericanN = 0
| GrammyW = 0
| GrammyN = 0
}}</pre>

=== Adding other awards ===
<pre>{{Infobox musician awards
| name = 
| image = 
| image_size = 
| alt = 
| caption = 

| wins = 0
| nominations = 0

| AmericanW = 0
| AmericanN = 0
| GrammyW = 0
| GrammyN = 0

| award1 = [[TRL Awards]]
| award1W = 1
| award1N = 0
| award2 = [[Canadian Radio Music Awards]]
| award2W = 1
| award2N = 0
| award3 = [[UK Nickelodeon Kids' Choice Awards]]
| award3W = 1
| award3N = 0
}}</pre>

=== Fully customized list ===
<pre>{{Infobox musician awards
| name = 
| image = 
| image_size = 
| alt = 
| caption = 

| wins = 0
| nominations = 0

| customs = {{Infobox musician awards/customs|American Music Awards|0|0}}
{{Infobox musician awards/customs|Canadian Radio Music Awards|0|0}}
{{Infobox musician awards/customs|Grammy Awards|0|0}}
{{Infobox musician awards/customs|TRL Awards|0|0}}
{{Infobox musician awards/customs|UK Nickelodeon Kids' Choice Awards|0|0}}
}}</pre>

== Parameters ==
=== Name ===
The name of the group or artist ("the act") in plain text only to be used above the infobox.

=== Image ===
An image of the musical artist. Set to only the image name, e.g. <code>Example.png</code>, not <code>Image:Example.png</code> or <code><nowiki>[[File:Example.png|200px|abc]]</nowiki></code>.

=== Image_size ===
Width to use for the image. Enter the width in pixels with "px", for example <code>220px</code>.

=== Alt ===
Alt text for the image, for visually impaired and other readers who cannot see the image. See [[WP:ALT]].

=== Caption ===
Caption for the image to be displayed.

=== Awards ===
This is the total number of awards the musical group or artist has won.

=== Nominations ===
This is the total number of awards the musical group or artist has been nominated for, but not won.

=== Named parameters ===
Each specifically named parameter corresponds to one specific award ceremony. The parameter includes a W or N to define the total number of awards won or nominated.
;Example:
<pre>|AmericanW = 0
|AmericanN = 1
|GrammyW = 3
|GrammyN = 2</pre>
The above example indicates that the group or artist American Music Award was nominated for 1 American Music Award, won 3 Grammy Awards, and was nominated for 2 Grammy Awards.

Below is the current list of named award parameters and their corresponding ceremonies:
*American – American Music Awards
*APRA – APRA Awards
*ARIA – ARIA Music Awards
*ASF – Asia Song Festival
*BET – BET Awards
*BETHH – BET Hip Hop Awards
*Billboard – Billboard Music Awards
*BRIT – Brit Awards
*CMTMA – CMT Music Awards
*Cyworld – Cyworld Digital Music Awards
*ECHO – Echo Awards
*Grammy – Grammy Awards
*GDA – Golden Disk Awards
*GGA – Golden Globe Awards
*Ivor – Ivor Novello Awards
*J – J Awards
*Jack – Jack Awards
*Juno – Juno Awards
*Kerrang – Kerrang! Awards
*VMALA – Los Premios MTV Latinoamérica
*MAMA – Mnet Asian Music Awards
*MCA – Mnet 20's Choice Awards
*Meteor – Meteor Music Awards
*Melon – Melon Music Awards
*MOBO – MOBO Awards
*MOJO – MOJO Awards
*MTVAfrica – MTV Africa Music Awards
*MTVAsia – MTV Asia Music Awards
*MTVAustralia – MTV Australia Music Awards
*MTVEurope – MTV Europe Music Awards
*MTVVideo – MTV Video Music Awards
*MTVBrasil – MTV Video Music Brasil
*MTVJapan – MTV Video Music Awards Japan
*MuchMusic – MuchMusic Video Awards
*MVPA – MVPA Awards
*NAACP – NAACP Image Awards
*NZMA – New Zealand Music Awards
*NickAustralia – Nickelodeon Australian Kids' Choice Awards
*Nick – Nickelodeon Kids' Choice Awards
*NME – NME Awards
*NRJ – NRJ Music Awards
*Peoples – People's Choice Awards
*PLUG – PLUG Awards
*Polaris – Polaris Music Prizes
*Radio – Radio Music Awards
*Q – Q Awards
*SMA – Seoul Music Awards
*Shortlist – Shortlist Music Prizes
*Soul – Soul Train Music Awards
*Teen – Teen Choice Awards
*TMF – TMF Awards
*World – World Music Awards

To create a new award name field within this template, use [[Template:Infobox musician awards/new]].

=== Award#, award#W, and award#N ===
Adds an additional award not listed above to the bottom of the list, where # is any number from 1-20.  Use with Award#N and Award#W.
<pre>| award1 = [[TRL Awards]]
| award1W = 1
| award1N = 0
| award2 = [[Canadian Radio Music Awards|CRM Awards]]
| award2W = 1
| award2N = 0
| award3 = [[UK Nickelodeon Kids' Choice Awards]]
| award3W = 1
| award3N = 0</pre>

=== Customs ===
An additional way to add custom awards is to use {{tl|Infobox musician awards/customs}} within this parameter. This method gives the user the ability to manipulate the order in which the awards appear; however, all awards within the customs parameter will appear at the very bottom of the awards list if other awards parameters are defined.
<pre>| customs = {{Infobox musician awards/customs|[[TRL Awards]]|0|1}}
{{Infobox musician awards/customs|[[Canadian Radio Music Awards|CRM Awards]]|1|0}}
{{Infobox musician awards/customs|[[UK Nickelodeon Kids' Choice Awards]]|1}}</pre>

=== Collapse ===
To collapse the infobox by default, add the following line to the code:
<pre>| collapse = yes</pre>

== Full example ==
{| style="margin:auto; background:transparent;"
|- style="vertical-align:top;"
| <pre>{{Infobox musician awards
| name = The Beatles
| image = The Fabs.JPG
| image_size = 220px
| alt = Four men in four separate photos;
only their heads are shown
| caption = The Beatles in 1964

| wins = 0
| nominations = 0

| AmericanW = 0
| AmericanN = 0
| APRAW = 0
| APRAN = 0
| ARIAW = 0
| ARIAN = 0
| ASFW = 0
| ASFN = 0
| BETW = 0
| BETN = 0
| BETHHW = 0
| BETHHN = 0
| BillboardW = 0
| BillboardN = 0
| BRITW = 0
| BRITN = 0
| CMTMAW = 0
| CMTMAN = 0
| CyworldW = 0
| CyworldN = 0
| ECHOW = 0
| ECHON = 0
| GDAW = 0
| GDAN = 0
| GrammyW = 0
| GrammyN = 0
| IvorW = 0
| IvorN = 0
| JW = 0
| JN = 0
| JackW = 0
| JackN = 0
| JunoW = 0
| JunoN = 0
| KerrangW = 0
| KerrangN = 0
| VMALAW = 0
| VMALAN = 0
| MamaW = 0
| MamaN = 0
| MelonW = 0
| MelonN = 0
| MeteorW = 0
| MeteorN = 0
| MCAW = 0
| MCAN = 0
| MOBOW = 0
| MOBON = 0
| MOJOW = 0
| MOJON = 0
| MTVAfricaW = 0
| MTVAfricaN = 0
| MTVAsiaW = 0
| MTVAsiaN = 0
| MTVAustraliaW = 0
| MTVAustraliaN = 0
| MTVEuropeW = 0
| MTVEuropeN = 0
| MTVVideoW = 0
| MTVVideoN = 0
| MTVBrasilW = 0
| MTVBrasilN = 0
| MTVJapanW = 0
| MTVJapanN = 0
| MuchMusicW = 0
| MuchMusicN = 0
| MVPAW = 0
| MVPAN = 0
| NAACPW = 0
| NAACPN = 0
| NickAustraliaW = 0
| NickAustraliaN = 0
| NickW = 0
| NickN = 0
| NMEW = 0
| NMEN = 0
| NRJW = 0
| NRJN = 0
| PeoplesW = 0
| PeoplesN = 0
| PLUGW = 0
| PLUGN = 0
| PolarisW = 0
| PolarisN = 0
| RadioW = 0
| RadioN = 0
| QW = 0
| QN = 0
| SDAW = 0
| SDAN = 0
| ShortlistW = 0
| ShortlistN = 0
| SoulW = 0
| SoulN = 0
| TeenW = 0
| TeenN = 0
| TMFW = 0
| TMFN = 0
| WorldW = 0
| WorldN = 0

| award1 = Custom award 1
| award1W = 0
| award1N = 0
| award2 = Custom award 2
| award2W = 0
| award2N = 0
...
| award20 = Custom award 20
| award20W = 0
| award20N = 0
| customs =
{{Infobox musician awards/customs|Customs award 1|0|1}}
{{Infobox musician awards/customs|Customs award 2|1|0}}
{{Infobox musician awards/customs|Customs award 3|1}}
}}</pre>
| {{Infobox musician awards
| name = The Beatles
| image = The Fabs.JPG
| image_size = 220px
| alt = Four men in four separate photos; only their heads are shown
| caption = The Beatles in 1964

| AmericanW = 0
| AmericanN = 0
| APRAW = 0
| APRAN = 0
| ARIAW = 0
| ARIAN = 0
| ASFW = 0
| ASFN = 0
| BETW = 0
| BETN = 0
| BETHHW = 0
| BETHHN = 0
| BillboardW = 0
| BillboardN = 0
| BRITW = 0
| BRITN = 0
| CMTMAW = 0
| CMTMAN = 0
| CyworldW = 0
| CyworldN = 0
| ECHOW = 0
| ECHON = 0
| GDAW = 0
| GDAN = 0
| GrammyW = 0
| GrammyN = 0
| IvorW = 0
| IvorN = 0
| JW = 0
| JN = 0
| JackW = 0
| JackN = 0
| JunoW = 0
| JunoN = 0
| KerrangW = 0
| KerrangN = 0
| VMALAW = 0
| VMALAN = 0
| MamaW = 0
| MamaN = 0
| MelonW = 0
| MelonN = 0
| MeteorW = 0
| MeteorN = 0
| MCAW = 0
| MCAN = 0
| MOBOW = 0
| MOBON = 0
| MOJOW = 0
| MOJON = 0
| MTVAfricaW = 0
| MTVAfricaN = 0
| MTVAsiaW = 0
| MTVAsiaN = 0
| MTVAustraliaW = 0
| MTVAustraliaN = 0
| MTVEuropeW = 0
| MTVEuropeN = 0
| MTVVideoW = 0
| MTVVideoN = 0
| MTVBrasilW = 0
| MTVBrasilN = 0
| MTVJapanW = 0
| MTVJapanN = 0
| MuchMusicW = 0
| MuchMusicN = 0
| MVPAW = 0
| MVPAN = 0
| NAACPW = 0
| NAACPN = 0
| NickAustraliaW = 0
| NickAustraliaN = 0
| NickW = 0
| NickN = 0
| NMEW = 0
| NMEN = 0
| NRJW = 0
| NRJN = 0
| PeoplesW = 0
| PeoplesN = 0
| PLUGW = 0
| PLUGN = 0
| PolarisW = 0
| PolarisN = 0
| RadioW = 0
| RadioN = 0
| QW = 0
| QN = 0
| ShortlistW = 0
| ShortlistN = 0
| SMAW = 0
| SMAN = 0
| SoulW = 0
| SoulN = 0
| TeenW = 0
| TeenN = 0
| TMFW = 0
| TMFN = 0
| WorldW = 0
| WorldN = 0

| award1 = Custom award 1
| award1W = 0
| award1N = 0
| award2 = Custom award 2
| award2W = 0
| award2N = 0
| award3 = Custom award 3
| award3W = 0
| award3N = 0
| award4 = Custom award 4
| award4W = 0
| award4N = 0
| award5 = Custom award 5
| award5W = 0
| award5N = 0
| award6 = Custom award 6
| award6W = 0
| award6N = 0
| award7 = Custom award 7
| award7W = 0
| award7N = 0
| award8 = Custom award 8
| award8W = 0
| award8N = 0
| award9 = Custom award 9
| award9W = 0
| award9N = 0
| award10 = Custom award 10
| award10W = 0
| award10N = 0
| award11 = Custom award 11
| award11W = 0
| award11N = 0
| award12 = Custom award 12
| award12W = 0
| award12N = 0
| award13 = Custom award 13
| award13W = 0
| award13N = 0
| award14 = Custom award 14
| award14W = 0
| award14N = 0
| award15 = Custom award 15
| award15W = 0
| award15N = 0
| award16 = Custom award 16
| award16W = 0
| award16N = 0
| award17 = Custom award 17
| award17W = 0
| award17N = 0
| award18 = Custom award 18
| award18W = 0
| award18N = 0
| award19 = Custom award 19
| award19W = 0
| award19N = 0
| award20 = Custom award 20
| award20W = 0
| award20N = 0

| customs = {{Infobox musician awards/customs|Customs award 1}}
{{Infobox musician awards/customs|Customs award 2|0}}
{{Infobox musician awards/customs|Customs award 3|0|0}}
}}
|}

=== See also ===
* {{tl|Awards table}}
* {{tl|Infobox artist discography}}
* {{tl|Infobox musician awards/new}}
* {{tl|Infobox musician awards/customs}}

<includeonly>{{sandbox other||
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:WikiProject Albums templates]]
[[Category:Music awards templates|Infobox musician awards]]
[[Category:Award infobox templates]]
}}</includeonly>