Templat:Single chart

Dokumentasi templat[lihat] [sunting] [riwayat] [segarkan]

Templat ini menggunakan Lua:

Templat ini digunakan untuk mengutip sumber pada Wikipedia. Secara khusus untuk rilisan singel rekaman musik: singel. Templat serupa untuk mengutip sumber album musik adalah Templat:Albumchart; namun, untuk EP (album mini) dan lain-lain digunakan templat lain.

Penggunaan

Semua nama bidang harus dalam huruf kecil.

Versi lengkap (copy dan paste teks di bawah dan hapus parameter yang tidak diperlukan)
`{{singlechart \|(Chart identifier) \|(Peak position) \|song= \|songid= \|artist= \|chartid= \|url= \|urltitle= \|date= \|year= \|week= \|note= \|publishdate= \|accessdate= \|refname= \|refgroup= \|rowheader=}}` Merupakan sebuah kebiasan yang baik dengan selalu memasukan "song=" dan "artist=", meskipun beberapa penggunaan templat tidak memerlukan kedua parameter tersebut. Hal ini bertujuan untuk mempermudah modifikasi templat di kemudian hari jika terdapat perubahan dalam arsip yang dirujuk oleh templat ini. Selain itu, parameter artist digunakan secara default untuk menamai referensi yang dapat digunakan kembali di tempat lain dalam artikel. `rowheader` disetel secara default ke `false`. Jika disetel ke `true`, nama chart akan ditampilkan sebagai header, seperti yang ditunjukkan oleh Wikipedia:Manual gaya (aksesibilitas)#Tabel data. Dalam kebanyakan kasus, rowheader harusnya disetel ke true.

Bidang-bidang

Parameter publishdate, accessdate, dan refname bersifat opsional. Keperluan parameter lain tergantung "chart" yang dirujuk. Lihat tabel pada bagian Support.

(Chart identifier) (or first parameter, without name): Chart identifier. Must be one of the options listed under Chart ID in the tables of the Support section below. Often named as a country or nationality (e.g., Spain or Spanish), but sometimes named for a specific chart (e.g., Billboardjapanhot100). Some charts allow more than one identifier; the results produced are identical.
(Peak position) (or second parameter, without name): The number you found to be the peak position achieved by the single on the specific chart to date. If the song has not appeared on the chart (due to low popularity or lack of release in a country), you can enter a dash (–, not a hyphen -). Usually, it's better to omit the template completely.
song: Title of the single. Made-up words, slang, "hip" spellings, tricky punctuation, etc., can make this parameter difficult to correctly determine. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article.
songid: Numeric identifier used by some chart listings (see UKchartstats below). Determined by performing a search at the chart listings' website for the single (or performer or album, then following a link through to the single's page). The songid can be found in the Web address (URL) by inspection. For example, the page for "Genie In A Bottle" at www.chartstats.com has the URL http://www.chartstats.com/songinfo.php?id=27705, so the songid to use is 27705.
artist: Name of the single's performer. As for the song parameter, odd spellings and clever stylings (e.g., Ke$ha) can make this parameter difficult to correctly determine. The German chart, for example, typically requires names in lastname,firstname format. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article. Also note that this parameter is required for all charts where you are reusing the references using the default naming (see Output section below). If you use the refname parameter, however, artist may not be absolutely necessary.
artistid: Formerly required for Billboard charts, this parameter is now obsolete.
chartid: Numeric identifier used by some chart listings (see Polish Music Charts). Determined by performing a search at the chart listings' website for archive chart. The chartid can be found in the Web address (URL) by inspection. For example, Polish Airplay Chart of 12 November 2011 at www.zpav.pl has the URL http://www.zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, so the chartid to use is 532.
url: The URL of the reference where you found the song's peak position for the chart. Used only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
urltitle: The title of the page for the reference where you found the song's peak position for the chart. Used in combination with the url parameter, and only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
date: Date of the chart in the format YYYYMMDD, an 8-digit number indicating year (Y), month (M) and day (D). Used only for certain charts (see Frenchdigital below); not necessary (or even used) for others. This date is used solely to create the reference URL to the download chart, and is not displayed textually in the references list. For general citation of any chart's publication date, use the optional publishdate parameter.
year: Four-digit year indicating the year being reported by the chart. Used in combination with the week parameter and only for certain charts; not necessary (or even used) for others. Not necessarily the same as the publication date referred to by publishdate.
week: Two-digit week indicating the week being reported by the chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09 (some charts do not require the leading zero; consult Support tables below). Used in combination with the year parameter and only for certain charts; not necessary (or even used) for others. Not necessarily related to the publication date referred to by publishdate.
note: For adding a note about a particular version of a song, e.g., note=extended dance mix, or {{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=The Bonzo Dog Doo Dah Band|note=uncensored version}}.
publishdate: Date of publication of the reference generated by the template, in the same format as other dates in citations in the same article. Optional parameter.
accessdate: Date that the reference generated by the template was retrieved to determine peak position. Should be in the same format as other dates in citations in the same article. Optional parameter.
refname: Enables you to specify a name for the reference generated by the template. If no value is provided for refname the default reference name (in the form sc_Chartid_artist, see Output below) will be used. A reference with a name can be reused for claims elsewhere in the article. Optional parameter.
refgroup: Enables you to specify a name for the reference group. Optional parameter.

Output

The template's expansion results in two output items:

suatu baris output untuk sebuah baris tabel dua sel, dan
suatu referensi

The output row includes the piping character to divide the left cell from the right cell. The left cell includes the country and/or chart name, with wikilinks to the chart article(s), as well as the reference note^[n] as if it were enclosed in <ref></ref> tags. Any note included with the note parameter is shown in the left cell as well. The right cell contains the peak position number, including the code to horizontally center the number in the table cell.

The citation generated by this template will appear in the list in place of <references /> or the {{reflist}} template, like any other references. The reference produced will be given a name in the form "sc_Chartid_artist" by default, i.e., if the article uses

{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|note=album version}}

then the citation could be used to support other statements on the page using a reference as in

...some fact supported by the same source.<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/>

Alternatively, the name can be overridden using the refname parameter, i.e.,

{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|refname=bonzosinoz}}

which could then be used as a citation to support other statements on the page using a reference as in

...some fact supported by the same source.<ref name=bonzosinoz/>

Note that the refname parameter does not require the use of quotation marks, but names with spaces in them will necessitate quotation marks in the name parameter of <ref> (for example, you would need to use <ref name="bonzos in oz"/> if you used spaces in the name).

Contoh singkat output dengan berbagai parameter

A few quick examples of template usage and the corresponding output are shown here. More detailed examples with surrounding table code are in the Examples with table layout section below.

Contoh no. Coding (assumed inside a table row) Output (assumed with <references /> added)

Contoh 1

{{singlechart
  |Australia
  |18
  |artist=Shakira
  |song=She Wolf}}

Australia (ARIA)^[1]	18

^ "Australian-charts.com – Shakira – She Wolf". ARIA Top 50 Singles.

Contoh 2

 {{singlechart
  |Billboardcanadianhot100
  |5
  |artist=Shakira}}

Kanada (Canadian Hot 100)^[1]	5

^ "Shakira Chart History (Canadian Hot 100)". Billboard.

Contoh 3

 {{singlechart
  |Frenchdigital
  |4
  |artist=Shakira
  |song=She Wolf
  |date=20091017}}

France (SNEP) Download Chart^[1]	4

^ "Templat:Digits lescharts.com – Français" (dalam bahasa Prancis). Les classement de telechargement single.

Contoh 4

 {{singlechart
  |Italy
  |3
  |artist=Shakira
  |song=Loba
  |note="Loba" (Spanish version)}}
|-
{{singlechart
  |Italy
  |11
  |artist=Shakira
  |song=She Wolf
  |note="She Wolf" (English version)}}

Italia (FIMI)^[1] "Loba" (Spanish version)	3
Italia (FIMI)^[1] "She Wolf" (English version)	11

^ ^a ^b "Italiancharts.com – Shakira – Loba". Top Digital Download. Kesalahan pengutipan: Tanda <ref> tidak sah; nama "sc_Italy_Shakira" didefinisikan berulang dengan isi berbeda

Contoh 5

{| class="wikitable sortable"
|-
! Chart (2009)
! Peak<br />position
|-
{{singlechart |Flanders|16
  |artist=Shakira |song=She Wolf}}
|-
{{singlechart |Wallonia|5
  |artist=Shakira |song=She Wolf}}
|-
|[[Billboard Brasil|
Brazil ''Billboard'' Hot 100 Airplay]]<ref>
"Brazil Hot 100 Airplay" (in Portuguese).
Billboard Brasil (Brazil: bpp) (2): 79. November 2009.
ISSN 977-217605400-2</ref>
| style="text-align:center;"|1
|-
{{singlechart |Hungary|5|year=2009|week=14}}
|-
{{singlechart |Ireland|2 |year=2009 |week=40}}
|-
{{singlechart |Billboardjapanhot100|9
  |artist=Shakira}}
|-
{{singlechart|Poland|2|year=2013|chartid=532}}
|-
{{singlechart |UKchartstats|4
  |artist=Shakira|song=She Wolf|songid=34525}}
|}

Chart (2009)	Peak position
Belgium (Ultratop 50 Flanders)^[1]	16
Belgium (Ultratop 50 Wallonia)^[2]	5
Brazil Billboard Hot 100 Airplay^[3]	1
Hongaria (Rádiós Top 40)^[4]	5
Irlandia (IRMA)^[5]	2
Jepang (Japan Hot 100)^[6]	9
Polandia (Polish Airplay Top 100)^[7]	2
UK Singles (Official Charts Company)^[8]	4

^ "Ultratop.be – Shakira – She Wolf" (dalam bahasa Belanda). Ultratop 50.
^ "Ultratop.be – Shakira – She Wolf" (dalam bahasa Prancis). Ultratop 50.
^ "Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2
^ "Archívum – Slágerlisták – MAHASZ" (dalam bahasa Hongaria). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.
^ "Chart Track: Week 40, 2009". Irish Singles Chart.
^ "Shakira Chart History (Japan Hot 100)". Billboard.
^ "Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Airplay Top 100.
^ "Shakira: Artist Chart History". Official Charts Company.

Error messages

As an aid to template users, certain checks are made to verify that the necessary parameters have been entered. (The actual references are not checked for whether they correctly support the peak position claimed or even if the link is functional, but some parameter entries are checked for appropriateness.) When a check determines that a required parameter is missing, an error message is generated in red. For example, if you forget the week or year value for the Hungary chart, the result in the article will look like:

Hongaria (Rádiós Top 40)YEAR DAN WEEK WAJIB DIMASUKKAN UNTUK HUNGARIAN CHARTS	19

This is an (additional) incentive to preview the article page before saving your edits. Check the charts table as well as the references section for (typically red) error messages.

Support

The large number of charts published by Billboard allows for some uniformity in how one accesses their information. However, the other charts and archives used as references on Wikipedia, produced by a multitude of publishers, call for a varied approach when looking up chart positions. Below are two tables, the first for non-Billboard charts, the second for Billboard charts, currently supported by the {{singlechart}} template. The parameters necessary to generate reference citations are shown in both tables for each supported chart.

Non-Billboard charts

Chart ID	Actual chart name	Website used as archive	Required parameters	Notes
Australia Australian	ARIA	www.australian-charts.com	artist song
Australiapandora	ARIA	pandora.nla.gov.au	url urltitle artist*	This forces the use of the National Library of Australia archive for an Australian chart position. This is the only method of retrieving archived positions above 50.
Australiaurban	ARIA	pandora.nla.gov.au	url urltitle artist*	This forces the use of the National Library of Australia archive for an Australian chart position. This is the only archive for the Australian Urban chart.
Austria Austrian	Ö3 Austria Top 40	www.austriancharts.at	artist song
Belgium (Wallonia) Wallonia	Ultratop 50	www.ultratop.be	artist song	Adding "Tip" after chart name (e.g., "Wallonia Tip") forces Ultratip reference.
Belgium (Flanders) Flanders	Ultratop 50	www.ultratop.be	artist song	Adding "Tip" after chart name forces Ultratip reference.
Bulgaria Bulgarian	IFPI at bamp-br.org	www.bamp-br.org	url urltitle artist*	The url parameter is validated to point at bamp-br.org. The urltitle parameter should match the title from the page at that url. Unfortunately, the Bulgarian chart cannot be indexed automatically.
Canadaadultcontemporary	RPM Adult Contemporary Tracks	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadacountry	RPM Country Tracks	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadatopsingles	RPM Top Singles	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Czech Republic	ČNS IFPI (Rádio Top 100)	www.ifpicr.cz	year week artist*	Year and week indicate the referenced chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09. A comment is generated in the reference to show what should be entered in the search table to produce the correct chart. Note that database includes only data since January 2006, thus data for songs released prior to January 2006 are incomplete.
Czechdigital	ČNS IFPI (Singles Digitál Top 100)	www.ifpicr.cz	year week artist*
Danish Denmark	Hitlisten	www.danishcharts.com	artist song	When year and week are not present, this form (requiring artist and song) will provide a reference pointing to www.danishcharts.com, which may vary from official positions for older songs. Avoid using this form for chart positions before November 2007.
Danish Denmark	Hitlisten	www.hitlisten.nu	artist song week year	Official Danish single charts (including prior to November 2007).
Denmark 2007	Hitlisten	www.hitlisten.nu	artist song week year	Official Danish single charts (including prior to November 2007).
Danish Airplay Denmark Airplay	Hitlisten	www.hitlisten.nu	artist song week year	Official Danish airplay Top 20 charts.
Dutch100	Mega Single Top 100	www.dutchcharts.nl	artist song	Note that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.
Dutch40	Dutch Top 40	www.top40.nl	artist song	When year and week are not present, this form (requiring artist and song) will provide a reference pointing to a search results page without positions. Note that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.
Dutch40	Dutch Top 40	www.top40.nl	year week artist*	Year and week indicate the referenced chart. Week is a number from 1 to 53, without a leading 0 for weeks 1-9. Note that the table row for this Chart ID will expand as "Netherlands" and may appear incorrectly placed if you position it under "D" in an alphabetically sorted table.
Finnish Finland	Suomen virallinen lista	www.ifpi.fi	artist song
Finnishdownload latauslista	Suomen virallinen latauslista	www.ifpi.fi	artist	Non-Finnish artists: If the release has charted on the comprehensive chart above, this chart is to be omitted. Finnish artists: If the release has charted on the comprehensive chart (above) and not abroad, this chart can be added.
Finnishairplay radiosoittolista	Suomen virallinen radiosoittolista	www.ifpi.fi	artist	Non-Finnish artists: If the release has charted on the comprehensive chart above (Finnish/Finland), this chart is to be omitted. Finnish artists: If the release has charted on the comprehensive chart above (Finnish/Finland) and not abroad, this chart can be added.
French France	SNEP	www.lescharts.com	artist song
Frenchdigital	SNEP	www.lescharts.com	artist song date	This forces a reference to the download chart, which is not returned in the summary results. date is an 8 digit number, YYYYMMDD
German Germany	Media Control Charts	www.musicline.de	artist song	For artist use Last,First format. For song sometimes an unexpected naming is required, e.g., "Bad Romance (2-track)" instead of simply "Bad Romance".
Germany2	Media Control Charts	www.charts.de	artist song
Hungary Hungarian	Mahasz (Rádiós Top 40)	www.mahasz.hu	artist song year week	This is the main, fully indexable Top 40 Radio airplay chart. A link is generated to the individual chart.
Hungarytop10	Mahasz (Single Top 10)	www.mahasz.hu	artist song year week	A link is generated to the individual chart.
Hungarydance	Mahasz (Dance Top 40)	www.mahasz.hu	artist song year week	A link is generated to the individual chart.
Ireland Irish	IRMA	www.chart-track.co.uk	year week artist*	Allowable values for week range from 1 to 53. Single-digit values do not need to be preceded with a 0.
Ireland2	IRMA	irishcharts.ie/	artist or song	If the song parameter is present, it provides a reference pointing to search results for the song, otherwise, it provides a url including search results for the specified artists.
Italian Italy	FIMI	www.italiancharts.com	artist song
New Zealand	Recorded Music NZ	www.charts.org.nz	artist song
Norway	VG-lista	www.lista.vg.no/	artist song week year	When year and week are present, this form will provide a reference pointing to lista.vg.no/.
Poland	Polish Music Charts	www.zpav.pl	chartid year
Polishdance	Polish Dance Chart	www.zpav.pl	chartid
Scotland	Official Charts Company	www.officialchartcompany.com	date artist song	Date is formatted yyyy-mm-dd
Slovakia Slovakian	ČNS IFPI (Rádio Top 100)	www.ifpicr.cz	year week artist*	Year and week indicate the referenced chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09. A comment is generated in the reference to show what should be entered in the search table to produce the correct chart.
Slovakdigital	ČNS IFPI (Singles Digitál Top 50)	www.ifpicr.cz	year week artist*
Spain Spanish	PROMUSICAE	www.spanishcharts.com	artist song
Sweden Swedish	Sverigetopplistan	www.swedishcharts.com	artist song
Swiss Switzerland	Schweizer Hitparade	www.swisscharts.com	artist song
UK United Kingdom	Official Charts Company Main singles chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd. This template only supports positions 1-40. For positions 41-75, UKsinglesbyname should be used. There are no reliable archived sources for positions beyond 75.
UKsinglesbyname UKchartstats UKchartarchive	Official Charts Company Main singles chart	www.officialcharts.com	artist song songid	This accesses the artist information page on officialcharts.com. Due to the format of officialcharts.com, this can only support positions 1-75. The UKchartstats and UKchartarchive values will bring up this same information, as UKchartstats.com no longer publishes chart data due to licensing issues. Ukchartstats and UKchartarchive should no longer be used.
UKdance	Official Charts Company Dance singles chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
UKdownload	Official Charts Company Download chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
UKindependent UKindie	Official Charts Company Independent singles chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
UKrandb	Official Charts Company R&B chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
Other non-Billboard charts are not currently supported by `{{singlechart}}` and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts. * These charts require the artist parameter solely for the purposes of internal reference naming using the default format (see Output above). If you are using the refname parameter to override the default naming, or you are sure that the references are not being reused in the article, you omit artist for the marked charts. The use of song and title are recommended for all charts, however.

Billboard charts

Billboard charts all require the artist name.

Chart ID	Actual chart name	Website used as archive	Required parameters
Billboardcanadianhot100 Canada	Canadian Hot 100	www.billboard.com	artist
Billboardcanadaac	Canada AC	www.billboard.com	artist
Billboardcanadachrtop40	Canada CHR/Top 40	www.billboard.com	artist
Billboardcanadacountry	Canada Country	www.billboard.com	artist
Billboardcanadahotac	Canada Hot AC	www.billboard.com	artist
Billboardcanadarock	Canada Rock	www.billboard.com	artist
Billboardeurodigital	Euro Digital Songs	www.billboard.com	artist
Billboardeuropeanhot100	European Hot 100 Singles	www.billboard.com	artist
Billboardjapanhot100	Japan Hot 100	www.billboard.com	artist
Luxembourgdigitalsongs	Luxembourg Digital Songs	www.billboard.com	artist
Portugaldigitalsongs	Portugal Digital Songs	www.billboard.com	artist
Billboardhot100	Billboard Hot 100	www.billboard.com	artist
Billboardbubbling100	Bubbling Under Hot 100 Singles	www.billboard.com	artist
Billboarddigitalsongs	Digital Songs	www.billboard.com	artist
Billboardradiosongs	Radio Songs	www.billboard.com	artist
Billboardchristiansongs	Hot Christian Songs	www.billboard.com	artist
Billboardcountrysongs	Hot Country Songs	www.billboard.com	artist
Billboarddanceelectronic	Hot Dance/Electronic Songs	www.billboard.com	artist
Billboardlatinsongs	Hot Latin Songs	www.billboard.com	artist
Billboardrandbhiphop	Hot R&B/Hip-Hop Songs	www.billboard.com	artist
Billboardrapsongs	Hot Rap Songs	www.billboard.com	artist
Billboardrocksongs	Hot Rock Songs	www.billboard.com	artist
Billboardadultalternativesongs	Adult Alternative Songs	www.billboard.com	artist
Billboardadultcontemporary	Adult Contemporary	www.billboard.com	artist
Billboardadultrandbsongs	Adult R&B Songs	www.billboard.com	artist
Billboardadultpopsongs	Adult Top 40	www.billboard.com	artist
Billboardalternativesongs	Alternative Songs	www.billboard.com	artist
Billboardchristianairplay	Christian Airplay	www.billboard.com	artist
Billboardcountryairplay	Country Airplay	www.billboard.com	artist
Billboarddanceclubplay	Dance Club Songs	www.billboard.com	artist
Billboarddanceairplay	Dance/Mix Show Airplay	www.billboard.com	artist
Billboardlatinairplay	Latin Airplay	www.billboard.com	artist
Billboardlatinpopsongs	Latin Pop Songs	www.billboard.com	artist
Billboardmainstreamrock	Mainstream Rock	www.billboard.com	artist
Billboardpopsongs	Mainstream Top 40	www.billboard.com	artist
Billboardrandbhiphopairplay	R&B/Hip-Hop Airplay	www.billboard.com	artist
Billboardregionalmexican	Regional Mexican Airplay	www.billboard.com	artist
Billboardrhythmic	Rhythmic	www.billboard.com	artist
Billboardrockairplay	Rock Airplay	www.billboard.com	artist
Billboardsmoothjazzsongs	Smooth Jazz Songs	www.billboard.com	artist
Billboardlatintropical	Tropical Songs	www.billboard.com	artist
Other Billboard charts are not currently supported by `{{singlechart}}` and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts.

Examples with table layout

Example with dummy data

Since this template produces only individual rows within a table, you will need to add (or already have) the table's framework in the article. Here is a sample table with its corresponding output:

{| class="wikitable sortable"
|-
! Chart
! Peak position
|-
| row 1, cell 1
| row 1, cell 2
|-
| row 2, cell 1
| row 2, cell 2
|-
 {{singlechart|Australia|6|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|note=Happy Meal edition}}
|-
 {{singlechart|Belgium (Wallonia)|4|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band}}
|}

expands into:

Chart	Peak position
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2
Australia (ARIA)^[1] Happy Meal edition	6
Belgium (Ultratop 50 Wallonia)^[2]	4

^ "Australian-charts.com – Bonzo Dog Doo Dah Band – I'm the Urban Spaceman". ARIA Top 50 Singles.
^ "Ultratop.be – Bonzo Dog Doo Dah Band – I'm the Urban Spaceman" (dalam bahasa Prancis). Ultratop 50.

Example with realistic data

This example is excerpted from actual usage at Doesn't Mean Anything, with a couple of minor additions.

{|class="wikitable sortable"
|-
!Chart (2009)
!Peak<br />position
|-
{{singlechart|Australia|96|artist=Alicia Keys|song=Doesn't Mean Anything}}
|-
{{singlechart|Billboardcanadianhot100|66|artist=Alicia Keys}}
|-
{{singlechart|Czech Republic|31|artist=Alicia Keys|song=Doesn't Mean Anything|year=2010|week=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|artist=Alicia Keys}}
|-
{{singlechart|Germany|8|artist=Keys,Alicia|song=Doesn't Mean Anything|note=Angela Merkel rap edition}}
|-
{{singlechart|Billboardjapanhot100|3|artist=Alicia Keys}}
|-
{{singlechart|Dutch100|43|artist=Alicia Keys|song=Doesn't Mean Anything|accessdate=2010-02-28}}
|-
{{singlechart|New Zealand|22|artist=Alicia Keys|song=Doesn't Mean Anything}}
|-
{{singlechart|Slovakia|31|artist=Alicia Keys|song=Doesn't Mean Anything|week=52|year=2009}}
|-
{{singlechart|UKchartstats|8|artist=Alicia Keys|song=Doesn't Mean Anything|songid=34669}}
|-
{{singlechart|Billboardhot100|60|artist=Alicia Keys}}
|-
{{singlechart|Billboardrandbhiphop|14|artist=Alicia Keys}}
|}

<references />

expands into:

Chart (2009)	Peak position
Australia (ARIA)^[1]	96
Kanada (Canadian Hot 100)^[2]	66
Republik Ceko (Rádio Top 100)^[3]	31
European Hot 100 Singles (Billboard)^[4]	10
Jerman (Official German Charts)^[5] Angela Merkel rap edition	8
Jepang (Japan Hot 100)^[6]	3
Belanda (Single Top 100)^[7]	43
Selandia Baru (Recorded Music NZ)^[8]	22
Slowakia (Rádio Top 100)^[9]	31
UK Singles (Official Charts Company)^[10]	8
US Billboard Hot 100^[11]	60
US Hot R&B/Hip-Hop Songs (Billboard)^[12]	14

^ "Australian-charts.com – Alicia Keys – Doesn't Mean Anything". ARIA Top 50 Singles.
^ "Alicia Keys Chart History (Canadian Hot 100)". Billboard.
^ "ČNS IFPI" (dalam bahasa Ceska). Hitparáda – Radio Top 100 Oficiální. IFPI Republik Ceko. Catatan: Ubah tangga musik ke CZ – RADIO – TOP 100 dan masukkan 201001 dalam pencarian.
^ "Alicia Keys – Chart Search" Billboard European Hot 100 Singles for Alicia Keys. (perlu berlangganan)
^ "Musicline.de – Keys,Alicia Single-Chartverfolgung" (dalam bahasa Jerman). Media Control Charts. PhonoNet GmbH.
^ "Alicia Keys Chart History (Japan Hot 100)". Billboard.
^ "Dutchcharts.nl – Alicia Keys – Doesn't Mean Anything" (dalam bahasa Belanda). Single Top 100. Diakses tanggal 2010-02-28.
^ "Charts.nz – Alicia Keys – Doesn't Mean Anything". Top 40 Singles.
^ "ČNS IFPI" (dalam bahasa Slowakia). Hitparáda – Radio Top 100 Oficiálna. IFPI Republik Ceko. Catatan: Masukkan 200952 dalam pencarian.
^ "Alicia Keys: Artist Chart History". Official Charts Company.
^ "Alicia Keys Chart History (Hot 100)". Billboard.
^ "Alicia Keys Chart History (Hot R&B/Hip-Hop Songs)". Billboard.

Maintenance categories

To help maintain music articles, this template will automatically categorize articles that call it based on the parameters used in the reference.

Singlechart used with missing parameters

Templat:Category contains a list of articles that have failed error checking because of missing parameters.

Singlechart usages for chartname

This set of categories lists the calls for each possible chart name, i.e. Templat:Category contains all articles that have used the template to build a reference for the Billboard Hot 100. Note that alternate names are not handled gracefully: Templat:Category and Templat:Category are separate categories.

Template data

Creates a table row for a recognized single chart

Parameter templat[Kelola data templat]
Parameter		Keterangan	Jenis	Status
Chart identifier	`1`	Chart name: recognized values are listed at Template:Singlechart/doc	Kata	wajib diisi
Chart position	`2`	peak position on the chart	Angka	wajib diisi
artist	`artist`	artist name as listed on the source chart	Kata	wajib diisi
song	`song`	song title as listed on the source chart	Kata	wajib diisi
reference name	`refname`	Names the reference created by the template so that it may be used other places in the article	Kata	wajib diisi
Notes	`chartnote`	Any special notes about this version here. Typically used to distinguish versions , i.e. 'reggae mix' vs. 'dubsteb version'	Kata	opsional
year	`year`	year chart position occurred, required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay	Angka	opsional
week	`week`	week number (1-53) required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay	Angka	opsional
URL	`url`	required for Bulgarian charts (must be from www.bamp-bg.org) and for Australiapandora (must be from pandora.nla.gov.au)	Angka	opsional
date	`date`	date of chart. Required for Frenchdigital (format yyyymmdd with no spaces) or any UK chart (format yyyy-mm-dd )	Angka	opsional
access date	`accessdate`	Free format date showing when this information was verified	Kata	opsional
Row header control	`rowheader`	when set to true, the chart name will be treated as a row header	Kata	opsional

Lihat pula

{{Albumchart}} – counterpart of Singlechart but for chart positions for music album releases.

Templat ini menggunakan fitur sintaks templat yang rumit.

Anda seharusnya sudah memahami penyetelan dan fungsi parser sebelum menyunting templat ini. Jika suntingan Anda menyebabkan permasalahan yang tidak diinginkan, mohon untuk membaliknya secepatnya, karena templat ini mungkin muncul pada sejumlah besar halaman.
Ingat bahwa semua percobaan dan perbaikan harus diuji terlebih dahulu di atau di ruang pengguna Anda sebelum mengubah sesuatu di sini.

Dokumentasi di atas ditransklusikan dari Templat:Single chart/doc.
Penyunting dapat melakukan uji coba pada halaman bak pasir dan kasus uji templat ini.
Mohon tambahkan kategori pada subhalaman /doc. Subhalaman templat ini.

[sc_Australia_Shakira-1] "Australian-charts.com – Shakira – She Wolf". ARIA Top 50 Singles.

[sc_Billboardcanadianhot100_Shakira-2] "Shakira Chart History (Canadian Hot 100)". Billboard.

[sc_Frenchdigital_Shakira-3] "Templat:Digits lescharts.com – Français" (dalam bahasa Prancis). Les classement de telechargement single.

[sc_Italy_Shakira-4] "Italiancharts.com – Shakira – Loba". Top Digital Download. Kesalahan pengutipan: Tanda <ref> tidak sah; nama "sc_Italy_Shakira" didefinisikan berulang dengan isi berbeda

[sc_Flanders_Shakira-5] "Ultratop.be – Shakira – She Wolf" (dalam bahasa Belanda). Ultratop 50.

[sc_Wallonia_Shakira-6] "Ultratop.be – Shakira – She Wolf" (dalam bahasa Prancis). Ultratop 50.

[7] "Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2

[sc_Hungary_-8] "Archívum – Slágerlisták – MAHASZ" (dalam bahasa Hongaria). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.

[sc_Ireland_-9] "Chart Track: Week 40, 2009". Irish Singles Chart.

[sc_Billboardjapanhot100_Shakira-10] "Shakira Chart History (Japan Hot 100)". Billboard.

[sc_Poland_-11] "Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Airplay Top 100.

[sc_UKchartstats_Shakira-12] "Shakira: Artist Chart History". Official Charts Company.

[sc_Australia_Bonzo_Dog_Doo_Dah_Band-13] "Australian-charts.com – Bonzo Dog Doo Dah Band – I'm the Urban Spaceman". ARIA Top 50 Singles.

[sc_Belgium_(Wallonia)_Bonzo_Dog_Doo_Dah_Band-14] "Ultratop.be – Bonzo Dog Doo Dah Band – I'm the Urban Spaceman" (dalam bahasa Prancis). Ultratop 50.

[sc_Australia_Alicia_Keys-15] "Australian-charts.com – Alicia Keys – Doesn't Mean Anything". ARIA Top 50 Singles.

[sc_Billboardcanadianhot100_Alicia_Keys-16] "Alicia Keys Chart History (Canadian Hot 100)". Billboard.

[sc_Czech_Republic_Alicia_Keys-17] "ČNS IFPI" (dalam bahasa Ceska). Hitparáda – Radio Top 100 Oficiální. IFPI Republik Ceko. Catatan: Ubah tangga musik ke CZ – RADIO – TOP 100 dan masukkan 201001 dalam pencarian.

[sc_Billboardeuropeanhot100_Alicia_Keys_-18] "Alicia Keys – Chart Search" Billboard European Hot 100 Singles for Alicia Keys. (perlu berlangganan)

[sc_Germany_Keys,Alicia-19] "Musicline.de – Keys,Alicia Single-Chartverfolgung" (dalam bahasa Jerman). Media Control Charts. PhonoNet GmbH.

[sc_Billboardjapanhot100_Alicia_Keys-20] "Alicia Keys Chart History (Japan Hot 100)". Billboard.

[sc_Dutch100_Alicia_Keys-21] "Dutchcharts.nl – Alicia Keys – Doesn't Mean Anything" (dalam bahasa Belanda). Single Top 100. Diakses tanggal 2010-02-28.

[sc_New_Zealand_Alicia_Keys-22] "Charts.nz – Alicia Keys – Doesn't Mean Anything". Top 40 Singles.

[sc_Slovakia_Alicia_Keys-23] "ČNS IFPI" (dalam bahasa Slowakia). Hitparáda – Radio Top 100 Oficiálna. IFPI Republik Ceko. Catatan: Masukkan 200952 dalam pencarian.

[sc_UKchartstats_Alicia_Keys-24] "Alicia Keys: Artist Chart History". Official Charts Company.

[sc_Billboardhot100_Alicia_Keys-25] "Alicia Keys Chart History (Hot 100)". Billboard.

[sc_Billboardrandbhiphop_Alicia_Keys-26] "Alicia Keys Chart History (Hot R&B/Hip-Hop Songs)". Billboard.

[1]

[1]

[1]

[1]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[1]

[2]

[1]

[2]

[3]

[4]

[5]

[6]

[7]

[8]

[9]

[10]

[11]

[12]