Template:BillboardID/doc
 | This is a documentation subpage for Template:BillboardID. It contains usage information, categories and other content that is not part of the original template page. |
Billboard magazine indexes the artists on their website by a number called the artist ID. Each individual artist has a single identification number through which all chart history can be tracked form inside and outside the website. This number is permanent, and is needed when using the templates {{Singlechart}} and {{Albumchart}} on Wikipedia.
This template is very useful because if an artistid is suddenly changed, all articles using the old id wouldn't need a modification to fix the problem. Instead, the number will be fixed on the template. Also, it provides a more easy use of the {{Singlechart}} and {{Albumchart}} templates, and a user who is not familiar with the Billboard website can add chart peaks on an easy way without the need of an embarrassing search for the artist ID on the website.
The following template compiles the artists and their respective IDs, and provides the ID when called with a supported artist's name. It is an incomplete list (as of 3 June 2012 it includes 227 artists) and anyone can help adding or asking missing IDs to it. The artists are not ordered in any way on the following table, you can sort them by number or by name and find the artist whom ID you need. Because of the length of the list, it may be useful to use search commands, like Ctrl+F on Mozilla Firefox, as an example.
Usage
Copy and paste one of the following onto the {{Singlechart}} or {{Albumchart}} templates when calling a Billboard chart, replacing Artistname with the artist whom chart history you are consulting:
{{BillboardID|Artistname}}{{BillboardID|}}
Alternately, it can also be written:
{{BBID|Artistname}}{{BBID|}}
Example
The template might be used the following way: On the {{Singlechart}} or {{Albumchart}}, when calling Billboard charts, do the next:
- Usually, those templates might be called like this:
{{albumchart|Billboard200|10|artist=Gotye|artistid=619936|accessdate=2 June 2012}}{{singlechart|Billboardhot100|1|artist=Gotye|artistid=619936|accessdate=2 June 2012}}
- Instead, using this template, it might be called like this:
{{albumchart|Billboard200|10|artist=Gotye|artistid={{BillboardID|Gotye}}|accessdate=2 June 2012}}{{singlechart|Billboardhot100|1|artist=Gotye|artistid={{BillboardID|Gotye}}|accessdate=2 June 2012}}
- As an example (using the template):
| Chart | Peak position |
|---|---|
| US Billboard Hot 100[1] | 1 |
| Chart | Peak position |
|---|---|
| US Billboard 200[2] | 10 |
- ↑ "Illegal name entered Gotye/Gotye/chart?f=379 Gotye Album & Song Chart History" Billboard Hot 100 for Gotye. Prometheus Global Media. Retrieved 2 June 2012.
- ↑ "Gotye Chart History (Billboard 200)". Billboard. Retrieved 2 June 2012.
Supported artists
If the artist your're looking for is not listed here, please ask for it to be added on the talk page, an as soon as possible it will be added to the list.
Note: Do not add any artist to this list if you didn't added it as well on the template, since then it will be difficult and tedious to determine which artists are and aren't covered by the template. If you don't know how to add it to the template, it's preferable you write the ID on the talk page, and a skilled user will add it to the template.
Maintenance categories
To help maintain music articles, this template will automatically categorize articles that call it based on the parameters used in the reference.
BillboardID category
- REDIRECT Template:Category link
- From a page move: This is a redirect from a page that has been moved (renamed). This page was kept as a redirect to avoid breaking links, both internal and external, that may have been made to the old page name.
contains all articles that make use of the template.
Related pages
- {{singlechart}}
- {{albumchart}}
 | This template 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. Remember that you can conduct experiments, and should test all improvements, in either the general Template sandbox or your user space before changing anything here. |