Search by

schachbulle / contao-wertungsportal-bundle

Samson1964

Bindet das Wertungsportal des Deutschen Schachbundes über dessen REST-Schnittstelle in Contao ein und löst die ältere DeWIS-SOAP-Schnittstelle ab.

Package info

github.com/Samson1964/contao-wertungsportal-bundle

Type:contao-bundle

pkg:composer/schachbulle/contao-wertungsportal-bundle

Statistics

Installs: 98

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0


README

Ersetzt die SOAP-Schnittstelle von DeWIS und kommuniziert mit der REST-Schnittstelle des Wertungsportals.

Dokumentation

  • Insert-Tags mit Wertungsdaten — {{dwz::…}}, {{elo::…}}, {{ftitel::…}} und {{verein::…}} mit der NU-Nummer (früher Helper-Bundle mit DeWIS-ID)
  • Adressen der Frontend-Seiten — Karteikarte, Verein, Verband, Turnier: Aufbau der Adressen, Suffix, alte Verweise, Unterschiede zwischen Contao 4.13 und 5
  • Zugang zur Schnittstelle: zwei Kennungen — Anmeldung per OAuth2 für Turniere und Personen und (seit 1.46.0) für die DWZ-Liste: Einstellungen, Tokendateien, Verhalten vor und nach der Umstellung bei nu, Zip-Downloads
  • Wertungsreferenten — Zuständigkeit je Verband, Funktions-E-Mail, Kontaktdaten aus der Adressverwaltung (contao-adressen-bundle); Frontend-Modul „Wertungsreferenten (Tabelle)"
  • Reklamationen zu den DWZ-Daten — Formular in einer Lightbox für angemeldete Mitglieder, an den Wertungsreferenten der Ansicht oder den DSB-Admin, mit Backend-Modul
  • Beispielskript für eigene Anwendungen — eine eigenständige PHP-Klasse samt fünf Beispielen, ohne Contao und ohne Composer; gedacht zur Weitergabe an Vereine, Verbände und andere Umsysteme
  • Turnierseiten: Nichtmitglieder und Erwartungswerte — warum Nichtmitglieder keine neue DWZ bekommen, woher ihre Eingangswertung stammt und wie der Erwartungswert je Partie im Spielberichtsbogen zustande kommt
  • Vereinslisten-Schnittstelle — Mitgliederlisten als JSON für Vereinswebsites: Abruf, Zugangsschlüssel, Verwaltung und Sperren
  • Zwischenspeicher gezielt leeren — Backend-Modul, das die Cache-Einträge eines einzelnen Turniers, Spielers oder Vereins löscht
  • Rohdaten der Schnittstelle herunterladen — Backend-Modul, das die unveränderte Antwort einer Schnittstellenfunktion als JSON-Datei liefert
  • Turnierdaten nachts vorladen — Cronjob, der Turnierdaten und Karteikarten in den Zwischenspeicher holt, damit nicht der erste Besucher wartet
  • Massenabfragen bremsen — Höchstabrufe je Minute, Stunde und Tag; gebremste Besucher stehen mit Adresse, Browserkennung und Mitglied im Protokoll
  • Unmögliche Werte protokollieren — Zahlen, die es nach dem Regelwerk nicht geben kann, mit Spieler und Turnier festhalten und an nu melden
  • Ranglisten — fertige Deutschland-Ranglisten nach DWZ und Elo, für andere Bundles abrufbar: Altersklasse, Geschlecht, geteilte Plätze, Verbandskürzel
  • DWZ-Dateien herunterladen und aufbereiten — die beiden Konsolenbefehle, die die früheren Cron-Skripte ersetzen (Aufruf beim Hoster umstellen!)
  • Hintergrunddateien für Swiss-Chess — LST und SWX aus der DWZ-Liste erzeugen, für Swiss-Chess 10 und für ältere Fassungen

Voraussetzungen

Contao 4.13 oder 5, PHP 7.4 bis 8.4.

Frank Binding