Difference between revisions of "Template:Certification Table Top/doc"

From blackwiki
Jump to navigation Jump to search
imported>Muhandes
(→‎Parameters: better)
imported>Vanisaac
m (→‎Usage examples: clean up per WP:CAT#T and WP:AWBREQ add template:Sandbox other)
 
(2 intermediate revisions by one other user not shown)
Line 5: Line 5:
 
Note that [[WP:ALBUM/CERT]] recommends the creation of a table only when an album has achieved multiple certifications.
 
Note that [[WP:ALBUM/CERT]] recommends the creation of a table only when an album has achieved multiple certifications.
  
* [[Template:Certification Table Top|Certification Table Top]] - for the top of the table
+
* [[Template:Certification Table Top|Certification Table Top]] for the top of the table
* [[Template:Certification Table Entry|Certification Table Entry]] - for table entries
+
* [[Template:Certification Table Entry|Certification Table Entry]] for table entries
* [[Template:Certification Table Summary|Certification Table Summary]] - for starting the summary section. This section should be used to specify certifications from regions which may include other regions. For example, European certifications.
+
* [[Template:Certification Table Summary|Certification Table Summary]] for starting the summary section. This section should be used to specify certifications from regions which may include other regions. For example, European certifications.
* [[Template:Certification Table Bottom|Certification Table Bottom]] - for the bottom of the table
+
* [[Template:Certification Table Bottom|Certification Table Bottom]] for the bottom of the table
  
 
If one wants to add more columns, one can create the top and the bottom on their own and only use the entry template.
 
If one wants to add more columns, one can create the top and the bottom on their own and only use the entry template.
Line 14: Line 14:
 
== Parameters ==
 
== Parameters ==
 
* The table includes either two or three columns depending on the variable {{para|format}}. If {{para|format|3col}}, the default value, the columns are region, award, and the amount sold/shipped for the certification. The third column can be replaced by a sales figure from another source. If{{para|format|2col}} or {{para|format|2colthin}}, the columns are region and award. In the latter case the region column uses a thinner form.
 
* The table includes either two or three columns depending on the variable {{para|format}}. If {{para|format|3col}}, the default value, the columns are region, award, and the amount sold/shipped for the certification. The third column can be replaced by a sales figure from another source. If{{para|format|2col}} or {{para|format|2colthin}}, the columns are region and award. In the latter case the region column uses a thinner form.
* The Top template receives a {{para|caption}} parameter which can be used to add a caption to the table.
+
* The Top template receives a {{para|caption}} parameter which should be used to add a caption to the table.
  
 
==Usage examples==
 
==Usage examples==
Line 93: Line 93:
 
{{reflist}}
 
{{reflist}}
  
<includeonly>
+
<includeonly>{{Sandbox other||
 
[[Category:Music templates]]
 
[[Category:Music templates]]
  
</includeonly>
+
}}</includeonly>

Latest revision as of 01:38, 24 April 2020

This template is part of a set of templates used for creating certification tables for albums, singles, etc.

Note that WP:ALBUM/CERT recommends the creation of a table only when an album has achieved multiple certifications.

If one wants to add more columns, one can create the top and the bottom on their own and only use the entry template.

Parameters

  • The table includes either two or three columns depending on the variable |format=. If |format=3col, the default value, the columns are region, award, and the amount sold/shipped for the certification. The third column can be replaced by a sales figure from another source. If|format=2col or |format=2colthin, the columns are region and award. In the latter case the region column uses a thinner form.
  • The Top template receives a |caption= parameter which should be used to add a caption to the table.

Usage examples

The following is a short usage example. See the documentation for the entry template for more details.

3 column version
{{Certification Table Top}}
{{Certification Table Entry|region=Argentina|type=album|title=Believe|artist=Cher|award=Platinum|relyear=1999}}
{{Certification Table Entry|region=Finland|title=Believe|artist=Cher|type=album|award=Gold|salesamount=32,682}}
{{Certification Table Entry|region=France|title=Believe|artist=Cher|type=album|award=Platinum|certyear=1999|relyear=1998}}
{{Certification Table Entry|region=Germany|title=Believe|artist=Cher|type=album|award=Platinum|number=2|relyear=1998}}
{{Certification Table Summary}}
{{Certification Table Entry|region=Europe|title=Believe|artist=Cher|award=Platinum||number=4|certyear=1999}}
{{Certification Table Bottom}}

Creates:

Region Certification Certified units/sales
Argentina (CAPIF)[1] Platinum 60,000^
Finland (Musiikkituottajat)[2] Gold 32,682[2]
France (SNEP)[3] Platinum 300,000*
Germany (BVMI)[4] 2× Platinum 1,000,000^
Summaries
Europe (IFPI)[5] 4× Platinum 4,000,000*

*sales figures based on certification alone
^shipments figures based on certification alone

2 column version
{{Certification Table Top|format=2col}}
{{Certification Table Entry|format=2col|region=Argentina|type=album|title=Believe|artist=Cher|award=Platinum}}
{{Certification Table Entry|format=2col|region=Finland|title=Believe|artist=Cher|type=album|award=Gold}}
{{Certification Table Entry|format=2col|region=France|title=Believe|artist=Cher|type=album|award=Platinum|certyear=1999}}
{{Certification Table Entry|format=2col|region=Germany|title=Believe|artist=Cher|type=album|award=Platinum|number=2}}
{{Certification Table Summary|format=2col}}
{{Certification Table Entry|format=2col|region=Europe|title=Believe|artist=Cher|award=Platinum||number=4|certyear=1999}}
{{Certification Table Bottom|format=2col}}

Creates:

Region Certification
Argentina (CAPIF)[1] Platinum
Finland (Musiikkituottajat)[2] Gold
France (SNEP)[3] Platinum
Germany (BVMI)[4] 2× Platinum
Summaries
Europe (IFPI)[5] 4× Platinum
2 column thin version
{{Certification Table Top|format=2colthin}}
{{Certification Table Entry|format=2colthin|region=Argentina|type=album|title=Believe|artist=Cher|award=Platinum}}
{{Certification Table Entry|format=2colthin|region=Finland|title=Believe|artist=Cher|type=album|award=Gold}}
{{Certification Table Entry|format=2colthin|region=France|title=Believe|artist=Cher|type=album|award=Platinum|certyear=1999}}
{{Certification Table Entry|format=2colthin|region=Germany|title=Believe|artist=Cher|type=album|award=Platinum|number=2}}
{{Certification Table Summary|format=2colthin}}
{{Certification Table Entry|format=2colthin|region=Europe|title=Believe|artist=Cher|award=Platinum||number=4|certyear=1999}}
{{Certification Table Bottom|format=2colthin}}

Creates:

Region Certification
Argentina[1] Platinum
Finland[2] Gold
France[3] Platinum
Germany[4] 2× Platinum
Summaries
Europe[5] 4× Platinum
  1. 1.0 1.1 1.2 "Argentinian album certifications – Cher – Believe". Argentine Chamber of Phonograms and Videograms Producers.
  2. 2.0 2.1 2.2 2.3 "Cher" (in Finnish). Musiikkituottajat – IFPI Finland.
  3. 3.0 3.1 3.2 "French album certifications – Cher – Believe" (in French). Syndicat National de l'Édition Phonographique.
  4. 4.0 4.1 4.2 "Gold-/Platin-Datenbank (Cher; 'Believe')" (in German). Bundesverband Musikindustrie.
  5. 5.0 5.1 5.2 "IFPI Platinum Europe Awards – 1999". International Federation of the Phonographic Industry.