Difference between revisions of "Template:AllMusic/doc"

From blackwiki
Jump to navigation Jump to search
blackwiki>Michael Bednarek
(-__NOTOC__ (?); don't use ";" for bolding; don't use the sandbox version in this documentation; rationalise <nowiki>; -deleted interwiki link sd:سانچو:Amg.)
blackwiki>GermanJoe
(+ TD header)
Line 99: Line 99:
 
*{{Allmusic|class=album|id=r11465|label=Physical Graffiti|first=Stephen Thomas|last=Erlewine|accessdate=February 10, 2010}}
 
*{{Allmusic|class=album|id=r11465|label=Physical Graffiti|first=Stephen Thomas|last=Erlewine|accessdate=February 10, 2010}}
  
===Template data===
+
=== Template data ===
 +
{{TemplateDataHeader}}
 
<templatedata>
 
<templatedata>
 
{
 
{

Revision as of 09:49, 8 August 2013

Purpose

This template provides a convenient way to produce an external link to an entry at AllMusic. The template can be used for any link to AllMusic's website, including the External links section or when citing it as a source.

Usage

Vertical layout

{{Allmusic
| class      =
| id         =
| tab        =
| label      =
| first      =
| last       =
| accessdate =
}}

Horizontal layout

{{Allmusic |class= |id= |tab= |label= |first= |last= |accessdate= }}

Short layout Valid with these three parameters only:

{{Allmusic|<class>|<id>|<label>}}

Parameters

Parameter Type Description
class optional Class of information, possible are "artist", "album", "song", "work" or "explore". Value for this parameter corresponds to part of URL following "www.allmusic.com/". If omitted, it defaults to "artist".
id mandatory Identification of information. Corresponds to part of URL following "artist/", "album/", "song/", "work/" or "explore/". The text before the actual id with name of artist, album etc. can be omitted. (Example: For www.allmusic.com/artist/led-zeppelin-p4739 "p4739" is sufficient for id).
tab optional If the link should access directly a specific tab on the AllMusic site you can use this parameter to specify that tab (e.g. "charts-awards"). The value for this parameter corresponds to the suffix of the URL following the identification, after the slash ('/'). If you are specifying a sub-tab of a tab, the whole suffix has to be used, (e.g. "songs/songs-composed-by"). Alternatively you can append the whole suffix for tab to the id parameter not using the tab parameter (see example below).
label optional Label to display for the link. If omitted, it defaults to the name of the article where this template is used.
first optional The author's first or given name(s).
last optional The author's surname or last name.
pure_url optional Value of "yes" produces no label and no additional text but a "pure" standalone external link. This option is mainly intended for the automated migration of standalone weblinks but can be used when linking to allmusic using {{Cite web}}, embedding {{Allmusic}} in {{Cite web}}. E.g.

{{cite web|url={{Allmusic |pure_url=yes |class=album |id=r1796665 |tab=review}} |title=Stone Temple Pilots [Deluxe Edition] |first=Stephen Thomas |last=Erlewine}}
produces:

  • Erlewine, Stephen Thomas. "Stone Temple Pilots [Deluxe Edition]".
accessdate optional Full date when item was accessed. Should not be wikilinked.

Examples

Group or artist

  • {{Allmusic|id=p4739|label=Led Zeppelin}}

expands to

Album (supplying accessdate)

  • {{Allmusic|class=album|id=r15973|label=''News of the World''|accessdate=February 10, 2010}}

expands to

Song (short notation)

  • {{Allmusic|song|t2454936|"Dust in the Wind"}}

expands to

Using tab parameter

  • {{Allmusic|id=p4739|tab=discography|label=Discography of Led Zeppelin}}

expands to

Accessing tab in tab with sort (not using tab parameter)

  • {{Allmusic|id=p4739/discography/compilations/title-asc|label=Compilations of Led Zeppelin sorted by title}}

expands to

Author name

  • {{Allmusic|class=album|id=r11465|label=Physical Graffiti|first=Stephen Thomas|last=Erlewine|accessdate=February 10, 2010}}

expands to

Template data

This is the TemplateData documentation for this template used by VisualEditor and other tools; see the monthly parameter usage report for this template.

TemplateData for AllMusic

This template produces an external link to an entry at AllMusic.

Template parameters

ParameterDescriptionTypeStatus
AllMusic classclass 1

Class of information, possible are "artist" (default), "album", "song", "work" or "explore". Part of URL immediately after "www.allmusic.com/".

Stringoptional
AllMusic IDid 2

AllMusic ID number. The letter-number code towards the end of the URL. Can be used for the entire end of the URL.

Numberrequired
Page tabtab

If the link should access directly a specific tab on the AllMusic site you can use this parameter to specify that tab (e.g. "charts-awards"). The value for this parameter corresponds to the suffix of the URL following the identification, after the slash ('/'). If you are specifying a sub-tab of a tab, the whole suffix has to be used, (e.g. "songs/songs-composed-by").

Stringoptional
Displayed textlabel 3

Text to display for the link. Defaults to page title.

Stringoptional
Author's first namefirst

The author's first or given name(s).

Stringoptional
Author's last namelast

The author's surname or last name.

Stringoptional
URL onlypure_url

If set to "yes", produces URL only without additional formatting. Typically used in citation templates.

Stringoptional
Access dateaccessdate

Full date when item was accessed.

Stringoptional