الگو:Single chart

از ویکی‌پدیا، دانشنامهٔ آزاد
توضیحات الگو[نمایش] [ویرایش] [تاریخچه] [پاکسازی]

نکته: به این دلیل که این الگو برای ساخت یک «جدول ویکی» به‌کار می‌رود، در مستندات الگو، به‌جای استفاده از واژهٔ درست «جدول موسیقی» که برابر با Record chart است، از واژهٔ «چارت موسیقی» استفاده شده تا منظور از «جدول» برای کاربر قابل درک باشد.

این الگو برای ارجاع به منابع در ویکی‌پدیا استفاده می‌شود و به‌طور ویژه و احتصاصی برای انتشارهای تکی موسیقی ضبط‌شده (تک‌آهنگ) طراحی شده‌است. الگوی مشابه دیگری که در زمان ارجاع به منابع برای آلبوم‌های موسیقی به‌کار می‌رود را می‌توانید در الگو:Album chart بیابید؛ این الگوها هنوز برای پشتیبانی از آلبوم‌های چندآهنگه و سایر شیوه‌های انتشار آثار موسیقایی توسعه نیافته‌اند.

به‌طور کلی، این الگو یک سطر جدول شامل اطلاعاتی در خصوص کشور، چارت موسیقی، منبع و بالاترین جایگاه یک تک‌آهنگ در چارت موسیقی مشخص‌شده ایجاد می‌کند. جدول‌هایی که دربردارندهٔ چنین اطلاعاتی هستند، معمولاً در مقاله‌هایی با موضوع یک تک‌آهنگ، یک آلبوم، ترانه‌شناسی یک هنرمند و مقاله‌های مربوط به خود هنرمندان به‌کار می‌روند.

این الگو هیچ‌گونه جایگاه یا حضوری در چارت‌های موسیقی را بررسی نمی‌کند. این الگو به‌طور کلی نشانی اینترنتی منبعی را ارائه می‌دهد که با یک منبع معتبر برای چارت موسیقی مشخص‌شده، مرتبط است. درستی پیوند ارجاع نیز به‌خودی خود توسط الگو بررسی نمی‌شود. برای مثال، وارد کردن نام اشتباه یا جایگزین عنوان یک ترانه می‌تواند به ایجاد یک پیوند خراب منجر شود. لازم است که ویرایشگران، پیوندهای ایجادشده توسط این الگو را دنبال کنند و کاربردی و سالم بودن آن را مورد بررسی قرار دهند و پس از اتمام بررسی و رفع اشکالات احتمالی، ویرایش‌های خود را منتشر کنند.

استفاده[ویرایش]

این الگو داده‌های مناسبی را برای قرار گرفتن در داخل یک جدول چارت‌های موسیقی، شامل نام چارت موسیقی همراه با ارجاع و جایگاه ترانه در آن چارت را تولید می‌کند. محتوای ایجادشده توسط این الگو را می‌توان به‌عنوان بخشی از یک جدول بزرگ‌تر استفاده کرد و همچنین می‌توان با ایجاد مجموعه‌ای از فراخوانی‌ها، یک جدول کامل ایجاد کرد. این الگو، نشان‌گذاری‌های لازم برای ساخت جدول بزرگ‌تر دربرگیرنده را ایجاد نمی‌کند.

نام تمامی فیلدها باید با حروف کوچک نوشته‌شود.

می‌توانید یک نسخهٔ خالی از الگو را برای استفاده کپی کنید. استفاده از نویسهٔ "|" (لوله) بین هر فیلد را فراموش نکنید. به‌منظور جلوگیری از ایجاد درهم‌ریختگی در پنجرهٔ ویرایش، لطفاً فیلدهای استفاده‌نشده را حذف کنید.

نحو کلی الگو به‌شکل زیر است:

نسخه کامل (متن زیر را به صفحهٔ مورد نظر خود کپی کنید و پارامترهایی که لازمشان ندارید را حذف کنید)
{{singlechart |(شناسهٔ چارت) |(بالاترین جایگاه) |song= |songid= |artist= |artistid= |chartid= |url= |urltitle= |date= |year= |week= |note= |publishdate= |accessdate= |refname= |refgroup= |rowheader=}}

استفادهٔ همیشگی از پارامترهای «song=» و «artist=»، حتی در مواردی از کاربرد این الگو که به‌کار بردن این پارامترها در آن الزامی نیست، ایدهٔ خوبی است. این کار، ویرایش محتوای الگو در صورت اعمال تغییر در بایگانی‌های ارجاع‌شده توسط الگو در آینده را تسهیل می‌کند. علاوه بر این، پارامتر هنرمند به‌طور پیش‌فرض برای نام‌گذاری ارجاع و استفادهٔ مجدد آن در جای دیگری از مقاله به‌کار می‌رود.

مقدار پیش‌فرض rowheader برابر با false است. اگر آن را روی true تنظیم کنید، نام چارت به‌عنوان سرجعبه و مطابق با آنچه در ویکی‌پدیا:شیوه‌نامه/دسترسی‌پذیری#جدول آمده، تولید می‌شود.

پارامترها[ویرایش]

استفاده از پارامترهای publishdate، accessdate پ refname اختیاری است. الزامی‌بودن یا نبودن سایر پارامترها بستگی به چارتی دارد که در حال ارجاع به آن هستید. جدول‌های درج‌شده در بخش پشتیبانی در پایین این صفحه را ببینید.

  • (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: Numeric identifier used by some chart listings (see Billboard charts). Determined by performing a search at the chart listings' website for the artist (or single or album, then following a link through to the performer's page). The artistid can be found in the Web address (URL) by inspection. For example, the page for Eric Clapton at www.billboard.com has the URL http://www.billboard.com/#/artist/eric-clapton/50403, so the artistid to use is 50403.
  • 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 ویکی‌پدیا:پانویس‌ها 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:

  • a row of output for a two-cell table row, and
  • a reference

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).

Brief examples of output with different parameters[ویرایش]

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.

Example no. Coding (assumed inside a table row) Output (assumed with <references/> added)
Example 1
{{singlechart
  |Australia
  |18
  |artist=Shakira
  |song=She Wolf}}
Illegal chart entered Australia|18


Example 2
 {{singlechart
  |Billboardcanadianhot100
  |5
  |artist=Shakira
  |artistid=147604}}
Illegal chart entered Billboardcanadianhot100|5


Example 3
 {{singlechart
  |Frenchdigital
  |4
  |artist=Shakira
  |song=She Wolf
  |date=20091017}}
Illegal chart entered Frenchdigital|4


Example 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)}}
Illegal chart entered Italy|3 Illegal chart entered Italy|11


Example 5
{| class="wikitable sortable" border="1"
|-
! Chart (2009)
! Peak<br />position
|-
{{singlechart |Flanders|16
  |artist=Shakira |song=She Wolf}}
|-
{{singlechart |Wallonia|5
  |artist=Shakira |song=She Wolf}}
|-
|[[Billboard Brazil|
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 |artistid=147604}}
|-
{{singlechart |UKchartstats|4
  |artist=Shakira|song=She Wolf|songid=34525}}
|}
Illegal chart entered Flanders|16 Illegal chart entered Wallonia|5 Illegal chart entered Ireland|2
Chart (2009) Peak
position
Brazil Billboard Hot 100 Airplay[۱] 1
مجارستان (Rádiós Top 40)[۲] 5
Poland (Polish Airplay Top 100)[۳] 2
Japan (Japan Hot 100)[۴] 9
UK Singles (Official Charts Company)[۵] 4
  1. "Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2
  2. "Archívum – Slágerlisták – MAHASZ" (in Hungarian). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.
  3. "Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video". Polish Airplay Top 100.
  4. "Shakira Chart History (Japan Hot 100)". Billboard.
  5. "Shakira: Artist Chart History". شرکت جدول‌های رسمی.

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:

مجارستان (Rádiós Top 40)YEAR AND WEEK MANDATORY FIELDS FOR 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 (magazine) 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
Australian Recording Industry Association www.australian-charts.com artist
song
Australiapandora Australian Recording Industry Association 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 Australian Recording Industry Association 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
آلتراتاپ ۴۰ www.ultratop.be artist
song
Adding "Tip" after chart name (e.g., "Wallonia Tip") forces Ultratip reference.
Belgium (Flanders)
Belgium (Vlanders)
Flanders
Vlanders
آلتراتاپ ۵۰ www.ultratop.be artist
song
Adding "Tip" after chart name forces Ultratip reference.
Bulgaria
Bulgarian
International Federation of the Phonographic Industry 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.
Czech Republic International Federation of the Phonographic Industry at www.ifpicr.cz 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.
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.
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.
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
Musiikkituottajat – IFPI Finland www.finnishcharts.com artist
song
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
GfK Entertainment 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 GfK Entertainment 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
Irish Recorded Music Association 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.
Italian
Italy
FIMI www.italiancharts.com artist
song
New Zealand Recorded Music NZ www.charts.org.nz artist
song
Norwegian
Norway
VG-lista www.norwegiancharts.com artist
song
When year and week are not present, this form (requiring artist and song) will provide a reference pointing to www.norwegiancharts.com.
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
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
International Federation of the Phonographic Industry at www.ifpicr.cz 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.
Spain
Spanish
PROMUSICAE www.spanishcharts.com artist
song
Sweden
Swedish
Sverigetopplistan www.swedishcharts.com artist
song
Swiss
Switzerland
Swiss Hitparade www.swisscharts.com artist
song
UK
United Kingdom
Official Charts Company
Main singles chart
www.theofficialcharts.com date
artist
song
Date is formatted yyyy-mm-dd. Due to technical limitations of URL formatting in Wikimedia, the "artist search" facility is not used, and a direct link to the chart is provided. This means that only positions 1-40 can be referenced with this template. For positions 41-100, UKchartstats should be used. This limitation is expected to be removed during 2010.
UKchartstats
UKchartarchive
The Official Charts Company
Main singles chart
www.chartstats.com
www.chartarchive.org
artist
song
songid
Different archives archive different ranges. For positions 41-100, this archive is generally recommended.
UKdance The Official Charts Company
Dance singles chart
www.theofficialcharts.com date
artist
song
Date is formatted yyyy-mm-dd
UKdownload The Official Charts Company
Download chart
www.theofficialcharts.com date
artist
song
Date is formatted yyyy-mm-dd
UKindependent
UKindie
The Official Charts Company
Independent singles chart
www.theofficialcharts.com date
artist
song
Date is formatted yyyy-mm-dd
UKrandb The Official Charts Company
R&B chart
www.theofficialcharts.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 and an id number. This can be found by looking up the artist on www.billboard.com. For example, searching for Katy Perry on www.billboard.com will lead to http://www.billboard.com/#/artist/katy-perry/958673 . 958673 is the id number for Katy Perry. This is passed through the artistid parameter. For example,

  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid=958673}} is the syntax for citing a number 1 position on the Billboard Hot 100 for Katy Perry.
  • Also, the artist id can sometimes retrieved using the {{BillboardID}} template which, given the artist name, returns the id number without searching the website. With this template, instead of writing:
  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid=958673}}
We write:
  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid={{BillboardID|Katy Perry}}}}
And the template returns the correct id, avoiding errors when writing the number. {{BillboardID}} is fairly incomplete at this time; be sure to check if the template supports the artist before using it.
Chart ID Actual chart name Website used as archive Required parameters Notes
Billboardcanadianhot100
Canada
Canadian Hot 100 www.billboard.com artist
artistid
Billboardeuropeanhot100 European Hot 100 Singles www.billboard.com artist
artistid
Billboardjapanhot100 Japan Hot 100 www.billboard.com artist
artistid
Billboardadultcontemporary Adult Contemporary www.billboard.com artist
artistid
Billboardalternativesongs Alternative Songs www.billboard.com artist
artistid
Billboardhot100 Billboard Hot 100 www.billboard.com artist
artistid
Billboardadultpopsongs Adult Top 40 www.billboard.com artist
artistid
Billboardcountrysongs Hot Country Songs www.billboard.com artist
artistid
Billboarddanceclubplay Hot Dance Club Songs www.billboard.com artist
artistid
Billboarddigitalsongs Hot Digital Songs www.billboard.com artist
artistid
Billboardlatinpopsongs Latin Pop Airplay www.billboard.com artist
artistid
Billboardregionalmexican Latin Regional Mexican Airplay www.billboard.com artist
artistid
Billboardlatintropical
Billboardtropicalsongs
Latin Tropical Airplay www.billboard.com artist
artistid
Charts prior to August 2009 are not available on the website. Use AllMusic instead.
Billboardlatinsongs Hot Latin Songs www.billboard.com artist
artistid
Billboardpopsongs Mainstream Top 40 (Pop Songs) www.billboard.com artist
artistid
Billboardrandbhiphop Hot R&B/Hip-Hop Songs www.billboard.com artist
artistid
Billboardradiosongs Hot 100 Airplay (Radio Songs) www.billboard.com artist
artistid
Billboardrapsongs Rap Songs www.billboard.com artist
artistid
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" border="1"
|-
! 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}}
|}

<references/>

expands into:

Illegal chart entered Australia|6 Illegal chart entered Belgium (Wallonia)|4
Chart Peak position
row 1, cell 1 row 1, cell 2
row 2, cell 1 row 2, cell 2


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" border="1"
|-
!Chart (2009)
!Peak<br />position
|-
{{singlechart|Australia|96|artist=Alicia Keys|song=Doesn't Mean Anything}}
|-
{{singlechart|Billboardcanadianhot100|66|artist=Alicia Keys|artistid=433721}}
|-
{{singlechart|Czech Republic|31|artist=Alicia Keys|song=Doesn't Mean Anything|year=2010|week=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|artist=Alicia Keys|artistid=433721}}
|-
{{singlechart|Germany|8|artist=Keys,Alicia|song=Doesn't Mean Anything|note=Angela Merkel rap edition}}
|-
{{singlechart|Billboardjapanhot100|3|artist=Alicia Keys|artistid=433721}}
|-
{{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|artistid=433721}}
|-
{{singlechart|Billboardrandbhiphop|14|artist=Alicia Keys|artistid=433721}}
|}

<references/>

expands into:

Illegal chart entered Australia|96 Illegal chart entered Billboardcanadianhot100|66 Illegal chart entered Germany|8 Illegal chart entered New Zealand|22 Illegal chart entered Slovakia|31 Illegal chart entered Billboardhot100|60
Chart (2009) Peak
position
Czech Republic (Rádio Top 100)[۱] 31
European Hot 100 Singles (Billboard)[۲] 10
Japan (Japan Hot 100)[۳] 3
هلند (۱۰۰ تک‌آهنگ برتر)[۴] 43
UK Singles (Official Charts Company)[۵] 8
US آهنگ‌های داغ آراندبی/هیپ-هاپ (Billboard)[۶] 14
  1. "ČNS IFPI" (in Czech). Hitparáda – Radio Top 100 Oficiální. IFPI Czech Republic. Note: Change the chart to CZ – RADIO – TOP 100 and insert 201001 into search.
  2. "Alicia Keys – Chart Search" Billboard European Hot 100 Singles for Alicia Keys. (نیازمند آبونمان)
  3. "Alicia Keys Chart History (Japan Hot 100)". Billboard.
  4. "Dutchcharts.nl – Alicia Keys – Doesn't Mean Anything" (به هلندی). ۱۰۰ تک‌آهنگ برتر هلند. Retrieved 2010-02-28.
  5. "Alicia Keys: Artist Chart History". شرکت جدول‌های رسمی.
  6. "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[ویرایش]

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. 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: and are separate categories.

See also[ویرایش]

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