Vorlage:Fußball Einsatzdaten/Abfrage/Doku
Herzlich Willkommen!
Diese Vorlage ist Teil des Projekts Fußballbot. Dieser Bot wurde von DrTrigon und Hephaion konzipiert. Die Vorlage dient dazu, Einsatzstatistiken von Fußballspielern in ihren entsprechenden Artikeln wiederzugeben. Dabei wird die Statistik vom DrTrigonBot wöchentlich aktualisiert.
Einbindung aller Unterseiten in der Kategorie:Vorlage:Metadaten Fußballstatistik (derzeit nicht genutzt).
Grundlagen[Quelltext bearbeiten]
Diese Vorlage ist in der Lage, Einsatzstatistiken eines Fußballspielers wiederzugeben. Diese Statistiken finden sich in einer weiteren Vorlage, die für jeden Spieler einzeln angelegt wird. Als Quelle wird dabei transfermarkt.de herangezogen. Hierbei sei angemerkt, dass die Qualitätsmängel auf dieser Seite bekannt sind, die Daten für die höchsten europäischen Ligen der jeweils aktuellen Saison jedoch korrekt sind. Der Bot greift die entsprechenden Statistiken einmal pro Woche von der Quellseite ab und überschreibt dabei die alten in der Vorlage.
Es wird darauf hingewiesen, dass die Benutzung der hier zur Verfügung gestellten Vorlagen nicht in der Verantwortung der Initiatoren liegt. Vielmehr sollte jeder, der Vorlagen anlegt und sie in Artikeln nutzt, die abgerufenen Statistiken kritisch hinterfragen und den korrekten Ablauf mit einem Blick in regelmäßigen Abständen prüfen.
Schritt 1 – die Metadaten-Vorlage[Quelltext bearbeiten]
Um einen Fußballerartikel mit einer Vorlage auszustatten, folge bitte den Hinweisen.
1. Stelle sicher, dass der Spieler ein Profil bei transfermarkt.de besitzt und rufe es auf.
2. Ersetze im folgenden Feld <Spielername> durch das Lemma (wichtig!) des Fußballspielers und klicke auf neue Vorlage anlegen.
3. Fülle nun die Vorlage aus, die sich in der ersten Zeile des geöffneten Fensters befindet:
- Im Anschluss müssen die <pre>-Tags an Anfang und Ende des Textes entfernt werden. (Die Einteilung in Vor-und Familienname ist wichtig für eine korrekte Einsortierung in die Kategorie und verhindert Fehler bei Klammerlemmata.)
4. Speichere die Seite ab. Die Vorlage mit den Metadaten ist nun erstellt. Bitte warte, bis der Bot die Einsatzstatistik erstmals ergänzt. Dies dauert in der Regel nur wenige Minuten. Danach ersetzt der Bot die Daten einmal wöchentlich.
Beispiel[Quelltext bearbeiten]
Wir nehmen an, wir möchten eine Metadaten-Vorlage für James Milner erstellen. (existiert bereits) Schritt 1: Sein Profil bei transfermarkt.de aufrufen
Schritt 2: <Spielername> durch James Milner ersetzen und die Vorlage:Metadaten Fußballstatistik/James Milner aufrufen.
Schritt 3: Sich die URL http://www.transfermarkt.de/de/james-milner/profil/spieler_3333.html anschauen und den Vor- (James) und Familiennamen (Milner), den Transfermarkt-Namen (james-milner) sowie die ID (3333) in die Vorlage eingeben: {{subst:Vorlage:Fußball Einsatzdaten/Neu|James|Milner|james-milner|3333}}
Schritt 4: Speichern – auf den Bot warten – fertig
Schritt II – Einfügen in den Zielartikel[Quelltext bearbeiten]
Die Vorlage für den Bot ist nun fertig. Das Einfügen einzelner Werte in den entsprechenden Zielartikel erfolgt über die Vorlage:Fußball Einsatzdaten/Abfrage. Zum Abfragen einer Statistik sind grundsätzlich 4 Parameter notwendig: Der Name des Spielers, der Wettbewerb, die gewünschte Statistik und die Saison. Sinnvoll ist es, im Bereich der Infobox einen Hinweis zu hinterlassen, dass die Daten automatisch aktualisiert werden.
Kopiervorlage:
{{Fußball Einsatzdaten/Abfrage|<Lemma des Spielers>|<Wettbewerbskürzel>|<gewünschte Statistik>|<Saison>}}Am Beispiel James Milner:
{{Fußball Einsatzdaten/Abfrage|James Milner|ENG1|Spiele|2012}}oder
{{Fußball Einsatzdaten/Abfrage|{{PAGENAME}}|ENG1|Spiele|2012}}gibt die Anzahl der Spiele aus, die James Milner in der Saison 2012/13 in der Premier League absolviert hat.
- Lemma des Spielers
Erklärt sich von selbst und ist demzufolge das gleiche Lemma, das bei der Erstellung der Metadaten-Vorlage genutzt wurde. Zum schnelleren Arbeiten kann an dieser Stelle auch die Vorlage {{PAGENAME}} anstelle des Lemmas genutzt werden, aber natürlich nur bei der Verwendung im Zielartikel selbst.
Im Beispiel: James Milner
- Wettbewerbskürzel
Die Kürzel zu den Wettbewerben orientieren sich an den Ländervorlagen mit Flagge. Die anschließende Zahl symbolisiert die Höhe der entsprechenden Liga. Derzeit werden mehr als 20 der weltweit bedeutendsten Ligen unterstützt. Zusätzlich sind eine Vielzahl von Pokalwettbewerben verfügbar, die ebenfalls per Kürzel mit der Vorlage abgerufen werden können. Eine Übersicht über alle unterstützten Wettbewerbe findet sich hier.
Im Beispiel: ENG für England; 1 für die höchste Liga => ENG1
- gewünschte Statistik
Hier wird der gewünschte statistische Wert ausgewählt. Die meistgenutzten werden Tore und Spiele sein. Das Setzen der Klammern um die Anzahl der Tore übernimmt der Bot selbst! Eine Übersicht über alle verfügbaren Statistiken findet sich verfügbare Statistiken.
Im Beispiel: Spiele, für die Gesamtanzahl an Einsätzen
- Saison
Als letzter Parameter wird die Saison ausgewählt. Dies wird mit einer Jahreszahl getan, die sich immer auf das Jahr des Beginns der entsprechenden Saison bezieht.
Im Beispiel: 2012, für die Saison 2012/13
- Stand
Unter lgupdate sollte die Vorlage {{Fußball Einsatzdaten/Abfrage|{{PAGENAME}}|Stand}} stehen, die jeweils das letzte Bearbeitungsdatum der entsprechenden Metadatenseite durch den Bot angibt. Dadurch erhält der Artikel auch immer das korrekte Datum. PAGENAME kann muss wiederum auf allen anderen Seiten durch das Lemma es Spielers ersetzt werden.
Kopiervorlage[Quelltext bearbeiten]
{{Fußball Einsatzdaten/Abfrage|…|…|…}}
Parameter[Quelltext bearbeiten]
- 1
- Name des Spielers, dessen Einsatzdaten ausgegeben werden sollen - eine Liste möglicher Spieler ist vorhanden
- 2
- Liga
- 3
- Wert (Spiele, Tore, …)
- 4
- Jahr (optional, wenn nicht angegeben wird das aktuelle Jahr verwendet)
Beispiele[Quelltext bearbeiten]
{{Fußball Einsatzdaten/Abfrage|James Milner|ENG1|Spiele|2010}}
{{Fußball Einsatzdaten/Abfrage|James Milner|ENG1|Tore|2011}}
{{Fußball Einsatzdaten/Abfrage|James Milner|Stand}}