Template:Cite certification/doc
This is a documentation subpage for Template:Cite certification. It contains usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
Usage
This template creates a {{cite web}} citation for certification data from different regions. The citation created is as accurate as possible using the parameters given. Remember to check the output (e.g., for red error messages, broken links) when using this template; as an editor it is your responsibilty to check your additions.
Fields
|region=
– region in which the certification was awarded|artist=
– performing artist or group|title=
– title of work|type=
–album
/single
/video
/compilation
/videosingle
/ringtone
/EP
(see support below)|award=
– Gold/Platinum/Diamond etc.|number=
– number of awards given|certyear=
– year in which certification was awarded, used for linking in some cases|certmonth=
– month in which certification was awarded, used for linking in some cases|certweek=
– week in which certification was awarded, used for linking in some cases|position=
– chart position of work at time of certification, can used in some cases to ease navigation|id=
– documented where relevant|source=
– determines the source of the certification, documented where relevant|domestic=
– documented where relevant|access-date=
– date on which the data was accessed for verification|date=
– certification date|digital=
– set totrue
for digital download certifications, see support below|streaming=
– set totrue
for streaming certifications, see support below|archiveurl=
– specifies URL of archived info; used for old Portugal certifications only|archivedate=
– specifies date info was archived; used for old Portugal certifications only|Spanish=
– set totrue
for Spanish/Latin certifications, see support below|best=
– Specific usage, see support below
Usage examples
- To list all Linkin Park titles winning certification in Germany
{{Cite certification|region=Germany|artist=Linkin Park}}
produces
"Gold-/Platin-Datenbank (Linkin Park)" (in German). Bundesverband Musikindustrie.
- To list certifications in the United States for Coldplay's A Rush of Blood to the Head (also using access-date)
{{Cite certification|region=United States|artist=Coldplay|title=A Rush of Blood to the Head|access-date=2010-10-29}}
produces
"American certifications – Coldplay – A Rush of Blood to the Head". Recording Industry Association of America. Retrieved 2010-10-29.
- To list Australian certifications for U2's album Achtung Baby, note that although the album was released in 1991 the last certification (to date) was in 1998
{{Cite certification|region=Australia|type=album|certyear=1998}}
produces
"ARIA Charts – Accreditations – 1998 Albums" (PDF). Australian Recording Industry Association.
Supported regions
Region | Fields | Notes |
---|---|---|
Argentina | title artist type=album/video |
Information for old singles and compilation albums as well as new digital downloads is unavailable |
Australia | certyear type=album/single/video source id |
Use |certyear= to cite the yearly archives from 1990 to 2021To cite ARIA Top 50 charts (from July 2019), set |id= to YYYY-MM-DD, e.g. |id=2019-07-22 . To cite the Australian artist Top 20, set |domestic=true To cite ARIA Top 50 yearly charts (from 1988) set |source=yearchart Can also set |source=book to use Ryan, Gavin (2011). Australia’s Music Charts 1988–2010 (PDF ed.). Mt Martha, Victoria, Australia: Moonlight Publishing. and |id= is the page number.
|
Austria | title artist type |
|
Belgium | certyear type |
|
Brazil | artist type |
|
Canada | title artist type certmonth certyear digital |
certmonth and certyear are only used as backward compatibility if both title and artist are not supplied, in which case the old database is used (only valid from 2001)Set |digital=true for digital downloads or |type=ringtone for ringtones
|
Denmark | certyear source id type |
Use |source=chart to use weekly charts, which is required before 2004. |certyear= is the chart year and |id= is the chart week. Otherwise, if id is specified, will use the node number (accessible from the URL after search). Otherwise will use the default location http://www.ifpi.dk/certificeringer-0
|
Europe | certyear | Albums only. Only up to 2014. |
Finland | artist domestic |
Will use domestic certifications if |domestic=true
|
France | artist title type=album/single/video/compilation source certyear award number |
Use |source=archive to use SNEP archives as source, requires |certyear= , |award= and |number= for multiple awards.Use |source=infodisc for unofficial www.infodisc.fr tables (Manual search required)
|
GCC | certyear | From 2009 to 2011 only. |
Germany | title artist best=yes*/no |
In cases where the best certification does not show up (known bug), set |best=no to show the entire certification history
|
Greece | id type certyear certweek domestic |
Referenced from wayback machine archive, e.g. here. id is the full 14 digit timestamp, e.g. 20070114174502.Use |certyear= and |certweek= for correct titles.Supports |domestic=true where relevant (albums before 2011 and singles from 2021)
|
Hong Kong | certyear | Albums only. Only up to 2008. |
Hungary | certyear | |
Ireland | award number certyear |
From 2005 to 2013 only. |
Italy | id | From 2009 only. Use |id= for referencing the individual page (found at the end of the URL after clicking "Richiedi Targhetta"). Otherwise, manual search required.
|
Japan | certmonth certyear digital streaming type |
Set |digital=true or |type=ringtone for digital download certificationsSet |streaming=true uses the streaming certifications
|
Mexico | artist title type |
Manual search required |
Netherlands | artist type |
Manual search required |
New Zealand | type=album/single/compilation id source domestic |
Supports three sources: If |source=archive , uses Radioscope certifications archive which only go April 2007 to July 2011.If |source=book , uses Scapolo, Dean (2007). The Complete New Zealand Music Charts: 1966 – 2006. Wellington: Maurienne House. ISBN 978-1877443-00-8. and |id= is the page number.Otherwise uses the new website at nztop40.co.nz which has charts from 1975. In this case |id= is the number of the chart and setting |domestic=true will use the domestic charts.
|
Norway | artist certyear |
|
Philippines | ||
Poland | type=album/single/video award certyear |
|
Portugal | certyear id source archiveurl archivedate |
Supports three sources. The first is working and the latter two are obsolete and used only for backward compatibility:
|
Russia | certyear | Albums only |
Singapore | Albums only. From 2019 only | |
South Africa | ||
South Korea | type streaming |
From April 2018 only |
Spain | certyear certweek id type streaming |
If |id= is set, will use the El portal de Música entry for the specific title. In this case, id should be set to the end of the url for that title, e.g. for citing "Viva La Vida", the url is https://www.elportaldemusica.es/single/coldplay-viva-la-vida-2 and one needs to set |id=coldplay-viva-la-vida-2 . Also |type= is mandatory in this case.
Otherwise, |
Sweden | certyear certweek position type=single/album artist source |
Use |source=artist to cite by |artist= . Use |source=chart to cite by |certyear= and |certweek= from a chart, where |position= can be used to ease navigation. Otherwise, can use |certyear= for an archived citation but only until 2011.
|
Switzerland | title certyear |
Will use title if available, certyear otherwise
|
Taiwan | ||
Turkey | certyear | From 2004 to 2009 only |
United Kingdom | id | Manual search required if id not specified
|
United States | title artist type=album/single/video/videosingle/ringtone/EP Spanish |
Set |Spanish=true for Latin certifications
|
Uruguay | certyear |