Szablon:Singlechart

 Dokumentacja szablonu [zobacz] [edytuj] [historia] []

Ten szablon służy do cytowania źródeł w Wikipedii. Jest on stworzony specjalnie dla pojedynczych nagrań muzycznych, czyli singli.

Ogólnie rzecz biorąc szablon zawiera do informacje o krajowym notowaniu, gdzie dany singel zajął najwyższą pozycję. Takie tablice informacyjne są powszechnie używane w artykułach Wikipedii o singlach, albumach, artystach i ich dyskografiach.

Użycie

Ten szablon wyświetla dane odpowiednie do wyświetlenia w tabeli notowania muzycznego. Może być stosowany jako część większej tabeli. Nie tworzy się tego szablonu wokół znaczników tabeli.

Wszystkie nazwy pól muszą być napisane małymi literami.

Szablon używa języka polskiego.

Można skopiować poniższą, pustą wersję. Pamiętaj, aby używać "|" pomiędzy każdym polem i usunąć nieużywane pola, aby uniknąć bałaganu w oknie edycji. Szablon składa się z poniższych parametrów:

Pełna wersja (kopiując poniższy tekst usuń parametry, które nie są potrzebne)

{{singlechart |(Notowanie) |(Najwyższa pozycja) |utwór= |utwórid= |wykonawca= |wykonawcaid= |chartid= |url= |urltytuł= |data= |rok= |tydzień= |nota= |data publikacji= |data dostępu= |refname= |refgroup= |rowheader=}} Pamiętaj, aby odpowiednio dodać "utwór=" i "wykonawca=", choć niektóre listy przebojów nie wymagają tego pola. Domyślnym ustawieniem nie jest rowheader. Jeśli tak, to nazwa karty zostanie wyświetlona jako nagłówek.

Błędy

Błędne wywołania są zbierane w kategorii:

•  Kategoria:Szablon singlechart z błędem (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 18 elementów)
•  Kategoria:Singlechart stosujące brakujące parametry (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)

Parametry

• (Notowanie): Parametr notowania. Nazwy notowań można znaleźć w dziale Chart ID. Często nazwa notowania to kraj (np. Hiszpania, Dania, Słowacja), ale jeśli w jednym kraju jest więcej notowań to nazwa tego parametru jest nazwą notowania (np. Billboardjapanhot100).
• (Najwyższa pozycja): Parametr liczbowy, występujący zawsze po nazwie notowania. Jeśli singel dotarł do piątego miejsca to wtedy wpisujemy cyfrę 5.
• utwór: Tytuł singla lub utworu wykonawcy. Ten parametr zawsze sprawdzaj przechodząc na stronę notowania.
• url: Adres do strony, gdzie znalazłeś utwór na najwyższej pozycji. Parametr używany tylko dla poszczególnych notowań.
• chartid: Numer identyfikacyjny używany tylko przy polskich notowaniach (patrz: Polish Airplay Chart). Jest on inny dla każdego tygodnia i zawsze występuje na końcu adresu. Dla przykładu notowanie Polish Airplay Chart z 12 listopada 2011 nosi adres http://www.zpav.pl/rankingi/listy/nielsen/top5.php?idlisty=532, więc parametr chartid to numer 532.
• nota: Aby dodać notatkę o konkretnej wersji utworu na przykład, nota=English version, należy dodać parametr do {{singlechart|Australia|1|utwór=I'm the Urban Spaceman|wykonawca=The Bonzo Dog Doo Dah Band|nota=English version}}.
• refgroup: Pozwala określić nazwę grupy. Opcjonalny parametr.

Tworzenie

Przykłady notowań z różnymi parametrami

Poniżej przedstawiam kilka prostych sposobów użycia szablonu.

Lp	Kodowanie	Efekt końcowy (wraz z <references/>)
Przykład 1	{{singlechart |Australia |18 |wykonawca=Shakira |utwór=She Wolf}}	Australia (Top 50 Singles) 18
Przykład 2	{{singlechart |Billboardcanadianhot100 |5 |wykonawca=Shakira |wykonawcaid=147604}}	Kanada (Billboard Canadian Hot 100) 5
Przykład 3	{{singlechart |Francja |4 |wykonawca=Shakira |utwór=She Wolf |data=20091017}}	Francja (Top 200 Singles) 4
Przykład 4	{{singlechart |Włochy |3 |wykonawca=Shakira |utwór=Loba |nota="Loba" (Spanish version)}} |- {{singlechart |Włochy |11 |wykonawca=Shakira |utwór=She Wolf |nota="She Wolf" (English version) |refname = Włochy_Shakira_2}}	Włochy (Top 20 Singles) "Loba" (Spanish version) 3 Włochy (Top 20 Singles) "She Wolf" (English version) 11
Przykład 5	{| class="wikitable sortable" border="1" |- ! Lista (2012) ! Najwyższa<br />pozycja |- {{singlechart|Australia|1|wykonawca=Flo Rida feat. Sia|utwór=Wild Ones}} |- {{singlechart|Wallonia|13|wykonawca=Flo Rida feat. Sia |utwór=Wild Ones}} |- {{singlechart|Finlandia|6|wykonawca=Flo Rida feat. Sia |utwór=Wild Ones}} |- {{singlechart|Irlandia|3|rok=2012|tydzień=05}} |- {{singlechart |Billboardhot100|5| wykonawca=Flo Rida|wykonawcaid=873165}} |- {{singlechart|UK|4|data=2012-02-04}} |- |}	Lista (2012) Najwyższa pozycja Australia (Top 50 Singles) 1 Belgia (Wallonia) (Ultratop 50 Singles) 13 Finlandia (Top 20 Singles) 6 Irlandia (Top 50 Singles) 3 Stany Zjednoczone (Hot 100) 5 Wielka Brytania (Singles Top 100) 4

Komunikaty o błędach

Zawsze kilka parametrów jest niezbędnych dla danego notowania. Jeśli nie dodasz odpowiednich parametrów, to wyświetla się czerwony komunikat informujący o popełnionym przez ciebie błędzie. Oto przykład węgierskiego notowania, gdzie nie zostały dodane parametry rok i tydzień:

Węgry (Rádiós Top 40 játszási lista) WYMAGANY PARAMETR "ROK" I "TYDZIEŃ" !

19

Zawsze przed zapisaniem artykułu pierwsze zaznacz opcję zobacz podgląd, aby dowiedzieć się czy nie został popełniony błąd.

Dostępne notowania

Bardzo dużo notowań jest publikowanych przez Billboard. Większość notowań europejskich jest publikowane przez innych wydawców na osobnych stronach.

Inne notowania

(Notowanie)	Publikator notowania	Link	Potrzebne parametry	Uwagi
Australia	Australian Recording Industry Association	www.australian-charts.com	wykonawca utwór
Austria	Ö3 Austria Top 40	www.austriancharts.at	wykonawca utwór
Belgia (Flandria) Flandria	Ultratop	www.ultratop.be	wykonawca utwór	Dodanie słowa Tip po nazwie notowania Belgia (Flandria) Tip spowoduje odwołanie do belgijskiego notowania Tip
Belgia(Wallonia) Wallonia	Ultratop	www.ultratop.be	wykonawca utwór	Dodanie słowa Tip po nazwie notowania Belgia (Wallonia) Tip spowoduje odwołanie do belgijskiego notowania Tip
Czechy	International Federation of the Phonographic Industry	www.ifpicr.cz
Dania		www.danishcharts.com	wykonawca utwór	Użyj tych dwóch parametrów jeśli utwór pojawił się w duńskim notowaniu po listopadzie 2007 roku.
		www.hitlisten.nu	wykonawca utwór rok tydzień	Użyj tych parametrów jeśli utwór pojawił się w duńskim notowaniu przed listopadem 2007 roku.
Finlandia	Musiikkituottajat	www.finnishcharts.com	wykonawca utwór
Francja	Syndicat national de l’édition phonographique	www.lescharts.com	wykonawca utwór
Francedigital		www.lescharts.com	wykonawca utwór data	Parametr data to 8-cyfrowy numer, JJJJMMDD (ROK-MIESIĄC-DZIEŃ).
Hiszpania	Productores de Música de España	www.spanishcharts.com	wykonawca utwór
Holandia Holandia40	MegaCharts	www.top40.nl	wykonawca utwór	Jeśli nie posiadasz parametrów rok i tydzień to notowanie będzie dotyczyć tego publikowanego na www.top40.nl.
			rok tydzień
Holandia100	MegaCharts	www.dutchcharts.nl	wykonawca utwór
Irlandia	Irish Recorded Music Association	www.chart-track.co.uk	rok tydzień	Parametr tydzień przyjmuje wartości od 1 do 53. Cyfra 0 nie jest konieczna przed liczbami jednocyfrowymi.
Niemcy	GfK Entertainment	www.musicline.de	wykonawca utwór
Niemcy2		www.charts.de	wykonawca utwór
Norwegia	VG-Lista	lista.vg.no/	wykonawca utwór rok tydzień
		norwegiancharts.com	wykonawca utwór
Nowa Zelandia	Recorded Music NZ	www.charts.org.nz	wykonawca utwór
Polska	Związek Producentów Audio-Video	www.zpav.pl	chartid rok	Parametr chartid jest indywidualny dla każdego notowania i widnieje zawsze na końcu linku. Zobacz archiwum.
Polskadance				Zobacz archiwum.
Polskanowości				Zobacz archiwum.
Słowacja	IFPI	www.ifpicr.cz
Szkocja	Official Charts Company	www.officialchartcompany.com	data wykonawca utwór	Parametr data musi być w formacie JJJJ-MM-DD.
Szwecja	Sverigetopplistan	www.swedishcharts.com	wykonawca utwór
Szwajcaria		www.swisscharts.com	wykonawca utwór
UK Wielka Brytania	Official Charts Company Singles chart	www.theofficialcharts.com	data	Parametr data musi być w formacie JJJJ-MM-DD.
UKchartstats	Official Charts Company Singles chart	www.chartstats.com	wykonawca utwór utwórid
UKdance	Official Charts Company Dance singles chart	www.theofficialcharts.com	data	Parametr data musi być w formacie JJJJ-MM-DD.
UKdownload	Official Charts Company Download chart	www.theofficialcharts.com	data	Parametr data musi być w formacie JJJJ-MM-DD.
UKindependent UKindie	Official Charts Company Independent singles chart	www.theofficialcharts.com	data	Parametr data musi być w formacie JJJJ-MM-DD.
UKrandb	Official Charts Company R&B chart	www.theofficialcharts.com	data	Parametr data musi być w formacie JJJJ-MM-DD.
Węgry	Magyar Hangfelvétel-kiadók Szövetsége (Rádiós Top 40)	www.mahasz.hu	wykonawca utwór rok tydzień
Węgrytop10	Magyar Hangfelvétel-kiadók Szövetsége (Single Top 10)	www.mahasz.hu	wykonawca utwór rok tydzień
Węgrydance	Magyar Hangfelvétel-kiadók Szövetsége (Dance Top 40)	www.mahasz.hu	wykonawca utwór rok tydzień
Włochy	Federazione Industria Musicale Italiana	www.italiancharts.com	wykonawca utwór

Notowania Billboard

Wszystkie listy przebojów sporządzane przez Billboard wymagają parametrów wykonawca i wykonawcaid. Te parametry możesz znaleźć na www.billboard.com. Na przykładzie Katy Perry, szukając jej profilu na stronie przechodzisz na adres http://www.billboard.com/#/artist/katy-perry/958673. 958673 jest parametrem wykonawcaid, zaś Katy Perry to wykonawca. Kod źródłowy, który wpiszesz w tabeli wygląda tak:

{{singlechart|Billboardhot100|1|wykonawca=Katy Perry|wykonawcaid=958673}}

Parametr (Notowanie)	Nazwa notowania	Link	Wymagane parametry	Uwagi
Kanada Billboardcanadianhot100	Billboard Canadian Hot 100	www.billboard.com	wykonawca wykonawcaid
Billboardeuropeanhot100	European Hot 100	www.billboard.com	wykonawca wykonawcaid
Billboardjapanhot100	Japan Hot 100	www.billboard.com	wykonawca wykonawcaid
Billboardadultcontemporary	Adult Contemporary	www.billboard.com	wykonawca wykonawcaid
Billboardalternativesongs	Alternative Songs	www.billboard.com	wykonawca wykonawcaid
Billboardhot100	Hot 100	www.billboard.com	wykonawca wykonawcaid
Billboardadultpopsongs	Hot Adult Top 40 Tracks	www.billboard.com	wykonawca wykonawcaid
Billboardcountrysongs	Hot Country Songs	www.billboard.com	wykonawca wykonawcaid
Billboarddanceclubplay	Hot Dance Club Songs	www.billboard.com	wykonawca wykonawcaid
Billboarddigitalsongs	Hot Digital Songs	www.billboard.com	wykonawca wykonawcaid
Billboardlatinpopsongs	Latin Pop Airplay	www.billboard.com	wykonawca wykonawcaid
Billboardregionalmexican	Latin Regional Mexican Airplay	www.billboard.com	wykonawca wykonawcaid
Billboardlatintropical Billboardtropicalsongs	Latin Tropical Airplay	www.billboard.com	wykonawca wykonawcaid	Notowania przed 2009 rokiem nie są dostępne na stronie. Aby je zobaczyć wejdź na AllMusic.
Billboardlatinsongs	Hot Latin Songs	www.billboard.com	wykonawca wykonawcaid
Billboardpopsongs	Mainstream Top 40 (Pop Songs)	www.billboard.com	wykonawca wykonawcaid
Billboardrandbhiphop	Hot R&B/Hip-Hop Songs	www.billboard.com	wykonawca wykonawcaid
Billboardradiosongs	Hot 100 Airplay (Radio Songs)	www.billboard.com	wykonawca wykonawcaid
Billboardrocksongs	Rock Songs	www.billboard.com	wykonawca wykonawcaid
Billboardrapsongs	Hot Rap Songs	www.billboard.com	wykonawca wykonawcaid

Zastosowania szablonu w tabeli

Przykład z fikcyjnymi danymi

{| class="wikitable sortable" border="1"
|-
! Lista
! Najwyższa pozycja
|-
| wiersz 1, komórka 1
| wiersz 1, komórka 2
|-
| wiersz 2, komórka 1
| wiersz 2, komórka 2
|-
 {{singlechart|Australia|6|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
 {{singlechart|Belgia (Wallonia)|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Belgia (Flandria)|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Austria|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Dania|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Finlandia|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Francja|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Hiszpania|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Irlandia|40|rok=2010|tydzień=02}}
|-
{{singlechart|Norwegia|3|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Nowa Zelandia|4|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Holandia100|85|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Szwecja|12|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|Szwajcaria|5|utwór=I'm the Urban Spaceman|wykonawca=Bonzo Dog Doo Dah Band}}
|-
{{singlechart|UK|25|data=2010-01-03}}
|-
|}

<references/>

Lista	Najwyższa pozycja
wiersz 1, komórka 1	wiersz 1, komórka 2
wiersz 2, komórka 1	wiersz 2, komórka 2
Australia (Top 50 Singles) Happy Meal edition	6
Belgia (Wallonia) (Ultratop 50 Singles)	4
Belgia (Flandria) (Ultratop 50 Singles)	4
Austria (Ö3 Austria Top 40)	4
Dania (Track Top-40)	4
Finlandia (Top 20 Singles)	4
Francja (Top 200 Singles)	4
Hiszpania (Top 50 Singles)	4
Irlandia (Top 50 Singles)	40
Norwegia (Top 20 Singles)	3
Nowa Zelandia (Top 40 Singles)	4
Holandia (Single Top 100)	85
Szwecja (Top 60 Singles)	12
Szwajcaria (Singles Top 100)	5
Wielka Brytania (Singles Top 100)	25

Przykład z prawdziwymi danymi

Dla przykładu wybrałem singel Alicii Keys "Doesn't Mean Anything".

{|class="wikitable sortable" border="1"
|-
!Lista (2009)
!Najwyższa<br />pozycja
|-
{{singlechart|Australia|96|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything}}
|-
{{singlechart|Billboardcanadianhot100|66|wykonawca=Alicia Keys|wykonawcaid=433721}}
|-
{{singlechart|Czechy|31|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything|rok=2010|tydzień=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|wykonawca=Alicia Keys|wykonawcaid=433721}}
|-
{{singlechart|Niemcy|8|wykonawca=Keys,Alicia|utwór=Doesn't Mean Anything}}
|-
{{singlechart|Billboardjapanhot100|3|wykonawca=Alicia Keys|wykonawcaid=433721}}
|-
{{singlechart|Holandia100|43|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything|data dostępu=2010-02-28}}
|-
{{singlechart|Nowa Zelandia|22|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything}}
|-
{{singlechart|Słowacja|31|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything|tydzień=52|rok=2009}}
|-
{{singlechart|UKchartstats|8|wykonawca=Alicia Keys|utwór=Doesn't Mean Anything|utwórid=34669}}
|-
{{singlechart|Billboardhot100|60|wykonawca=Alicia Keys|wykonawcaid=433721}}
|-
|}

<references/>

expands into:

Lista (2009)	Najwyższa pozycja
Australia (Top 50 Singles)	96
Kanada (Billboard Canadian Hot 100)	66
Czechy (Singles Digital – Top 100)	31
Europa (European Hot 100)	10
Niemcy (Top 100 Singles)	8
Japonia (Japan Hot 100)	3
Holandia (Single Top 100)	43
Nowa Zelandia (Top 40 Singles)	22
Słowacja (Singles Digital)	31
Wielka Brytania (Singles Top 100)	8
Stany Zjednoczone (Hot 100)	60