View source for Template:Infobox song contest entry/doc

{{Documentation subpage}}
<!-- PLEASE ADD TEMPLATE CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{Lua|Module:InfoboxImage|Module:WikidataIB}}
{{Infobox song contest entry <!-- See Wikipedia:WikiProject Eurovision/Eurovision Song Contest-->
| song         = {{flagicon|Serbia}} "Molitva"
| image        = [[File:ESC 2007 Serbia - Marija Serifovic - Molitva.jpg|200px]]
| caption      = [[Marija Šerifović]] performing "Molitva" for [[Serbia]].
| year         = 2007
| country      = Serbia
| artist       = [[Marija Šerifović]]
| language     = Serbian
| languages    = 
| composer     = Vladimir Graić
| lyricist     = Saša Milošević Mare
| conductor    = 
| place        = 1st
| points       = 268
| place_semi   = 1st
| points_semi  = 298
| prev         = 
| prev_year    = 
| prev_link    = 
| next         = Oro
| next_year    = 
| next_link    = Oro (song)
}}
This is the standard [[Wikipedia:Manual of Style (infoboxes)|infobox]] for '''an entry in the [[Eurovision Song Contest]]''' and uses the '''{{tl|Infobox song contest entry}}''' template. The box to the right is an example. You can click on "edit this page" and copy-and-paste the markup to a different article, replacing its information with info on the country and year you choose to write about.

===Code===
<pre style="overflow:auto;">
{{Infobox song contest entry <!-- See Wikipedia:WikiProject Eurovision/Eurovision Song Contest-->
| song         = {{flagicon|enter_name_of_country_here}} #Required
| image        = 
| caption      = 
| year         = #Required
| country      = #Required
| artist       = 
| genre        = 
| language     = 
| languages    = 
| composer     = 
| lyricist     = 
| conductor    = 
| place        = 
| points       = 
| place_semi   = 
| points_semi  = 
| prev         = 
| prev_year    = 
| prev_link    = 
| next         = 
| next_year    = 
| next_link    = 
}}
</pre>

===Details===
====Song====
The ''song'' field should show the flag of the country and the name of the song as presented during the ESC.<br/>For the flag, use this template: <code><nowiki>{{flagicon|enter_name_of_country_here}}</nowiki></code> The title of the song should be surrounded by [[quotation mark]]s per [[Wikipedia:Manual of Style/Titles#Quotation marks|the manual of style]].
:*''e.g. for Serbia's Molitva, enter'' <code><nowiki>{{flagicon|Serbia}}</nowiki></code> "Molitva"
====Image====
The ''image'' field is for an image of the performance of the song. All images used need to comply with Wikimedia's relevant guidelines. If available, images set on Wikidata will be retrieved automatically; this may be disabled by setting {{para|fetchwikidata}} to <code>none</code>. Images are disabled when the infobox is embedded into another.

====Caption====
The ''caption'' field should provide additional information on the photo.
:*[[Marija Šerifović]] performing "[[Molitva]]"
====Year====
The ''year'' field is for the four-digit year in which the song was an ESC entry (no Wiki-links or special signs, as this will link directly to the article: ''"Country'' in the Eurovision Song Contest ''Year''")
====Country====
The ''country'' field should list the represented country's name in English, starting with a capital letter, as quoted by the ESC (no Wiki-links or special signs, as this will link directly either to the article ''"Country'' in the Junior Eurovision Song Contest" or the article ''"Country'' in the Eurovision Song Contest")

====Artist====
In the ''artist'' field, list the name(s) of the artist(s) as entered in the contest
:*[[Vicky Leandros|Vicky]]
:*if more than one, separate by "&"
====Genre====
The ''genre'' field should specify the genre of the entry. Choose a real genre like "pop" not "Russian" for example. Genres should be separated by using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
====Composer====
The ''composer'' field should list the composer of the song (use Wiki-links where applicable). Multiple composers should be separated by using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
====Lyricist====
The ''lyricist'' field should list the writer of the lyrics of the song (use Wikilinks where applicable). Lyricists should be separated by using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|lists}}
====Conductor====
The ''conductor'' field is for entries in contests where there was a live orchestra.
====Language====
The ''language'' field should display the primary language in which the song was performed at the ESC, adjective form in English starting with a capital letter ''(no Wikilinks or special signs please, as this will link directly to the article on the language)''<br />'''<span style="color:red">This field only supports ONE language at a time - for songs with lyrics in more languages use the field below!</span>'''
====Languages====
The ''languages'' field is for songs with lyrics in multiple languages, please enter them in this format:<br />''<nowiki>[[English language|English]], [[French language|French]]</nowiki>'', etc.{{r|lists}}
====Place====
The ''place'' field should list the place in the contest (final), if applicable - numeral ''(e.g. 1st, 2nd, 3rd, 4th, etc.)''
====Points====
The ''points'' field should list the points awarded in the contest (final), if applicable ''(e.g. 170, 22, 0, 16, etc.)''
====Place semi====
The ''place semi'' field is for the place in the semifinal, if applicable - numeral ''(e.g. 1st, 2nd, 3rd, 4th, etc.)''
====Points semi====
''points_semi'' - points awarded in the semifinal, if applicable ''(e.g. 170, 22, 0, 16, etc.)''
====Prev====
''prev''' - The name of the country's previous entry.
====Prev year====
''prev_year'' - The year of the country's previous entry. Not necessarily the year before.
====Prev link====
''prev_link'' - The name of the article of the song above
====Next====
''next'' - The name of the country's next entry.
====Next year====
''next_year'' - The year of the country's next entry. Not necessarily the year after.
====Next link====
''next_link'' - The name of the article of the song above

==Embedding==
{{Infobox song
| name          = Secret Combination
| cover         = Example.png <!-- Actual cover not used for copyright reasons. -->
| type          = single
| artist        = [[Kalomira]]
| album         = [[Secret Combination the Album|Secret Combination]]
| B-side        = 
| released      = {{Start date|2008|02|06|df=yes}}
| format        = 
*[[Music download|Digital download]]
*[[CD single]]
| recorded      = 2007–2008
| studio        = 
| genre         = 
*[[Laïko|Laïko-pop]]
*[[Contemporary R&B|R&B]]
| length        = 3:00
| label         = 
*[[Heaven Music]]
*Catchy Tunes
| writer        = 
*Poseidonas Giannopoulos
*Konstadinos Pantzis
| producer      = 
| prev_title = [[Gine Mazi Mou Paidi]]
| prev_year  = 2006
| next_title = [[Please Don't Break My Heart]]
| next_year  = 2010
| misc       = 
{{Infobox song contest entry
| embed = yes
| song = {{flagicon|Greece}} "Secret Combination"
| image = [[File:Example.png|200px]]
| caption = Eurovision promo cover
| year = 2008
| country = Greece
| artist = [[Kalomira]]
| as = 
| with = 
| language = English
| languages = 
| composer = Konstantinos Pantzis
| lyricist = Poseidonas Giannopoulos
| conductor = 
| place = 3rd
| points = 218
| place_semi = 1st
| points_semi = 156
| prev = Yassou Maria
| prev_link = Yassou Maria
| next = 
| next_link = 
}}
}}
By adding {{para|embed|yes}} to the first line of code, one can embed this infobox into another, creating one continuous infobox. Other infoboxes will need to have a special parameter that allows embedding. For example, if the song's page already includes the '''{{tl|Infobox song}}''' template, which most should, then the '''{{tl|Infobox song contest entry}}''' template should be added to the {{para|misc}} field in the Infobox song template. For a more detailed explanation about using Infobox song and additional parameters, please see the template page.

===Code===
<pre style="overflow:auto;">
{{Infobox song
| name          = 
| cover         = <!--just the file name-->
| alt           = 
| caption       = 
| type          = 
| artist        = 
| album         = 
| language      = <!--only if not in English-->
| English_title = 
| released      = <!--{{Start date|YYYY|MM|DD}}-->
| format        = 
| recorded      = 
| studio        =  
| genre         = <!--do not add unsourced genres-->
| length        = 
| label         = 
| writer        = <!--for both music and lyrics-->
| producer      = 
| prev_title    = <!--for a singles chronology-->
| prev_year     = 
| next_title    = 
| next_year     = 
| misc          = 
{{Infobox song contest entry
| embed        = yes
| song         = 
| image        = #Use promo cover of song: [[File:image name here|200px]]
| caption      = Eurovision promo cover
| year         = #Required
| country      = #Required
| artist       = 
| genre        = 
| language     = 
| languages    = 
| composer     = 
| lyricist     = 
| conductor    = 
| place        = 
| points       = 
| place_semi   = 
| points_semi  = 
| prev         = 
| prev_year    = 
| prev_link    = 
| next         = 
| next_year    = 
| next_link    = 
}}
}}
</pre>

==Notes==
{{Reflist|refs= 
<ref name="lists">For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of {{tl|flatlist}} or {{tl|hlist}} is preferred as they offer a benefit to users of screen readers. Vertical lists should always be implemented by {{tl|plainlist}} or {{tl|ubl}} and never by {{tag|br|s}} tags for reasons of [[Wikipedia:Manual of Style/Accessibility #Vertical lists|accessibility]].</ref>
}}

===Details===
*To learn what to input into each blank, see above and {{tl|Infobox song}}.
*When using this double template embedding, do NOT use the ''image'' and ''caption'' fields for an image of the performance or the regular album cover. The album cover can already be seen in the {{tl|Infobox song}} while an image of the performance would be appropriate for the artist's page or in the main body of the text. A promotional cover is acceptable as an image in the ESC infobox.
*This double template embedding should be used more often than just {{tl|Infobox song contest entry}} since most Eurovision songs are released as [[CD single]]s.

==TemplateData==
{{TemplateData header}}
<templatedata>
{
	"description": "Infobox for Eurovision Song Contest entries",
	"params": {
		"song": {
			"label": "Flag and song name",
			"description": "This should show the flag of the country and the name of the song. For example, {{flagicon|Serbia}} ''Molitva''.",
			"suggested": true,
			"type": "line"
		},
		"image": {
			"label": "Image link",
			"description": "Wikitext link to image of performance of the song. Only free images please. Suggested size: 250px",
			"type": "content"
		},
		"caption": {
			"label": "Caption",
			"description": "Additional information on the photo.",
			"type": "line"
		},
		"year": {
			"label": "Contest year",
			"description": "4-digit year of the ESC contest year (no special chars as this will be used to link to the 'Country in the Eurovision Song Contest Year' article)",
			"suggested": true,
			"type": "number"
		},
		"country": {
			"label": "Country name",
			"description": "The represented country's name in English, starting with a capital letter. (no special chars as this will be used to link to the 'Country in the Eurovision Song Contest Year' article)",
			"required": true,
			"type": "line"
		},
		"artist": {
			"label": "Link to artist's article",
			"description": "The name(s) of the artist(s) as entered in the contest. If there are multiple entries, separate with ampersands.",
			"suggested": true,
			"type": "content"
		},
		"genre": {
			"label": "Genre of the song",
			"description": "Choose a real genre",
			"type": "content"
		},
		"language": {
			"label": "Language",
			"description": "The primary language in which the song was performed at the ESC, adjective form in English starting with a capital letter (no special chars, as this will link directly to the article on the language). This field only supports ONE language at a time - for songs with lyrics in more languages use 'languages' instead!",
			"type": "line"
		},
		"languages": {
			"label": "Languages",
			"description": "For songs in multtiple languages. Format: [[English language|English]], [[French language|French]], etc.",
			"type": "content"
		},
		"composer": {
			"label": "Composer",
			"description": "The composer of the song (use wikilinks where applicable)",
			"type": "content"
		},
		"lyricist": {
			"label": "Lyricist",
			"description": "The writer of the lyrics of the song (use wikilinks where applicable)",
			"type": "content"
		},
		"conductor": {
			"label": "Conductor",
			"description": "This field was for entries in contests which had a live orchestra.",
			"type": "content"
		},
		"place": {
			"label": "Placement in final",
			"description": "The place in the final, if applicable - numeral (e.g. 1st, 2nd, 3rd, 4th, etc.). Set to blank if they did not qualify.",
			"required": true,
			"type": "line"
		},
		"points": {
			"label": "Points in final",
			"description": "The points awarded in the final, if applicable (e.g. 170, 22, 0, 16, etc.). Set to blank if they did not qualify.",
			"required": true,
			"type": "line"
		},
		"place_semi": {
			"label": "Placement in semi-final",
			"description": "The place in the semi-final, if applicable - numeral (e.g. 1st, 2nd, 3rd, 4th, etc.)",
			"type": "line"
		},
		"points_semi": {
			"label": "Points in semi-final",
			"description": "The points awarded in the semi-final, if applicable (e.g. 170, 22, 0, 16, etc.)",
			"type": "line"
		},
		"prev": {
			"label": "Previous song",
			"description": "The name of the country's previous song.",
			"type": "line"
		},
		"prev_year": {
			"label": "Previous year",
			"description": "The year of the country's previous entry. Not necessarily the previous year.",
			"type": "number"
		},
		"prev_link": {
			"label": "Previous link",
			"description": "The name of the article of the country's previous song to be linked to.",
			"type": "content"
		},
		"next": {
			"label": "Next song",
			"description": "The name of the country's next entry.",
			"type": "line"
		},
		"next_year": {
			"label": "Next year",
			"description": "The year of the country's next entry. Not necessarily the next year.",
			"type": "number"
		},
		"next_link": {
			"label": "Next link",
			"description": "The name of the article of the country's previous song to be linked to.",
			"type": "content"
		}
	},
	"sets": [
		{
			"label": "Finals performance",
			"params": ["place", "points", "place_semi", "points_semi"]
		}
	]
}
</templatedata>

<includeonly>{{Sandbox other||{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|
{{DEFAULTSORT:Song contest entry}}
[[Category:Eurovision Song Contest templates]]
[[Category:Music infobox templates]]
[[Category:Television infobox templates]]
[[Category:Embeddable templates|{{PAGENAME}}]]<!--override DEFAULTSORT-->
}}}}</includeonly>