Beschreibung

„Dashboard for Availio“ bindet die Platzbelegung deines Vereins aus Availio (der Buchungsplattform von Fairgate) direkt in WordPress ein. Die Daten werden serverseitig über die offizielle Fairgate Standard-API (FSA) geholt und als übersichtliches, TV-taugliches Belegungsraster aller Plätze dargestellt – inklusive Datumsauswahl zum Blättern durch die kommenden Tage.

Der API-Token bleibt ausschliesslich auf dem Server; er wird nie an den Browser gesendet.

Funktionen

Belegungsraster aller Plätze für den gewählten Tag (frei / belegt / laufend)
Datumsauswahl mit Vor- und Zurück-Navigation
Automatische Aktualisierung in einstellbarem Intervall
Konfigurierbarer Anzeigezeitraum, Slot-Grösse und Zeitzone
Anpassbares Farbschema (Farbwähler in den Einstellungen)
Optionaler Platz-Filter (nur ausgewählte Plätze anzeigen)
Einbindung über den Shortcode [availio_dashboard]
Token bleibt serverseitig, keine Zugangsdaten im HTML/JS

Bitte beachte: Die Fairgate Standard-API liefert Reservationen als anonyme Zeitfenster (ohne Spielernamen). Das Dashboard zeigt daher die Belegung an, nicht die Namen der buchenden Personen.

Dieses Plugin ist ein inoffizielles, von der Community entwickeltes Projekt und steht in keiner Verbindung zu Fairgate AG. „Availio“ und „Fairgate“ sind Marken ihrer jeweiligen Inhaber.

Externe Dienste

Dieses Plugin verbindet sich mit der Fairgate Standard-API (FSA), betrieben von Fairgate AG, um die Platzbelegung deines Vereins abzurufen und anzuzeigen. Ohne diese Verbindung kann das Dashboard keine Daten anzeigen.

Anbieter: Fairgate AG (Standard-Basis-URL: https://fsa.fairgate.ch).
Zweck: Abruf der Reservationen und der Platzliste zur Anzeige.
Wann: serverseitig bei jedem Aufruf einer Seite mit dem Shortcode sowie bei den Auto-Refresh-/AJAX-Anfragen.
Übertragene Daten: deine konfigurierte Organisations-ID (OID) und dein API-Token (zur Authentifizierung) sowie der abgefragte Zeitraum bzw. das Datum. Es werden KEINE Daten deiner Website-Besucher an den Dienst übertragen.

Nutzungsbedingungen: https://fairgate.ch/agb-standard/
Datenschutzerklärung: https://fairgate.ch/datenschutzerklarung/

Installation

Lade das Plugin als ZIP über Plugins Installieren Plugin hochladen hoch und aktiviere es (oder kopiere den Ordner dashboard-for-availio nach wp-content/plugins/).
Gehe zu Einstellungen Dashboard for Availio und trage deine Zugangsdaten ein:
- Organisations-ID (OID) deines Vereins
- API-Token aus deinen Availio-Einstellungen
Passe optional die Anzeige-Optionen an (Zeitraum, Slot-Grösse, Auto-Refresh, Farben, Platz-Filter).
Füge den Shortcode [availio_dashboard] auf einer Seite, in einem Beitrag oder Widget ein.

Den API-Zugang (OID und Token) erhältst du über deinen Availio-/Fairgate-Vertrag; die FSA muss für deine Organisation freigeschaltet sein.

Wichtig – die richtige Authentifizierungsmethode wählen: Wähle in Availio unter „Authentifizierungsmethoden“ den spezifischen kurzen API-Token (langlebig, ohne Ablaufzeit). Die JWT-Option läuft automatisch ab, wodurch das Dashboard nicht mehr funktioniert, bis du den Token erneuerst. Der spezifische API-Token wird auf Anfrage vom Fairgate-Support eingerichtet.

FAQ

Woher bekomme ich die OID und den API-Token?

Beides stammt aus den Availio-/Fairgate-Einstellungen deiner Organisation. Die Fairgate Standard-API (FSA) muss für dein Konto gebucht/freigeschaltet sein.

Welche Authentifizierungsmethode soll ich in Availio wählen?

Wähle den spezifischen kurzen API-Token (langlebig, ohne Ablaufzeit), nicht die JWT-Option. Ein JWT läuft automatisch ab, wodurch das Dashboard nicht mehr funktioniert, bis du einen neuen Token einträgst. Der spezifische API-Token wird auf Anfrage vom Fairgate-Support eingerichtet.

Mein Dashboard zeigt „Token ungültig oder abgelaufen (HTTP 401)“

Dein Token ist abgelaufen oder nicht mehr gültig. Trage in den Einstellungen einen neuen Token ein. Damit das nicht wieder passiert, wechsle in Availio auf den spezifischen kurzen API-Token (siehe oben). Das Plugin zeigt zudem einen Admin-Hinweis, bevor ein Token abläuft.

Werden die Namen der buchenden Personen angezeigt?

Nein. Die offizielle FSA liefert Reservationen als anonyme Zeitfenster. Das Dashboard zeigt daher nur, wann ein Platz belegt ist, nicht von wem.

Ist der Token sicher?

Ja. Der Token bleibt serverseitig und wird nur für die API-Anfrage verwendet. Das ausgelieferte HTML enthält nur die fertigen Belegungs-Kacheln.

Kann ich die Zugangsdaten ausserhalb der Datenbank speichern?

Ja. Definiere die Werte als Konstanten in deiner wp-config.php, dann werden sie statt der Datenbank-Einstellungen verwendet:

define('AVAILIO_OID', 'your-oid');
define('AVAILIO_ACCESS_KEY', 'your-token');
define('AVAILIO_BASE_URL', 'https://fsa.fairgate.ch'); // optional

Ist eine Konstante gesetzt, wird das entsprechende Feld auf der Einstellungsseite nur lesend angezeigt.

Kann ich nur bestimmte Plätze anzeigen?

Ja, über den Platz-Filter in den Einstellungen (kommagetrennte Platz-IDs).

Rezensionen

Zu diesem Plugin liegen noch keine Rezensionen vor.

Mitwirkende und Entwickler

„Dashboard for Availio“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:

gianlucad

„Dashboard for Availio“ wurde in 1 Sprache übersetzt. Danke an die Übersetzer für ihre Mitwirkung.

Übersetze „Dashboard for Availio“ in deine Sprache.

Interessiert an der Entwicklung?

Durchstöbere den Code, sieh dir das SVN-Repository an oder abonniere das Entwicklungsprotokoll per RSS.

Änderungsprotokoll

1.2.1

Tested with WordPress 7.1.

1.2.0

Neu: Ein Admin-Hinweis warnt, bevor der API-Token abläuft (und wenn er abgelaufen ist) – ausgelesen aus dem Ablaufdatum des Tokens.
Doku: Empfehlung, in den Availio-Authentifizierungseinstellungen den spezifischen kurzen API-Token (langlebig) statt JWT zu verwenden.

1.1.3

Vorbereitung für WordPress.org: Offenlegung externer Dienste, Sicherheits-Härtung, Plugin-Name „Dashboard for Availio“, englische readme.

1.1.2

Neu: Der Club-Name wird als Titel über dem Dashboard angezeigt (wenn gesetzt).

1.1.1

Fix: Datumsauswahl-Pfeile und Tabs folgen jetzt dem Farbschema (Theme-Übersteuerung verhindert).

1.1.0

Neu: anpassbares Farbschema (Farbwähler in den Einstellungen).
Neu: fertige Farb-Voreinstellungen (ein Klick).
Neu: Zugangsdaten optional über wp-config.php-Konstanten.

1.0.0

Erste öffentliche Version.

Beschreibung

Externe Dienste

Installation

FAQ

Woher bekomme ich die OID und den API-Token?

Welche Authentifizierungsmethode soll ich in Availio wählen?

Mein Dashboard zeigt „Token ungültig oder abgelaufen (HTTP 401)“

Werden die Namen der buchenden Personen angezeigt?

Ist der Token sicher?

Kann ich die Zugangsdaten ausserhalb der Datenbank speichern?

Kann ich nur bestimmte Plätze anzeigen?