# World Cup Predictor

Ein Plugin um ein Tippspiel für die Fußball-WM 2010 durchzuführen.
Plugin to manage and present a fantasy football (soccer) competition for the FIFA World Cup 2010

Contributors:Landoweb Programador
Donate link: https://wcp.net.br/donate/
Tags: prediction, fantasy football, competition, soccer, football, fantasy, sidebar, widget, post
Tippspiel, Fußball, Wettkampf, Artikel, Seite
Requires at least: 2.8
Tested up to: 6.7
Stable tag: 0.4.2; 1.0; 1.1

### Beschreibung

Mit diesem Plugin kann ein Tippspiel für die WM 2010 durchgeführt werden

Benutzer tippen das Ergebnis für jedes Spiel in der Gruppenphase und der Finalrunde und bekommen, je nach Richtigkeit, dafür Punkte.

Spielergebnisse und Tabellen können ebenfalls mittels Short-Codes angezeigt werden

Features

- einfaches hinzufügen von Spielen, Austragungsorten und Ergebnissen
- Formular für die Tippabgabe der Benutzer für die einzelnen Spiele
- Widget für die Sidebar zum anzeiogen der Tipp-Tabelle
- Widget für die Sidebar zur Anzeige der Tipps des aktullen Benutzers
- Countdown zur Anzeige des nächsten Tippabgabeschluss
- Anzeige von Ergebnissen und Gruppen Tabellen
- Konfiguriebares Punktesystem für das Tippspiel

### Installation

Zum installieren die folgenden Schritte durchführen

1. Entpacke die zip Datei lade den Inhalt in das Wordpress Plugin Verzeichnis. Normalerweise /wp-content/plugins
2. Aktiviere das Plugin unter Plugins im Backend.
3. Konfiguriere das Plugin im Backend.

### Anmerkung zum Update

Die Datenbankstruktur wurde zwischen den Versionen 0.2 und 0.3 sowie 1.0 und 1.1 verändert. Nach dem Update das Plugin einmal de- und danach wieder aktivieren. Damit werden die neuen bzw. erweiterten Tabellen erstellt. Danach nocheinmal den Import durchführen

Eine Anleitung der Konfiguration findest du Anschluss.

### Frequently Asked Questions

- Warum sind es 64 Mannschaften? - In dem Import sind Platzhalter zum füllen der Finalrunde enthalten. Diese müssen nach Abschluss der Vorrunde mit den Mannschaften ersetzt werden

### Screenshots

1. Tippformular
2. Gruppentabelle mit Ergebnissen
3. Admin Fenster
4. Übersicht
5. Tipps
6. Finalrunde

### Changelog

ChangeLog

### Anleitung

Nach der Insatallation und Aktivierung findest du auf der Übersichtsseite einen Import Button zum importieren aller Mannschaften, Spiele und Austragungsorte. Import ist in englisch

Überprüfe die Zeitzonen-Einstellungen. Eine Differenz zwischen der lokalen und der Südafrika Zeit sollten angezeigt und entsprechend im Eingabefeld eingetragen werden. Falsche Einstellungen können dazu führen das der Tippabgebeschluss nciht mit offiziellen Anstoßzeit übereinstimmt

Die Datums- und Zeitangaben sind nach der Südafrika Zeit angegeben (UTC + 2)

Um die Verwaltung der Spiele,Mannschaften usw. durchführen zu können werden Wordpressrechte für wcup_manger benötigt. Diese Rechte werden als Standard der Administrator- und Editor Rolle automatisch hinzugefügt. Falls die Menü-Option World Cup nicht zur Verfügung steht, überprüfe ob dem entsprechenden Benutzer die wcup_manger Rolle zugewiesen ist. Eventuell muss ein entsprechdes Plugin zur Verwaltung der Benutzerrolen nachinstalliert werden.

Registrierte Benutzer des Blogs benötigen keine besonderen Rechte um am Tippspiel teilzunehmen.

#### Tipps

Erstellen einen Artikel oder eine Seite mit dem Shortcode [world-cup-predictor] um das Tipp-Eingabeformular im Frontend anzuzeigen
Other shortcodes are available to display prediction results and match results. See below for more details.

Benutzer können nur Spiele tippen die noch nicht begonnen haben. Wenn die Anstoßzeit erreicht ist wird ein Spiel nicht mehr im Forular angezeigt

#### Ergebnisse

Wenn ein Spiel beendet ist, gehe ins Backend und trage das Ergebnis in die entsprechenden Felder ein und markiere die Checkbox Spiel beendet. Die Tabellen und Ergebnisse im Frontend werden dann aktuallisiert angezeigt

Hat sich eine Mannschaft als Gruppen Erster oder -Zweiter für das Achtelfinale qualifiert, ändere die Spiele für die Finalrunde tausche den Platzhalter gegen die entsprechende Mannschaft aus. Als Beispiel, wenn Südafrika die Gruppe A gewinnt, ändere das Spiel Nr. 49 und tausche den Platzhalter "Sieger Gruppe A" gegen "Südafrika" aus.

Diese Änderung wird dann in der Finalrunden Übersicht angezeigt.

#### Optionen

Zur Zeit keine

#### Punkte kalkulieren

Ergebnisse: Wenn ein Spiel beendet ist und das Ergebnis eingetragen wurde und das Spiel als beendet markiert ist, werden Punkte und Tabbelen aktuallisiert und im Frontend entsprechend angezeigt

Tippspiel: Um die Punkte der Benutzer zu aktuallisieren, wähle den Tab "Punkte berechnen" unter "Tippspiel" im Admin Menü aus, markiere die neu beendeten Spiele und klicke dann unten auf "Punkte berechnen". Damit werden die Punkte aktuallisiert und in den Widgets und per Shortcut angzeigten übersichten angezeigt.

Punkte werden entsprechend der Punkte Konfiguration vergeben.

Anmerkung - Bonuspunkte sind kommulativ und werden den entsprechenden Punkte für das richtige Ergebnis oder des richtigen Unentschieden-Tipps hinzu gezählt.

Achte daher darauf das Bonuspunkte für die Toranzahl und der Tordifferenz jeweils zu den vorher vergebenen Punkte für den richtigen Tip hinzugezählt werden, weil die Tordifferenz ja richtig ist. Die Bonuspunkte für für die Tordifferenz werden ebenfalls bei richtigem Unentschieden Tipp hinzugezählt. Passe dementsprechende die Punktevergabe an, falls Bonuspunkte vergeben werden

#### Shortcodes

##### Tipp-Formular

Das Tipp-Formular sowie die Spielergebnisse und Tippspiel Ergebnisse können mit den folgenden Shortcodes auf einer Seite oder einem Artikel angezeigt werden.

    [world-cup-predictor]

Zeigt ein Tipp Formular für alle angelegten Spiele, wo die Anstoßzeit vor der aktuellen Zeit liegt. Ebenfalls wird ein Countdown bis zum nächsten Tippabgabeschluß angezeigt. Spiele die zum Zeitpunkt des Aufrufens der Seite bereits begonnenn haben erscheinen nicht in der Übersicht und können nicht mehr von den Benutzern getippt werden.

Mit dem Attribut stage=n kann die Ansicht auf eine bestimmte Runde eingeschränkt werden. n ist mit der entsprechenden ID der Runde zu ersetzen.
Beispiel für die Runde mit der ID 1

    [world-cup-predictor stage=1]

Um nur Spiele der Gruppenphase anzuzeigen, kann das Attribut group=true genutzt werden z.B. [world-cup-predictor group=true].

Um Spiele in der Reihenfolge der Anstoßzeit anzuzeigen kann das Attribut kickoff=true genutzt werden. Zusätzlich kann die Anzeige auf eine bestimmte Anzahl limmitiert werden z.B. [world-cup-predictor kickoff=true limit=5] zur Anzeige der nächsten 5 Spiele.

#####
Tabellen der Gruppen

    [world-cup-predictor tables=1 stage=n show_results=n]

Zeigt die Tabllen der Gruppen mit den einzelnen Spielen uind den Ergebnissen sobald die Spiel als beendet gekennzeichnet wurden und das Ergebnis eingetragen wurde. Die Attribute können Optinal gesetzt werden um die Anzeige auf Gruppen - stage=n wobei n der ID der jeweiligen Gruppe entspricht, Tabellen oder Ergebnisse results=n wobei n 0 oder 1 entspricht um die Ergebnisse anzuzeigen oder auszublenden, einzuschränken. Die Ergebnisse jeweils unter der Gruppentabelle angezeigt

##### Finalrunde

    [world-cup-predictor knockout=1]

Zeigt die Ergebnisse mit Spielplan der Finalrunde.

##### Ergenisse der Spiele

    [world-cup-predictor results=1 stage=n]

Zeigt eine Übersicht der Spielergebnisse. Optinal kann ein Attribute verwendet werden stage=n wobei n mit der ID der jeweiligen Runde zuersetzen ist um die Anzeige auf die bestimmte Runde einzuschränken.

##### Tipp Punkte

    [world-cup-predictor scores=n]

Für jede Spiel ID, n ersetzt hier wieder die ID des Spiels, wird eine Tabelle für jeden Benutzer mit den jeweiligen Tipps und den gewonnen Punkten angezeigt

Optional kann der aktuell angemeldete Benutzer mit dem Attribut highlight="css-styles" durch einen hinzugefügten CSS Style hevorgehoben werden.
Z.B.: [world-cup-predictor ranking=1 highlight="background:red;font-weight:bold"].

##### Tipps der Benutzer

    `[world-cup-predictor user=1 show_total=n]`

Zeigt eine Liste der Punkte für den aktuell angemeldeten Benutzer. Falls nicht 0 ist wird die Gesamtpunktzahl am unteren Ende angezeigt.

Ebenfalls können die Gesammtpunkte ohne Tabelle mit [world-cup-predictor show_total=1] angezeigt werden.

##### Tipp-Tabelle

    [world-cup-predictor ranking=1 limit=999]

Zeigt die aktuelle Tipp-Tabelle mit den Gesamtpunkten der einzelnen Benutzer an. Optional kann auch hier aktuell angemeldet Benutzer mit dem Attribut highlight="css-styles" mit CSS hevorgehoben werden. Zum Beispiel: [world-cup-predictor ranking=1 highlight="background:red;font-weight:bold"].

#### Widget für Tipp-Tabelle

Das Widget zeigt die gleiche Anzeige wie der Shortcode [world-cup-predictor ranking=1 limit=999]

Lege das Widget per drag and drop in die Sidebar und dann konfiguriere es deinen Wünschen entsprechend. Das Widget kann mehrfach mit unterschiedlichen Einstellungen in die Sidebar eingebunden werden.

Falls die URL für die Tipp-Tabelle eingetragen ist und dein entsprechender Linktext wird ein Link auf die Tipptabelle erstellt und im Widget angezeigt. Sehrt nützlich um z.B. nur die Top Ten anzuzeigen und dann auf die Gesamt-Tabelle zu verweisen

#### Tipp Widgewt für den Benutzer

Dieses Widget zeigt die Tipp-Übersicht des aktuell angemeldeten Benutzs ähnlich dem Shortcode `[world-cup-predictor user=1]`

Ziehe das Widget in die Sidebar und konfiguriere es.