User:Muhandes/Album chart: Difference between revisions
Content deleted Content added
IrelandMV |
m Task 11: Disable the categories on this page while it is still a draft, per WP:USERNOCAT, using PC bot (v. 1.8.1) |
||
| Line 216: | Line 216: | ||
| USMV = {{!}} US Music Videos (''[[Billboard charts|Billboard]]''){{#tag:ref|[https://www.billboard.com/biz/charts/{{{date}}}/music-video "Music Video Sales: {{{date}}}"]. ''[[Billboard charts|Billboard]]''. {{#if:{{{publishdate|}}}|{{{publishdate}}}. }} {{#if:{{{accessdate|}}}| Retrieved {{{accessdate}}}. {{subscription required}}}}|name={{#if:{{{refname|}}}|{{{refname}}}|"ac_{{{1|}}}_{{{artist|}}}"}}}} |
| USMV = {{!}} US Music Videos (''[[Billboard charts|Billboard]]''){{#tag:ref|[https://www.billboard.com/biz/charts/{{{date}}}/music-video "Music Video Sales: {{{date}}}"]. ''[[Billboard charts|Billboard]]''. {{#if:{{{publishdate|}}}|{{{publishdate}}}. }} {{#if:{{{accessdate|}}}| Retrieved {{{accessdate}}}. {{subscription required}}}}|name={{#if:{{{refname|}}}|{{{refname}}}|"ac_{{{1|}}}_{{{artist|}}}"}}}} |
||
{{!}}align="center"{{!}}{{{2}}} |
{{!}}align="center"{{!}}{{{2}}} |
||
|'''Illegal chart entered ''{{{1}}}'''''{{!}}{{{2}}}}}{{#ifeq:{{NAMESPACE}}:{{BASEPAGENAME}}|Template:Albumchart|}}</includeonly>{{#invoke:Check for unknown parameters|check|unknown={{main other|[[Category:Pages using album chart with unknown parameters|_VALUE_{{PAGENAME}}]]}}|preview=Page using [[Template:Album chart]] with unknown parameter "_VALUE_"|ignoreblank=y| 1 | 2 | 3 | accessdate | address | album | albumid | archivedate | archiveurl | artist | artistid | chartid | date | dvd | id | location | note | page | publishdate | publisher | refgroup | refname | rowheader | title | url | urltitle | week | work | year }}<noinclude> |
|'''Illegal chart entered ''{{{1}}}'''''{{!}}{{{2}}}}}{{#ifeq:{{NAMESPACE}}:{{BASEPAGENAME}}|Template:Albumchart|}}</includeonly>{{#invoke:Check for unknown parameters|check|unknown={{main other|[[Category:Pages using album chart with unknown parameters|_VALUE_{{PAGENAME}}]]}}|preview=Page using [[Template:Album chart]] with unknown parameter "_VALUE_"|ignoreblank=y| 1 | 2 | 3 | accessdate | address | album | albumid | archivedate | archiveurl | artist | artistid | chartid | date | dvd | id | location | note | page | publishdate | publisher | refgroup | refname | rowheader | title | url | urltitle | week | work | year }}<noinclude> |
||
{{documentation}} |
{{documentation}} |
||
<!-- To add categories edit the documentation, please do not add them here. --> |
<!-- To add categories edit the documentation, please do not add them here. --> |
||
Latest revision as of 20:06, 1 September 2019
 | This template uses Lua: |
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 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 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[edit]
Following, the most common parameters used on the template:
{{Album chart|(Chart identifier)|(Peak position)|artist=|album=|refname=|accessdate=30 May 2012}}
Following, the parameters for any Billboard chart:
{{Album chart|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):
{{Album chart|UK(Specific identifier)|(Peak position)|artist=|date=YYYY-MM-DD|refname=|accessdate=30 May 2012}}
Manual referencing[edit]
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
{{Album chart}}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 (if specially relevant) publisher=, just like on the {{cite news}} template, to add a different source than the commonly used by {{Album chart}}.
To activate manual referencing, write an "M" as the third parameter of the template, after the country name and chart position, as this:
{{Album chart|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|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. Retrieved 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[edit]
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/301809/eric-clapton, so the artistid to use is 301809.
- 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{{Album chart|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[edit]
National charts[edit]
| 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 (PMB) | 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 |
| Canada | Canada Top Albums/CDs (RPM) | www.bac-lac.gc.ca/ | chartid | chartid is the number present after nlcxxxxx. For example in this example, the chartid is 2647. |
| CroatiaCombined | Croatian Albums (HDU) | 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=1562 is 1562 |
| Croatia | Croatian International Albums (HDU) | 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 (Offizielle Top 100) | 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 (Offizielle Top 100) | www.officialcharts.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 (Offizielle Top 100) | www.officialcharts.de | artist album |
|
| Germany4 | German Albums (Offizielle Top 100) | www.offiziellecharts.de | id artist album |
id is the last number(s) at the end of the URL. For example, the id of https://www.offiziellecharts.de/album-details-233637 is 233637 |
| GermanyComp | German Compilation Albums (Offizielle Top 100) | 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 |
|
| HungaryComp | Hungarian Compilation Albums (MAHASZ) | www.mahasz.hu | year week |
Since 2000, under the main albums chart. |
| 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.irish-charts.com | artist | |
| Ireland3 | Irish Albums (OCC) | www.officialcharts.com | artist date |
Official Irish Albums Chart Top 50 archive from January 6, 2017 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| IrelandClassical | Irish Classical Albums (IRMA) | www.chart-track.co.uk | year week |
|
| IrelandComp | Irish Compilation Albums (IRMA) | www.chart-track.co.uk | year week |
|
| IrelandIndependent | Irish Independent Albums (IRMA) | www.chart-track.co.uk | year week |
|
| Korea | South Korean Albums (Gaon) | www.gaonchart.co.kr | 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 | South Korean National Albums (Gaon) | www.gaonchart.co.kr | 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 | South Korean International Albums (Gaon) | www.gaonchart.co.kr | 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 and uptill week18, 2013. Since May 2013, some positions of the chart are published in the official Twitter account of AMPROFON including the number one position. 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[edit]
| 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. |
| UK2 | UK Albums (OCC) | date | UK Top 100 Albums archive from 22 July 1956 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| UKAmericana | UK Americana Albums (OCC) | artist date |
Americana albums archive from 29 January 2016 onwards. The date parameter must be provided in the YYYYMMDD format, 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 6 February 1994 onwards. The date parameter must be provided in the YYYYMMDD format, 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 30 January 1994 onwards. The date parameter must be provided in the YYYYMMDD format, 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 25 September 2005 onwards. The date parameter must be provided in the YYYYMMDD format, 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 9 April 2006 onwards. The date parameter must be provided in the YYYYMMDD format, 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 12 October 1997 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| UKJazz | UK Jazz & Blues Albums (OCC) | date | Jazz & blues albums archive from 30 January 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| UKProgressive | UK Progressive Albums (OCC) | artist date |
Progressive albums archive from 7 October 2015 onwards. The date parameter must be provided in the YYYYMMDD format, 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 9 October 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| UKRock | UK Rock & Metal Albums (OCC) | date | Rock & metal albums archive from 9 October 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| UKSoundtrack | UK Soundtrack Albums (OCC) | date | Soundtrack albums archive from 13 January 2002 onwards. The date parameter must be provided in the YYYYMMDD format, 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 27 February 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
artist album |
Chartstats is no longer working; please do not use this parameter. | ||
| UKZobbel | UK Albums (OCC) | id title |
This uses Zobbel.de. id is the letter (A, B, C, etc.); title is what comes after "Chart Log UK:". |
Billboard charts[edit]
Billboard charts all require the artist name. Special characters should be omitted from the artist's name to be passed correctly into the URL. For example,
{{Album chart|Billboard200|1|artist=Pnk}}is the syntax for citing a number 1 position on the Billboard 200 for P!nk.
The reference generated by the template will point to the following URL: http://www.billboard.com/music/pnk/chart-history/billboard-200.
- Entering the artist name as "P!nk" will produced an invalid URL (http://www.billboard.com/music/p!nk/chart-history/billboard-200).
| Chart ID | Output | Requirements | Notes |
|---|---|---|---|
| Billboard200 | US Billboard 200 | artist | |
| BillboardDigital | US Digital Albums (Billboard) | artist | |
| BillboardAlbumSales | US Top Album Sales (Billboard) | artist | |
| BillboardDigital | US Digital Albums (Billboard) | artist | |
| BillboardDanceElectronic | US Top Dance/Electronic Albums (Billboard) | artist | |
| BillboardRandBHipHop | US Top R&B/Hip-Hop Albums (Billboard) | artist | |
| BillboardRandB | US Top R&B Albums (Billboard) | artist | |
| BillboardRap | US Top Rap Albums (Billboard) | artist | |
| BillboardRock | US Top Rock Albums (Billboard) | artist | |
| BillboardAlternative | US Top Alternative Albums (Billboard) | artist | |
| BillboardHardRock | US Top Hard Rock Albums (Billboard) | artist | |
| BillboardFolk | US Top Folk Albums (Billboard) | artist | |
| BillboardCountry | US Top Country Albums (Billboard) | artist | |
| BillboardBluegrass | US Top Bluegrass Albums (Billboard) | artist | |
| BillboardJazz | US Top Jazz Albums (Billboard) | artist | |
| BillboardBlues | US Top Blues Albums (Billboard) | artist | |
| BillboardClassical | US Top Classical Albums (Billboard) | artist | |
| BillboardLatin | US Top Latin Albums (Billboard) | artist | |
| BillboardRegionalMexican | US Regional Mexican Albums (Billboard) | artist | |
| BillboardLatinPop | US Latin Pop Albums (Billboard) | artist | |
| BillboardTropical | US Tropical Albums (Billboard) | artist | Albums before the week of July 5, 2003 are listed on the Tropical Songs chart. |
| BillboardChristian | US Christian Albums (Billboard) | artist | |
| BillboardGospel | US Top Gospel Albums (Billboard) | artist | |
| BillboardHoliday | US Top Holiday Albums (Billboard) | artist | |
| BillboardHeatseekers | US Heatseekers Albums (Billboard) | artist | |
| BillboardIndependent | US Independent Albums (Billboard) | artist | |
| BillboardCatalog | US Top Catalog Albums (Billboard) | artist | |
| BillboardReggae | US Top Reggae Albums (Billboard) | artist | |
| BillboardWorld | US World Albums (Billboard) | artist | |
| BillboardComedy | US Top Comedy Albums (Billboard) | artist | |
| BillboardSoundtrack | US Soundtrack Albums (Billboard) | artist | |
| BillboardTastemaker | US Top Tastemaker Albums (Billboard) | artist | |
| BillboardVinyl | US Top Vinyl Albums (Billboard) | artist | |
| BillboardCanada | Canadian Albums (Billboard) | artist |
Music DVD charts[edit]
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 Music DVD (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 | The date parameter must be provided in the DD-MM-YYYY format. |
| 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]). In that case, 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]). In that case, use the dvd parameter instead of the album parameter. |
| DenmarkMV | Danish Music DVD (Hitlisten) | www.hitlisten.nu | week year |
|
| FinlandMV | Finnish Music DVD (Suomen virallinen lista) | www.ifpi.fi | artist album |
|
| FranceMV | French Music DVD (SNEP) | www.chartsinfrance.net | id | The id parameter can be found searching on the archive before selecting the year: For example http://www.chartsinfrance.net/charts/1544/videos-musicales.php. |
| ItalyMV | Italian Music DVD (FIMI) | www.fimi.it | id | The id parameter can be found searching on the archive before selecting the year: http://www.fimi.it/classifiche#/category:archive-dvd/year:2017. |
| 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]). In that case, use the dvd parameter instead of the album parameter. |
| SpainMV | Spanish Music DVD (PROMUSICAE) | www.promusicae.es | year week |
The year parameter must contain the year from which the charting took place by scrolling in this URL. The week parameter must be in numbers. Example: 06 for June. |
| SwedenMV | Swedish Music DVD (Sverigetopplistan) | www.sverigetopplistan.se | year week |
The URL ends with a six-digit number, in which the first four digits are the year and the last two are the week. Example: http://www.sverigetopplistan.se/netdata/ghl002.mbr/lista?liid=105&dfom=20160036. |
| SwitzerlandMV | Swiss Music DVD (Schweizer Hitparade) | www.swisscharts.com | date | The date parameter must be provided in the DD-MM-YYYY format. |
| UKMV | UK Music Videos (OCC) | www.officialcharts.com | artist date |
Music Video Chart Top 50 archive from January 30, 1994 onwards. The date parameter must be provided in the YYYYMMDD format, which is the issue date that can be found on the archives of the OCC. |
| USMV | US Music Videos (Billboard) | www.billboard.biz | artist date |
Music Video Sales chart archive from 1980 onwards. The date parameter must be provided in the YYYY-MM-DD format, which is the issue date that can be found on the URL after clicking here. |
Examples with table layout[edit]
Example with dummy data[edit]
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
|-
{{Album chart|Billboard200|2|artist=Paramore|artistid=683820}}
|-
{{Album chart|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[edit]
Example using chart data from Homework (Daft Punk album):
{| class="wikitable sortable plainrowheaders"
|-
! Chart (1997)
! Peak<br/>position
|-
|{{Album chart|Australia|37|artist=Daft Punk|album=Homework|refname=ARIA|accessdate=30 May 2012}}
|-
|{{Album chart|Norway|40|artist=Daft Punk|album=Homework|refname=HungM|accessdate=30 May 2012}}
|-
|{{Album chart|New Zealand|8|artist=Daft Punk|album=Homework|refname=HungM2|accessdate=30 May 2012}}
|-
|{{Album chart|Netherlands|25|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|Austria|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|Flanders|7|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|Wallonia|9|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|BillboardCanada|15|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
|-
|{{Album chart|Finland|34|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|France|3|refname=FAC|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|Sweden|16|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|UK|8|artist=Daft Punk|album=Homework|accessdate=30 May 2012}}
|-
|{{Album chart|Billboard200|150|artist=Daft Punk|artistid=141900|accessdate=30 May 2012}}
|-
|}
{{reflist}}
Expands into:
| Chart (1997) | Peak position |
|---|---|
| Australian Albums (ARIA)[1] | 37 |
| Norwegian Albums (VG-lista)[2] | 40 |
| New Zealand Albums (RMNZ)[3] | 8 |
| Dutch Albums (Album Top 100)[4] | 25 |
| Austrian Albums (Ö3 Austria)[5] | 34 |
| Belgian Albums (Ultratop Flanders)[6] | 7 |
| Belgian Albums (Ultratop Wallonia)[7] | 9 |
| Canadian Albums (Billboard)[8] | 15 |
| Finnish Albums (Suomen virallinen lista)[9] | 34 |
| French Albums (SNEP)[10] | 3 |
| Swedish Albums (Sverigetopplistan)[11] | 16 |
| UK Albums (OCC)[12] | 8 |
| US Billboard 200[13] | 150 |
- ^ "Australiancharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
- ^ "Norwegiancharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
- ^ "Charts.nz – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
- ^ "Dutchcharts.nl – Daft Punk – Homework" (in Dutch). Hung Medien. Retrieved 30 May 2012.
- ^ "Austriancharts.at – Daft Punk – Homework" (in German). Hung Medien. Retrieved 30 May 2012.
- ^ "Ultratop.be – Daft Punk – Homework" (in Dutch). Hung Medien. Retrieved 30 May 2012.
- ^ "Ultratop.be – Daft Punk – Homework" (in French). Hung Medien. Retrieved 30 May 2012.
- ^ "Daft Punk Chart History (Canadian Albums)". Billboard. Retrieved 30 May 2012.
- ^ "Daft Punk: Homework" (in Finnish). Musiikkituottajat – IFPI Finland. Retrieved 30 May 2012.
- ^ "Lescharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
- ^ "Swedishcharts.com – Daft Punk – Homework". Hung Medien. Retrieved 30 May 2012.
- ^ "Daft Punk | Artist | Official Charts". UK Albums Chart. Retrieved 30 May 2012.
- ^ "Daft Punk Chart History (Billboard 200)". Billboard. Retrieved 30 May 2012.
Tracking category[edit]
This template will automatically categorize articles:
- Category:Articles using Billboard ID with invalid artist (0) – the template is unable to find in the {{BillboardID}} subtemplate corresponding to the first letter in that artist's name; see the documentation for {{BillboardID}} for instructions on how to fix this error
- Category:Articles using BillboardChartNum with invalid chart name (0) – articles with invalid chart names
- Category:Pages using album chart with unknown parameters (474) – articles with unsupported parameters
See also[edit]
- {{Single chart}} – counterpart of Album chart for chart positions for single releases.
 | This user page employs intricate features of template syntax.
You are encouraged to familiarise yourself with its setup and parser functions before editing the template. If your edit causes unexpected problems, please undo it quickly, as this template may appear on a large number of pages. You can conduct experiments, and should test all major changes, in either this template's sandbox, the general template sandbox, or your user space before changing anything here. |
Category:Music templates Category:Templates that add a tracking category Category:WikiProject Albums templates Category:Templates that generate named references