Templat:Albumchart/doc

Ini adalah sebuah subhalaman dokumentasi untuk Templat:Albumchart.
Templat ini berisi informasi penggunaan, kategori dan konten lainnya yang bukan merupakan bagian dari templat halaman.

This template is used to cite sources in Wikipedia. It is specifically for albums. A similar template for use when citing sources for musical singles can be found at Templat:Singlechart; however, for EPs or other releases, it has not yet been developed.

In general, the template expands to produce a table row with the information country, record chart, reference, and peak position for the given album on the particular chart. Tables of such information are commonly used in Wikipedia articles on singles, albums, discographies and artists.

This template does not verify any positions or chart appearances. It primarily provides a reference URL believed to be associated with a reliable source for a recognised chart. The reference URL itself is also not checked. Entering an incorrect or alternative spelling of an album title can produce a bad link, for example. Individual editors will need to follow the URLs generated by the template to verify their usefulness before walking away from an edited article.

Usage

Following, the most common parameters used on the template:

{{albumchart|(Chart identifier)|(Peak position)|artist=|album=|refname=|accessdate=30 May 2012}}

Following, the parameters for any Billboard chart:

{{albumchart|Billboard(Specific identifier)|(Peak position)|artist=|artistid=|refname=|accessdate=30 May 2012}}

Following, the parameters for any UK chart (except for the main UK parameter, UKChartStats and UKZobble):

{{albumchart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|accessdate=30 May 2012}}

Manual referencing

If the following situations arise:

The album name contains special characters that the album= parameter doesn't handle correctly and returns an url error.
When the template will be used for year-end charts instead of weekly charts.
When the chart position is retrieved from a source other than the default by {{albumchart}} such as Billboard's Chart Beat or Allmusic (remember that all sources must be reliable).

Then a manual reference might be needed. When manual referencing is activated, the user must provide the url= and title=, and may additionally provide work=, page=, date=, location= and publisher=, just like on the {{cite news}} template, to add a different source than the commonly used by {{albumchart}}.

To activate manual referencing, write an "M" as the third parameter of the template, after the country name and chart position, as this:

{{Albumchart|Australia|1|M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.billboard.com/#/news/madonnas-mdna-tops-aria-charts-1584845.story|work=Billboard|publisher=Nielsen Business Media|location=United States|accessdate=9 June 2012}}

And it will show as this:

Charts	Peak position
Australian Albums (ARIA)^[1]	1

^ "Madonna's "MDNA" Tops ARIA Charts". Billboard. United States: Nielsen Business Media. Diakses tanggal 9 June 2012.

This mode can be used simultaneously with the normal mode of the template, without the need to change the refname parameter.

The manual referencing mode is not available for the Music DVD charts.

Fields

The parameters publishdate, accessdate, and refname are optional. Whether the other parameters are required or not depend on the chart being referenced. See the tables in the Support section below.

(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.
album: Title of the album. 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.
dvd: For Music DVDs, the title of the album. Some Music DVD charts need to be provided with this field instead of the album field to correctly work.
artist: Name of the album's performer. As for the album 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 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.
id: 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 an album, e.g., note=2-disc deluxe edition, or {{albumchart|Australia|1|album=Making Mirrors|artist=Gotye|note=2-disc deluxe edition}}.
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 ac_Chartid_artist) 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.

Supports

National charts

Chart ID	Output	Website used as archive	Req.	Notes
Argentina	Argentinian Albums (CAPIF)	adminlic.capif.org.ar	artist album date	date must be in the format: DD/MM/YYYY. Charts available from 7 February 2010 onwards. When manual referencing is activated, write the date always as DD/MM/YYYY, otherwise, the template may return an error.
Australia	Australian Albums (ARIA)	www.australian-charts.com	artist album
Austria	Austrian Albums (Ö3 Austria)	www.austriancharts.at	artist album
Flanders	Belgian Albums (Ultratop Flanders)	www.ultratop.be	artist album
Wallonia	Belgian Albums (Ultratop Wallonia)	www.ultratop.be	artist album
Brazil	Brazilian Albums (ABPD)	www.abpd.org.br	id	id is the last number(s) at the end of the URL. For example the id of http://www.abpd.org.br/noticias_internas.asp?noticia=168 is 168
Croatia	Croatian Foreign Albums (IFPI)	www.hdu-toplista.com	id	id is the last number(s) at the end of the URL. For example the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=881 is 881
Czech	Czech Albums (ČNS IFPI)	www.ifpicr.cz	artist album date	date exact date included on the chart page, e.g. YYYYMMDD. It usually appears at the right of the word "Týden".
Denmark	Danish Albums (Hitlisten)	www.danishcharts.com	artist album	Not recommended for charts prior to Nov. 2007; use instead Denmark2.
Denmark2	Danish Albums (Hitlisten)	www.hitlisten.nu	week year	For album charts prior to Nov. 2007, is better to use this Chart ID.
Finland	Finnish Albums (Suomen virallinen lista)	www.ifpi.fi	artist album
France	French Albums (SNEP)	www.lescharts.com	artist album
Germany	German Albums (Media Control)	www.musicline.de	artist album	As with Billboard charts, this url returns the complete album (longplay) chart history for the selected artist.
Germany2	German Albums (Media Control)	www.charts.de	year date	This website, instead of retrieving a complete chart history, it returns a weekly chart. The date parameter must be filled as this: YYYYMMDD. It contains chart info from 1978 onwards.
Germany3	German Albums (Media Control)	www.charts.de	artist album
GermanyComp	German Compilation Albums (Media Control)	www.charts.de	year date	This website, instead of retrieving a complete chart history, it returns a weekly chart. The date parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
Greece	Greek Albums (IFPI)	www.greekcharts.com	artist album	This website only contains chart information from 2010 to week 31/2011.
Hungary	Hungarian Albums (MAHASZ)	www.mahasz.hu	year week
Italy	Italian Albums (FIMI)	www.italiancharts.com	artist album
Ireland	Irish Albums (IRMA)	www.chart-track.co.uk	year week
Ireland2	Irish Albums (IRMA)	www.irishcharts.com	artist album
IrelandClassical	Irish Classical Albums (IRMA)	www.chart-track.co.uk	year week
Korea	Korean Albums (GAON)	www.gaonchart.co.kr	year date	Overall albums (national and foreign). The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the GAON page.
KoreaNat	Korean National Albums (GAON)	www.gaonchart.co.kr	year date	Only albums by Korean artists included here. The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the GAON page.
KoreaInt	Korean International Albums (GAON)	www.gaonchart.co.kr	year date	Only albums from foreign artists included here. The date must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from the GAON page.
Mexico	Mexican Albums (Top 100 Mexico)	www.mexicancharts.com	artist album	The site contains chart information until the week 49, 2011. After that date, no information is available. Information beyond that week must be added with the Mexico2 ChartID.
Mexico2	Mexican Albums (Top 100 Mexico)	www.amprofon.com.mx	artist album archiveurl archivedate	This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [1] with either WebCite or any other archiving method. Then, providing the parameters needed on the template. This might only be done if the peak position is beyond the week 49, 2011. All parameters are mandatory. Archiving the PDF file or finding the arhived url is highly recommended. On archiveurl the WebCite url must be written.
Netherlands	Dutch Albums (MegaCharts)	www.dutchcharts.nl	artist album
NetherlandsComp	Dutch Compilation Albums (MegaCharts)	www.dutchcharts.nl	artist album year date	For this ID, the date and year paramenters are mandatory. date must be in this format:YYYYMMDD.
New Zealand	New Zealand Albums (Recorded Music NZ)	www.charts.org.nz	artist album
Norway	Norwegian Albums (VG-lista)	www.norwegiancharts.com	artist album
Oricon	Japanese Albums (Oricon)	www.oricon.co.jp	date	This is the Oricon Top 50 Albums chart. It is in Japanese and the only parameter needed is the date. The date must follow this format: YYYY-MM-DD.
Poland	Polish Albums (ZPAV)	olis.onyx.pl	id	id is the last number(s) at the end of the URL. For example the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
Portugal	Portuguese Albums (AFP)	www.portuguesecharts.com	artist album
Switzerland	Swiss Albums (Schweizer Hitparade)	www.swisscharts.com	artist album
Sweden	Swedish Albums (Sverigetopplistan)	www.swedishcharts.com	artist album
Spain	Spanish Albums (PROMUSICAE)	www.spanishcharts.com	artist album

UK charts

Chart ID	Output	Requirements	Notes
UK	UK Albums (OCC)	artist	As with Billboard charts, this url returns the complete album chart history for the selected artist. Use this parameter only if the album's peak position is higher than 75. For positions below 75, use UKChartStats.
UK2	UK Albums (OCC)	artist date	UK Top 40 Albums archive from 1960 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKDigital	UK Digital Albums (OCC)	artist date	Digital albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKDance	UK Dance Albums (OCC)	artist date	Dance albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKComp	UK Compilation Albums (OCC)	artist date	Compilation albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKIndependent	UK Independent Albums (OCC)	artist date	Independent albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKR&B	UK R&B Albums (OCC)	artist date	R&B albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKCountry	UK Country Albums (OCC)	artist date	Country albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
Scotland	Scottish Albums (OCC)	artist date	Scottish albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.
UKChartStats	UK Albums (OCC)	albumid artist album	This uses ChartStats.com
UKZobble	UK Albums (OCC)	id title	This uses Zobble.de. id is the letter (A, B, C, etc.); title is what comes after "Chart Log UK:".

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,

{{albumchart|Billboard200|1|artist=Katy Perry|artistid=958673}} is the syntax for citing a number 1 position on the Billboard 200 for Katy Perry.

Also, the artist id can be easily retrieved using the {{BillboardID}} template which, given the artist name, returns the id number without searching the website. With this template, instead of writing:

{{albumchart|Billboard200|1|artist=Katy Perry|artistid=958673}}

We write:

{{albumchart|Billboard200|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	Output	Requirements	Notes
Billboard200	US Billboard 200	artist artistid
BillboardDigital	US Digital Albums (Billboard)	artist artistid
BillboardHeatseekers	US Top Heatseekers Albums (Billboard)	artist artistid
BillboardDanceElectronic	US Top Dance/Electronic Albums (Billboard)	artist artistid
BillboardRandBHipHop	US Top R&B/Hip-Hop Albums (Billboard)	artist artistid
BillboardRandB	US Top R&B Albums (Billboard)	artist artistid
BillboardRap	US Top Rap Albums (Billboard)	artist artistid
BillboardRock	US Top Rock Albums (Billboard)	artist artistid
BillboardAlternative	US Top Alternative Albums (Billboard)	artist artistid
BillboardHardRock	US Top Hard Rock Albums (Billboard)	artist artistid
BillboardFolk	US Top Folk Albums (Billboard)	artist artistid
BillboardCountry	US Top Country Albums (Billboard)	artist artistid
BillboardBluegrass	US Top Bluegrass Albums (Billboard)	artist artistid
BillboardJazz	US Top Jazz Albums (Billboard)	artist artistid
BillboardBlues	US Top Blues Albums (Billboard)	artist artistid
BillboardClassical	US Top Classical Albums (Billboard)	artist artistid
BillboardLatin	US Top Latin Albums (Billboard)	artist artistid
BillboardRegionalMexican	US Regional Mexican Albums (Billboard)	artist artistid
BillboardLatinPop	US Latin Pop Albums (Billboard)	artist artistid
BillboardTropical	US Tropical Albums (Billboard)	artist artistid	Albums before the week of July 5, 2003 are listed on the Tropical Songs chart.
BillboardChristian	US Christian Albums (Billboard)	artist artistid
BillboardGospel	US Top Gospel Albums (Billboard)	artist artistid
BillboardIndependent	US Top Independent Albums (Billboard)	artist artistid
BillboardCatalog	US Top Catalog Albums (Billboard)	artist artistid
BillboardReggae	US Top Reggae Albums (Billboard)	artist artistid
BillboardWorld	US World Albums (Billboard)	artist artistid
BillboardComedy	US Top Comedy Albums (Billboard)	artist artistid
BillboardKids	US Kid Albums (Billboard)	artist artistid
BillboardSoundtrack	US Soundtrack Albums (Billboard)	artist artistid
BillboardTastemaker	US Tastemaker Albums (Billboard)	artist artistid
BillboardCanada	Canadian Albums (Billboard)	artist artistid

Music DVD charts

The following Chart IDs are for Music DVDs. These are different from Live albums and some charts defines them separately. The editor must be extremely careful with the naming when using some of the following IDs.

Chart ID	Output	Website used as archive	Req.	Notes
AustraliaMV	Australian DVD Albums (ARIA)	www.ariacharts.com.au	artist dvd archiveurl archivedate	This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [2] with either WebCite or any other archiving method. Then, providing the parameters needed on the template. On archiveurl the WebCite url must be written, and on url the original given above.
AustriaMV	Austrian Music DVD (Ö3 Austria)	www.austriancharts.at	date year	This ID return a weekly top 10. For that reason, the date and year paramenters are mandatory. date must be in this format:YYYYMMDD.
FlandersMV	Belgian Music DVD (Ultratop Flanders)	www.ultratop.be	artist album dvd	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the dvd parameter instead of the album parameter.
WalloniaMV	Belgian Music DVD (Ultratop Wallonia)	www.ultratop.be	artist album dvd	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the dvd parameter instead of the album parameter.
ItalyMV	Italian Music DVD (FIMI)	www.fimi.it	year month id	The month parameter must be in numbers. As an example, February must be written as 02, or June as 06. the id parameter can be found searching on the Achive before selecting the year and the month: http://www.fimi.it/classifiche_search_dvd.php.
NetherlandsMV	Dutch Music DVD (MegaCharts)	www.dutchcharts.nl	artist album dvd	Don't forget to check as some albums have the [DVD] tag after the name (example: The Reel Me [DVD]). If that happens, use the dvd parameter instead of the album parameter.
SpainMV	Spanish Music DVD (PROMUSICAE)	www.promusicae.es	year week	The year parameter must contain only the last two numbers of the year. As an example, if the year is 2011, then only "11" must be written on the parameter. The week parameter mjst be in numbers. Example: 06.
UKMV	UK Music Video DVD (Official Charts Company)	www.officialcharts.com	artist date	Music Video DVD albums archive from 2009 onwards. The date parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on the archives of the OCC.

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 an example 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
|-
 {{albumchart|Billboard200|2|artist=Paramore|artistid=683820}}
|-
 {{albumchart|BillboardRock|1|artist=Paramore|artistid=683820}}
|}

{{reflist}}

Expands into:

Chart	Peak position
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2
US Billboard 200^[1]	2
US Top Rock Albums (Billboard)^[2]	1

Example with realistic data

Example using chart data from Homework (Daft Punk album):

{| class="wikitable sortable plainrowheaders"
|-
! Chart (1997)
! Peak<br/>position
|-
|{{albumchart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|accessdate=30 May 2012}}
|-
|{{albumchart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|accessdate=30 May 2012}}
|-
|{{albumchart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|accessdate=30 May 2012}}
|-
|{{albumchart|Netherlands|25|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|Austria|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|Flanders|7|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|Wallonia|9|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|BillboardCanada|15|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
|-
|{{albumchart|Finland|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|France|3|refname=FAC|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|Sweden|16|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|UK|8|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{albumchart|Billboard200|150|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
|-
|}

{{reflist}}