Difference between revisions 3957848 and 3957849 on simplewiki

< previous diff
next diff >
Template:Albumchart/doc
{{Documentation subpage}}
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This template is used to [[WP:CITE|cite sources]] in Wikipedia. It is specifically for [[album]]s. A similar template for use when citing sources for musical singles can be found at [[Template: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 [[WP:RS|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:

:<code><nowiki>{{albumchart|(Chart identifier)|(Peak position)|artist=|album=|refname=|accessdate=30 May 2012}}</nowiki></code>

Following, the parameters for any ''Billboard'' chart:
 
:<code><nowiki>{{albumchart|Billboard(Specific identifier)|(Peak position)|artist=|artistid=|refname=|accessdate=30 May 2012}}</nowiki></code>

Following, the parameters for any UK chart (except for the main UK parameter, UKChartStats and UKZobble):
 
:<code><nowiki>{{albumchart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|accessdate=30 May 2012}}</nowiki></code>

==Manual Referencing==
If the following situations arise:
#The album name contains special characters that the <code>album=</code> 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 {{tlc|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 <code>url=</code> and <code>title=</code>, and may additionally provide <code>work=</code>, <code>page=</code>, <code>date=</code>, <code>location=</code> and <code>publisher=</code>, just like on the {{tlc|cite news}} template, to add a different source than the commonly used by {{tlc|albumchart}}, as this:
*<code><nowiki>{{Albumchart|Australia|1|</nowiki>'''<nowiki>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</nowiki>'''<nowiki>|accessdate=9 June 2012}}</nowiki></code>
And it will show as this:
{| class="wikitable"
!Charts
!Peak<br>position
|-
{{Albumchart|Australia|1|M|title=Madonna's "MDNA" Tops ARIA Charts|url=http://www.madonna.com/|work=Billboard|publisher=Nielsen Business Media|location=United States|accessdate=9 June 2012}}
|-
|}
<references />
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|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|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 (&ndash;, 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|''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|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., <code>note=2-disc deluxe edition</code>, or <code><nowiki>{{albumchart|Australia|1|album=Making Mirrors|artist=Gotye|note=2-disc deluxe edition}}</nowiki></code>.
* '''publishdate''': Date of publication of the reference generated by the template, in the same format as other [[WP:DATES#Dates|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 [[WP:NAMEDREFS|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 ===
{| class="wikitable" border="1"
! style="width:10em;"| Chart ID
! style="width:20em;"| Output
! style="width:15em;"| Website used as archive
! style="width:7em;"| Req.
! style="width:35em;"| Notes
|-
| Australia || Australian Albums ([[ARIA Charts|ARIA]]) ||align="center"| www.australian-charts.com ||align="center"| artist<br>album || 
|-
| Austria || Austrian Albums ([[Ö3 Austria Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| artist<br> album || 
|-
| Flanders || Belgian Albums ([[Ultratop]] Flanders) ||align="center"| www.ultratop.be ||align="center"| artist<br> album || 
|-
| Wallonia || Belgian Albums ([[Ultratop]] Wallonia) ||align="center"| www.ultratop.be ||align="center"| artist<br> album || 
|-
| Brazil || Brazilian Albums ([[Associação Brasileira dos Produtores de Discos|ABPD]]) ||align="center"| www.abpd.org.br ||align="center"| 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 ([[Croatian Albums Chart|IFPI]]) ||align="center"| www.hdu-toplista.com ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example the id of http://www.hdu-toplista.com/index.php?what=arhiva&w=details&id=881 is 881
|-
| Denmark || Danish Albums ([[Hitlisten]]) ||align="center"| www.danishcharts.com ||align="center"| artist<br>album || Not recommended for charts prior to Nov. 2007; use instead '''Denmark2'''.
|-
| Denmark2 || Danish Albums ([[Hitlisten]]) ||align="center"| www.hitlisten.nu ||align="center"| week<br>year || For albm charts prior to Nov. 2007, is better to use this Chart ID.
|-
| Finland || Finnish Albums ([[Musiikkituottajat – IFPI Finland|Musiikkituottajat]]) ||align="center"| www.finnishcharts.com ||align="center"| artist<br>album || 
|-
| France || French Albums ([[SNEP]]) ||align="center"| www.lescharts.com ||align="center"| artist<br>album || 
|-
| Germany || German Albums ([[Media Control]]) ||align="center"| www.musicline.de ||align="center"| artist<br>album || As with ''Billboard'' charts, this url returns the complete album (''longplay'') chart history for the selected artist.
|-
| Germany2 || German Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| year<br>date || This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1978 onwards.
|-
| Germany3 || German Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| artist<br>album ||
|-
| GermanyComp || German Compilation Albums ([[Media Control]]) ||align="center"| www.charts.de ||align="center"| year<br>date || This website, instead of retrieving a complete chart history, it returns a weekly chart. <br/>The ''date'' parameter must be filled as this: YYYYMMDD. It contains chart info from 1992 onwards.
|-
| Greece || Greek Albums ([[IFPI]]) ||align="center"| www.greekcharts.com ||align="center"| artist<br>album || This website only contains chart information from 2010 to week 31/2011.
|-
| Italy || Italian Albums ([[FIMI]]) ||align="center"| www.italiancharts.com ||align="center"| artist<br>album ||
|-
| Ireland || Irish Albums ([[IRMA]]) ||align="center"| www.chart-track.co.uk  ||align="center"| year<br>week ||
|-
| Ireland2 || Irish Albums ([[IRMA]]) ||align="center"| www.irishcharts.com  ||align="center"| artist<br>album ||
|-
| IrelandClassical || Irish Classical Albums ([[IRMA]]) ||align="center"| www.chart-track.co.uk  ||align="center"| year<br>week ||
|-
| Korea || Korean Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>date || Overall albums (national and foreign). The ''date'' must be in the format: YYYY.MM.DD~YYYY.MM.DD, which can be retrieved from [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=T the GAON page].
|-
| KoreaNat || Korean National Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>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 [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=K the GAON page].
|-
| KoreaInt || Korean International Albums ([[GAON]]) ||align="center"| www.gaonchart.co.kr  ||align="center"| year<br>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 [http://www.gaonchart.co.kr/main/section/album/list.gaon?nationGbn=E the GAON page].
|-
| Mexico || Mexican Albums ([[Top 100 Mexico]]) ||align="center"| www.mexicancharts.com ||align="center"| artist<br>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]]) ||align="center"| www.amprofon.com.mx ||align="center"| artist<br>album<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [http://www.centrodedesarrollodigital.com/amprofon3/Top100.pdf] 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.<br/> 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]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album || 
|-
| NetherlandsComp || Dutch Compilation Albums ([[MegaCharts]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>year<br>date || For this ID, the ''date'' and ''year'' paramenters are mandatory. ''date'' must be in this format:YYYYMMDD.
|-
| New Zealand || New Zealand Albums ([[RIANZ]]) ||align="center"| www.charts.org.nz ||align="center"| artist<br>album ||
|-
| Norway || Norwegian Albums ([[VG-lista]]) ||align="center"| www.norwegiancharts.com ||align="center"| artist<br>album ||
|-
| Oricon || Japanese Albums ([[Oricon]]) ||align="center"| www.oricon.co.jp ||align="center"| date || This is the Oricon Top 50 Albums chart. It is in Japanese and the only parameter needed is the ''date''.<br> The ''date'' must follow this format: YYYY-MM-DD.
|-
| Poland || Polish Albums ([[Polish Society of the Phonographic Industry|ZPAV]]) ||align="center"| olis.onyx.pl ||align="center"| id || ''id'' is the last number(s) at the end of the URL.<br> For example the id of http://olis.onyx.pl/listy/index.asp?idlisty=708 is 708
|-
| Portugal || Portuguese Albums ([[Associação Fonográfica Portuguesa|AFP]]) ||align="center"| www.portuguesecharts.com ||align="center"| artist<br>album ||
|-
| Switzerland || Swiss Albums ([[Schweizer Hitparade]]) ||align="center"| www.swisscharts.com ||align="center"| artist<br>album || 
|-
| Sweden || Swedish Albums ([[Sverigetopplistan]]) ||align="center"| www.swedishcharts.com ||align="center"| artist<br>album || 
|-
| Spain || Spanish Albums ([[PROMUSICAE]]) ||align="center"| www.spanishcharts.com ||align="center"| artist<br>album || 
|-
|}

=== UK charts ===
{| class="wikitable" border="1"
! style="width:10em;"| Chart ID
! style="width:25em;"|Output
! style="width:10em;"|Requirements
! style="width:35em;"|Notes
|-
| UK || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| artist || As with ''Billboard'' charts, this url returns the complete album chart history for the selected artist.<br/> Use this parameter only if the album's peak position is higher than 75. For positions below 75, use UKChartStats.
|-
| UK2 || UK  Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || UK Top 40 Albums archive from 1960 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKDigital || UK Digital Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Digital albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKDance || UK Dance Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Dance albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKComp || UK Compilation Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Compilation albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKIndependent || UK Independent Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Independent albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKR&B || UK R&B Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || R&B albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKCountry || UK Country Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Country albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| Scotland || Scottish Albums ([[Official Charts Company|OCC]]) ||align="center"| artist<br>date || Scottish albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/music/ the arhives of the OCC].
|-
| UKChartStats || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| albumid<br>artist<br>album || This uses ChartStats.com
|-
| UKZobble || UK Albums ([[Official Charts Company|OCC]]) ||align="center"| id<br>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, 
*{{tlc|albumchart|Billboard200|1|4=artist=Katy Perry|5=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 {{tl|BillboardID}} template which, given the artist name, returns the id number without searching the website. With this template, instead of writing:
:*{{tlc|albumchart|Billboard200|1|4=artist=Katy Perry|5=artistid=958673}}
:We write:
:*<code><nowiki>{{albumchart|Billboard200|1|artist=Katy Perry|artistid={{BillboardID|Katy Perry}}}}</nowiki></code>
:And the template returns the correct id, avoiding errors when writing the number.

{| class="wikitable" border="1"
! style="width:15em;"| Chart ID
! style="width:20em;"| Output
! style="width:10em;"| Requirements
! style="width:25em;"| Notes
|-
| Billboard200 || US [[Billboard 200|''Billboard'' 200]] ||align="center"| artist<br/>artistid ||
|-
| BillboardDigital || US [[Digital Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardHeatseekers || US [[Top Heatseekers|Heatseekers Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardDanceElectronic || US [[Dance/Electronic Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardRandBHipHop || US [[R&B/Hip-Hop Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardRap || US [[Rap Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardRock || US [[Rock Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardAlternative || US [[Alternative Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardHardRock || US [[Hard Rock Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardFolk || US [[Folk Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardCountry || US [[Top Country Albums|Country Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardBluegrass || US [[Top Bluegrass Albums|Bluegrass Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardJazz || US [[Jazz Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardBlues || US [[Top Blues Albums|Blues Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardClassical || US [[Top Classical Albums|Classical Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardLatin || US [[Top Latin Albums|Latin Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardRegionalMexican || US [[Regional Mexican Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|- 
| BillboardLatinPop || US [[Latin Pop Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardTropical || US [[Tropical Albums]] (''Billboard'') ||align="center"| artist<br/>artistid || Albums before the week of July 5, 2003 are listed on the Tropical Songs chart.
|-
| BillboardChristian || US [[Christian Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardGospel || US [[Top Gospel Albums|Gospel Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardIndependent || US [[Independent Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardCatalog || US [[Top Catalog Albums|Catalog Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardReggae || US Reggae Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardWorld || US World Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardComedy || US [[Top Comedy Albums|Comedy Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardKids || US [[Kid Albums]] (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardSoundtrack || US Soundtrack Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardTastemaker || US Tastemaker Albums (''Billboard'') ||align="center"| artist<br/>artistid ||
|-
| BillboardCanada || US [[Top Canadian Albums|Canadian Albums]] (''Billboard'') ||align="center"| artist<br/>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 extremeley carefull with the naming when using some of the following IDs.

{| class="wikitable" border="1"
! style="width:10em;"| Chart ID
! style="width:20em;"| Output
! style="width:15em;"| Website used as archive
! style="width:7em;"| Req.
! style="width:35em;"| Notes
|-
| AustraliaMV || Australian DVD Albums ([[ARIA]]) ||align="center"| www.ariacharts.com.au ||align="center"| artist<br>dvd<br>archiveurl<br>archivedate || This ID needs the chart to be archived to secure future verifiability. That means, it must be used archiving the url [http://www.ariacharts.com.au/pages/charts_display_music.asp?chart=1V40DVD] 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 Top 40|Ö3 Austria]]) ||align="center"| www.austriancharts.at ||align="center"| date<br>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) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>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) ||align="center"| www.ultratop.be ||align="center"| artist<br>album<br>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]]) ||align="center"| www.fimi.it  ||align="center"| year<br>month<br>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]]) ||align="center"| www.dutchcharts.nl ||align="center"| artist<br>album<br>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]]) ||align="center"| www.promusicae.es ||align="center"| year<br>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]]) ||align="center"| www.officialcharts.com ||align="center"| artist<br>date || Music Video DVD albums archive from 2009 onwards.<br/> The ''date'' parameter must be provided in the way YYYY-MM-DD, which is the issue date that can be found on [http://www.officialcharts.com/archive/video/ the arhives 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 are examlpes table with its corresponding output:

<pre>{| 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}}</pre>

Expands into:

{| 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}}
|}
<references/>

===Example with realistic data===
Example using chart data from [[Homework (Daft Punk album)|''Homework'' (Daft Punk album)]]:

<pre>{| 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}}</pre>

Expands into:

{| 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}}
|-
|}
<references/>

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

=== Albumchart category ===
{{category|Albumchart}} contains all articles that make use of the template.

==See also==
*{{tl|Singlechart}} — counterpart of ''Albumchart'' but for chart positions for single releases.


{{intricate}}