Dokumentation

Installation und Konfiguration

Installiere die jeweilige ZIP-Datei (nicht vorher entpacken) direkt im Joomla Backend Bereich unter "Erweiterungen / Installieren". Anschließend kannst du unter "Erweiterungen / Module" die Konfiguration vornehmen:

Liga: 'bl1' für die 1. Bundesliga oder 'bl2' für die 2. Bundesliga

Saison
: Für die Bundesliga Saison 2019/2020 lautet der Wert '2019'

Spieltag
: Der standardmäßig anzuzeigende Spieltag. 0 zeigt automatisch den aktuellen Spieltag an, -1 den Vorherigen.

Timeout
: Sekunden, wie lange auf eine Antwort vom Webservice gewartet werden soll. Bei einem Timeout werden die Daten aus dem Cache geladen bzw. wenn keine (aktuellen) Daten im Cache sind die unter Fehlermeldung Timeout konfigurierte Fehlermeldung angezeigt.

Kompaktansicht: In der Kompaktansicht werden die Partien nicht nach Anstoßzeiten gruppiert.

Lange Vereinsnamen anzeigen:
Wenn aktiv, wird immer der komplette Vereinsname im Ergebnis-Modul angezeigt

Verein hervorheben: 
Verein auswählen, dessen Spiele hervorgehoben werden sollen

Verein hervorheben CSS
: Stylesheet wie der ausgewählte Verein hervorgehoben werden soll

Es können mehrere Modul Instanzen angelegt werden (Beispielsweise um Liga 1 und 2 anzuzeigen).

Fehlerbehandlung


Zurzeit können keine Daten vom Webservice abgerufen werden :-(

Voraussetzung für die Anzeige aktueller Daten ist, dass der OpenLigaDB Webservice online ist und dein Webserver, auf dem Joomla läuft, zur Webservice URL (z.B. https://www.openligadb.de/api/getcurrentgroup/bl1) connecten kann.

Mit dem Debug Script aus dem Downloadbereich kann geprüft werden, ob die generelle Verbindung zwischen Webserver und Webservice funktioniert. Lade hierzu die PHP Datei auf deinen Webserver und rufe sie im Webbrowser auf. Sollte keine Verbindung zum Webservice möglich sein, wird der Zugriff womöglich durch eine Firewall oder eine Konfigurationseinstellung auf dem Webserver verhindert (cURL oder allow_url_fopen muss aktiviert sein). In diesem Fall solltest du dich zur Freischaltung an den Webserver-Betreiber bzw. an den Webhosting Provider wenden.

Es wird nur die Ladegrafik angezeigt oder Fehlermeldung: Fehlerhafter JSON Response

Prüfe in diesem Fall die AJAX Antwort des Moduls mit den Entwicklungswerkzeugen deines Browsers (F12). Fehlerursache ist meistens ein anderes (ggf. fehlerhaftes) Joomla Plugin oder extern eingebundenes Script, welches den JSON Response der Bundesligamodule zerschießt.

Firebug Deaktiviere in diesem Fall das betreffende Plugin bzw. prüfe die Konfigurationseinstellungen des Plugins.

Die Tooltips werden nicht korrekt angezeigt 

Für die Tooltips kommt das Bootstrap Framework zum Einsatz. Sofern in deinem aktiven Joomla Template kein Bootstrap eingebunden ist, fehlen die benötigten CSS Klassen für die Formatierung der Tooltips.
Die benötigten Stylesheets können unter http://getbootstrap.com/customize/ heruntergeladen werden (Es sollte ausreichen, dort nur den Punkt Tooltips auszuwählen) und in dein Template integriert werden.


Update

Es wird die automatische Update-Funktion von Joomla genutzt. Sobald es ein Update gibt, wirst du im Backend Bereich darüber informiert. (Manuelle Suche nach Updates via "Erweiterungen / Aktualisieren / Aktualisierungen suchen")
Alternativ kannst du auch die aktuellste Version aus dem Download Bereich herunterladen und wie unter Installation beschrieben einspielen. Das manuelle Einspielen der aktuellen Version ist auch einmalig erforderlich, wenn du noch eine Uralt-Version der Module ohne automatischer Update-Funktion einsetzt.


Vereinsnamen

Die Vereinsnamen können in der Datenbanktabelle *_buliergebnisse in den Feldern "bezeichnung_kurz" (Kürzel während des laufenden Spieltags) bzw. "bezeichnung_mittel" (für zukünftige Spieltage) angepasst werden.
Änderungen sind jedoch nicht updatesicher (und müssen daher nach einem Update erneut vorgenommen werden). Die Bezeichnungen im Feld "bezeichnung_webservice" dürfen nicht abgeändert werden!


Saisonübergang

Zur Anzeige von neuen Vereinen und deren Logos müssen die Module auf die neueste Version aktualisiert werden. Sobald die neue Saison bei OpenLigaDB angelegt wurde (in der Regel kurz nach Bekanntgabe des Spielplans durch die DFL) wird zeitnah ein Update veröffentlicht. Das Spielplan Modul ist derzeit nur kompatibel mit der jeweils aktuellen Saison (nicht rückwirkend).

Individuelle Anpassung per CSS (z.B. Breite)

In der Konfiguration der Module kann unter "Erweitert" ein eigener Modul-Klassen-Suffix gewählt werden, um das Modul per CSS individuell gestalten zu können. Um beispielsweise die Breite des Moduls auf 250 Pixel zu setzen den Modul-Klassen-Suffix auf "ergebnisse" stellen und folgendes CSS in dein Template aufnehmen:

.ergebnisse {
  width: 250px;
}


Weitere Fragen oder Anregungen zu den Modulen?

Nutze das Kontakformular