แม่แบบ:Certification Table Entry/doc

แม่แบบนี้เป็นส่วนหนึ่งของชุดแม่แบบที่ใช้สำหรับสร้างตารางการรับรองสำหรับอัลบั้ม ซิงเกิล ฯลฯ โปรดทราบว่า WP:ALBUMSTYLE แนะนำให้สร้างตารางเฉพาะเมื่ออัลบั้มได้รับการรับรองหลายรายการ

• {{Certification Table Top}} สำหรับด้านบนของตาราง;
• {{Certification Table Entry}} สำหรับรายการตาราง;
• {{Certification Table Separator}} สำหรับการสร้างส่วนแบ่ง เช่น สำหรับการเริ่มต้นส่วนสรุป (ยังสามารถใช้ {{Certification Table Summary}} ได้เช่นเดิม);
• {{Certification Table Bottom}} สำหรับด้านล่างของตาราง

ดูแต่ละแม่แบบสำหรับคู่มือเฉพาะ แม่แบบนี้ยังใช้ {{cite certification}} สำหรับการอ้างอิง โปรดดูคู่มือแม่แบบนั้น

พารามิเตอร์ทั่วไป

All the templates support the following common parameters:

• |format=: The size and format of the table. |format=3col, the default value, will create three columns, namely region, award, and the amount sold for the certification. |format=2col or |format=2colthin create two columns, region and award. In the latter case the region column uses a thinner form.

ตัวอย่างการใช้งาน

The following is a common usage example for the set of templates using the default |format=3col. Examples using the other formats can be found here.

{{Certification Table Top|caption=การรับรองสำหรับ "Best song Ever"}}
{{Certification Table Entry|region=Finland|title=Best Song Ever|artist=My Band|type=single|award=Gold|salesamount=32,682}}
{{Certification Table Entry|region=France|title=Best Song Ever|artist=My Band|type=single|award=Platinum|certyear=1999|relyear=1998}}
{{Certification Table Entry|region=Germany|title=Best Song Ever|artist=My Band|type=single|award=Platinum|number=2|relyear=1998}}
{{Certification Table Entry|region=United States|title=Best Song Ever|artist=My Band|type=single|award=Platinum|number=2|relyear=1998|certyear=2015}}
{{Certification Table Separator|title=สตรีมมิง}}
{{Certification Table Entry|region=Sweden|title=Best Song Ever|artist=My Band|type=single|award=Platinum|certyear=2019|certweek=5|relyear=1998}}
{{Certification Table Summary}}
{{Certification Table Entry|region=Europe|title=Best Song Ever|artist=My Band|award=Platinum|number=4|certyear=1999}}
{{Certification Table Bottom|streaming=true|streamsonly=true}}

สร้าง:

การรับรองสำหรับ "Best song Ever"

ประเทศ	การรับรอง	จำนวนหน่วยที่รับรอง/ยอดขาย
Finland (Musiikkituottajat)	Gold	32,682
France (SNEP)	Platinum	500,000*
Germany (BVMI)	2× Platinum	1,000,000^
United States (RIAA)	2× Platinum	2,000,000
สตรีมมิง
Sweden (GLF)	Platinum	8,000,000†
สรุป
Europe (IFPI)	4× Platinum	4,000,000*
*ตัวเลขยอดขายขึ้นกับการรับรองอย่างเดียว ^ตัวเลขการจัดส่งขึ้นอยู่กับการรับรองเพียงอย่างเดียว ตัวเลขสตรีมมิงและยอดขายขึ้นอยู่กับการรับรองเพียงอย่างเดียว †ตัวเลขสตรีมมิงเท่านั้นขึ้นอยู่กับการรับรองเพียงอย่างเดียว

พารามิเตอร์เฉพาะ

บังคับ

• artist – performing artist or group
• title – title of work
• award – Silver/Gold/Platinum/Diamond/Million/Billion. Not all types supported for all regions. Please only use awards you see used by the awarding authority
• type – album/single/video/jazz. Not all types supported for all regions, see table below for details

ไม่บังคับ

• access-date – The date in which the source verifying the certification was retrieved, for web sources
• date – The date of certification
• nosales – set to any value if no sales figure is to be displayed
• nocert – set to any value if no certification is to be displayed. This can be used to specify sales figured from other sources
• certref – for specifying a different source for the certification. Enclose with <ref>...</ref>.
• number – number of awards given. For example, for Double Platinum enter 2.
• relyear – release year, used to calculate sales
• relmonth – release month (number), used to calculate sales in some cases
• relday – release day (number), used to calculate sales in some rare cases
• certyear – year in which certification was awarded, used for linking and to calculate sales in some cases
• certmonth – month (number) in which certification was awarded, used to calculate sales in some rare cases
• certweek – week (number) in which certification was awarded, used for linking and sales calculation in some cases
• position – chart position of work when certification was awarded, used for easing navigation in some cases
• certday – day (number) in which certification was awarded, used to calculate sales in some even rarer cases
• salesamount – override sales amount with a sales figure from a reliable source. It can also be used to override the sales amount if you believe the template is not calculating it correctly. Please let us know!
• salesref – source for overridden sales amount if it is not the certification itself
• id – external ID required for citation. Explained where relevant.
• discount – true for discount albums, influences certification levels in some regions
• domestic – true for domestic titles, influences certification levels and citation in some regions
• multidisc – the number of discs in a multi-disc package
• recent – true for recent certification, see below
• Spanish – true for Spanish-speaking albums, see United States below
• digital – true for digital downloads certification, check for support below
• streamsonly – true for streaming only certificatoin, check for support below
• note – Additional notes, e.g. specific edition certified
• best – see Germany below
• refname – enables you to specify a name for the reference generated by the template
• footnote – Overrides the footnote symbol. Allowed values are sales/shipments/streaming/streamsonly

ประเทศที่สนับสนุน

พารามิเตอร์ประเทศสำหรับแม่แบบ

ประเทศ	หมายเหตุ	แหล่งที่มาของเกณฑ์	ยอดขาย/การจัดส่ง
Argentina	Certifications currently unavailable Sales require |relyear= and sometimes |relmonth=. Supports |digital=true for digital single certification and |streamsonly=true for streaming singles. type also can be compilation	Article	Shipments
Australia	requires certyear Specifying |recent=book uses แม่แบบ:Cite Ryan and id is the page number. Otherwise, specify |id=YYYY-MM-DD to use the ARIA charts. Can also use |domestic=true for Australian artist charts	[1]	Shipmentsแม่แบบ:Right arrowSales+Streaming
Austria	Sales require relyear and sometimes relmonth.	[2]	Salesแม่แบบ:Right arrowSales+Streaming
Belgium	requires certyear supports |domestic=true Sales require certyear and relyear and sometimes relmonth and certmonth. Unknown thresholds for albums between 2006 and March 2007.	[3] [4] [5] [6] [7] [8] [9]	Salesแม่แบบ:Right arrowSales+Streaming
Brazil	Sales require certyear Set |domestic=true for domestic certification. Set |digital=true for album digital certification.	Pro-Música Brasil#Sales certification	Salesแม่แบบ:Right arrowSales+Streaming
Canada	Sales for albums require relyear and sometimes relmonth. Sales for singles require certyear and sometimes certmonth and certday Set |digital=true only for digital single certification (which were discontinued in 2016) Correct footnote for albums may require certyear and sometimes certmonth and certday	Music Canada#Certification awards	Sales/Shipmentsแม่แบบ:Right arrowSales+Streaming
Denmark	Specifying |recent=false uses charts, certyear is the chart year and id is the chart week. Otherwise will use the certification database. Specifying id will direct to the "node" (available from the URL after search). Otherwise will direct to the general database, and certyear can be specified for better directions. Sales require certyear and may require certmonth, certday, relyear, relmonth and relday. Supports |streamsonly=true for streaming certifications between January 7, 2011 and November 17, 2014	[10] [11] [12] [13] [14] [15]	Shipments/Streaming-onlyแม่แบบ:Right arrowSales+Streaming
Europe	requires certyear Albums only Use only in the summary section	[16]	Sales
Finland	Requires |artist= Requires |salesamount= from reported source Supports |domestic=true for local artists	Not used
France	requires certyear type also can be compilation Sales require certyear and may require certmonth and certday for some release dates set |recent=false for certification dates before 1994	[17] [18] [19] [20]	Salesแม่แบบ:Right arrowSales+Streaming
GCC	requires certyear. Supports |domestic=true, but without automatic citation.	[21]	Sales
Germany	type also can be jazz Sales require relyear and sometimes relmonth and relday. May also use certyear and certmonth for correct footnotes. In cases where the best certification does not show up (known bug), set |best=no to show the entire certification history	[22]	Shipmentsแม่แบบ:Right arrowSales+Streaming
Greece	Referenced from wayback machine archive here require id, the full 14 digit timestamp, e.g. 20070114174502 Sales require relyear and sometimes relmonth. Supports domestic certifications.	[23] [24] [25] [26] [27]	Shipments
Hong Kong		[28]	Sales
Hungary	requires certyear Sales require relyear and sometimes relmonth and relday Set |domestic=true for domestic releases. Unknown sales thresholds for international albums before 23 April 2002 or between 23 February 2005 and 12 September 2006.	[29] [30]	Shipmentsแม่แบบ:Right arrowSales+Streaming
Ireland	requires certyear Certifications availble only from 2005 to 2013	?	Shipments
Italy	Manual search required Sales require relyear and for singles may require certyear and certweek. May also use certmonth and relmonth for correct footnotes.	[31] [32] [33] [34]	Salesแม่แบบ:Right arrowSales+Streaming
Japan	Requires certyear and certmonth Sales require relyear and sometimes relmonth Set |digital=true for digital singles certifications. Set |streamsonly=true for streaming singles certifications. Supports |domestic=true for domestic repertoire prior to July 2003. Automatic citation for albums and digital/streaming singles only	[35] [36][37]	Sales/Shipments/Streaming-only
Mexico	Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes. Supports |award=Platinum+Gold,|award=Diamond+Gold,|award=Platinum+Diamond and even |award=Platinum+Diamond+Gold with |number= being the number of Platinum awards. Does not support multiple Diamond and Platinum awards together.	[38]	Sales/Shipmentsแม่แบบ:Right arrowSales+Streaming
Netherlands	Manual search required Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes.	[39] [40] [41] [42]	Shipmentsแม่แบบ:Right arrowSales+Streaming
New Zealand	type also can be compilation Specifying |recent=false uses Radioscope certifications which go April 2007 to July 2011. Specifying |recent=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 nztop40.co.nz which has charts from 1975. id required, the chart number and |domestic=true is supported. Sales require relyear and sometimes relmonth and relday. May also use certyear, certmonth and certday for correct footnote.	[43] [44]	Sales/Shipmentsแม่แบบ:Right arrowSales+Streaming
Norway	Sales require relyear and sometimes relmonth Unknown sales thresholds for singles before July 2002.	[45] [46] [47] [48] [49][50] [51]	Salesแม่แบบ:Right arrowSales+Streaming
Philippines	Sales require certyear and sometimes certmonth Supports |domestic=true	Philippine Association of the Record Industry#Certification levels	Sales
Poland	Sales require relyear and sometimes relmonth. May also use certyear and certmonth for correct footnotes. Requires certyear Supports |domestic=true	[52] [53]	Salesแม่แบบ:Right arrowSales+Streaming
Portugal	Supports three citation modes: For new certification (certyear>=2018) Requires |id=FILENAME, where FILENAME is according to the stored URL http://www.audiogest.pt/uploads/files/FILENAME. For older annual lists, 2007<=certyear<=2010, set |recent=true. From older archived weekly charts, for 2003<=certyear<=2010, requires |id=XXXXYY where XXXX is the year and YY is the week in which the title charted and requires |archiveurl= and |archivedate= Sales require relyear and may require relmonth and relday. May also use certyear for correct footnotes.	[54] [55] [56] [57]	Shipmentsแม่แบบ:Right arrowSales+Streaming
Russia	requires certyear Sales require relyear and sometimes relmonth supports para Automatic citation for albums only	[58]	Sales
Singapore	Sales for albums require certyear Automatic citation for albums certified in 2019 only	Recording Industry Association Singapore#Sales certificates	Sales
South Korea	Set |streamsonly=true for streaming singles certifications.	[59]	Sales/Shipments/Streaming-only
Spain	To use El portal de Música add |id=, the end of the url for that title. For example, 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. To use weekly tables, |certyear= is the year for the certification and |certweek= is the week number on which the PDF is available from the dropdown available under the week tab. Sales require |relyear= and sometimes |relmonth= and |relday= For Original Tones and Digital Downloads certification set |digital=true Also supports |streamsonly=true for streaming certifications between 2013 week 46 and the end of 2014	Productores de Música de España#Certifications	Shipments/Streaming-onlyแม่แบบ:Right arrowSales+Streaming
Sweden	requires certyear along with certweek for certifications after 2011. position can be used to ease navigation. Sales may require relyear and sometimes relmonth.	[60] [61], https://www.ifpi.se/musikbolag/guld-och-platina/	Shipmentsแม่แบบ:Right arrowSales+Streaming/Streaming-only
Switzerland	Sales require relyear. May also use certyear for correct footnotes. Set |domestic=true for repertoire in French and Italian	[62]	Shipmentsแม่แบบ:Right arrowSales+Streaming
United Kingdom	Manual search required if id not specified Sales for singles require relyear Set discount=true for correct discount album sales figure. For albums, sales correct only from 1979	[63] [64]	Shipments/Salesแม่แบบ:Right arrowSales+Streaming
United States	Supports multidisc for multi-disc packages set |Spanish=true for Spanish certification. Correct Spanish album sales require certyear and sometimes certmonth and certday Sales for singles require certyear Set |digital=true for digital single certification	[65] [66] [67] [68]	Shipments/Salesแม่แบบ:Right arrowSales+Streaming
Uruguay	requires certyear	[69] [70] [71] [72]	Shipments

IFPI summary tables: June 2013 September 2011 September 2010, January 2009, October 2007, 2005/2006

หมวดหมู่ติดตาม

หมวดหมู่ข้อผิดพลาด

หมวดหมู่ต่อไปนี้ควรว่างเปล่าเสมอ เนื่องจากแสดงถึงการใช้งานแม่แบบที่ผิดพลาด

• หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีพารามิเตอร์ที่ไม่รู้จัก (32)
• หมวดหมู่:หน้าที่ใช้ตารางการรับรองยอดขายที่ขาดข้อมูล (16)
• หมวดหมู่:การใช้งานตารางการรับรองสำหรับภูมิภาคที่ไม่รองรับโดยไม่มีแหล่งที่มา (1)
• หมวดหมู่:Cite certification used with missing parameters (12) (ทางลัดผ่านแการเรียก {{cite certification}})
• หมวดหมู่:การใช้งานตารางการรับรองของยอดขายที่ไม่มี่ salesref (32)

หมวดหมู่ติดตาม

หมวดหมู่ต่อไปนี้มีไว้สำหรับติดตามการใช้งานในรูปแบบต่าง ๆ

• หมวดหมู่:Certification Table Entry usages (36): เว้นแต่ |nocat= ถูกตั้งค่า แม่แบบเหล่านี้ติดตามการใช้งานสำหรับประเทศต่าง ๆ
• หมวดหมู่:หน้าที่ใช้ตารางการรับรองที่ไม่มีการรับรอง (53)
• หมวดหมู่:หน้าที่ใช้ตารางการรับรองโดยไม่มียอดขาย (14)
• หมวดหมู่:การใช้งานตารางการรับรองสำหรับภูมิภาคที่ไม่รองรับ (30)
• หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีตัวเลขยอดขาย (174) (ยืนยัน หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีเชิงอรรถยอดขาย (196))
• หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีตัวเลขการจัดส่ง (186) (ยืนยัน หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีเชิงอรรถการจัดส่ง (195))
• หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีตัวเลขสตรีมมิง (243) (ยืนยัน หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีเชิงอรรถสตรีมมิง (232))
• หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีตัวเลขสตรีมมิงเท่านั้น (50) (ยืนยัน หมวดหมู่:หน้าที่ใช้ Certification Table Entry ที่มีเชิงอรรถสตรีมมิงเท่านั้น (49))

ดูเพิ่ม

• {{Certification}}
• {{Cite certification}}