janborg/contao-h4a_tabellen

Spielpläne und Tabellen von handball4all in Contao CMS integrieren

2.5.0 2024-12-07 16:03 UTC

Requires

• php: ^8.0
• codefog/contao-haste: ^5.0
• contao/calendar-bundle: ^4.13 || ^5.3
• contao/core-bundle: ^4.13 || ^5.3
• doctrine/dbal: ^3.6
• mvo/contao-group-widget: ^1.5
• symfony/config: ^5.4 || ^6.0
• symfony/console: ^5.4 || ^6.0
• symfony/dependency-injection: ^5.4 || ^6.0
• symfony/dom-crawler: ^5.4 || ^6.0
• symfony/http-client: ^5.4 || ^6.0
• symfony/http-foundation: ^5.4 || ^6.0
• symfony/http-kernel: ^5.4 || ^6.0

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.5
• contao/easy-coding-standard: ^6.0
• contao/manager-plugin: ^2.0
• contao/test-case: ^5.0
• phpstan/phpstan: ^1.10
• phpstan/phpstan-phpunit: ^1.3
• phpstan/phpstan-symfony: ^1.2
• phpunit/phpunit: ^9.5
• shipmonk/composer-dependency-analyser: ^1.7
• symfony/phpunit-bridge: ^7.1

Suggests

• janborg/contao-h4a_gamestats: to get scores and gamestats for all your games

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

MIT

• Jan Lünborg

• tabelle
• Handball
• H4a
• Ergebnisse
• Spielplan

README

Features

• Contentelemente zur Anzeige der Spiele eines Teams oder einer Liga
• Contentelement zur Anzeige der aktuellen Tabelle einer Liga
• Import der Spiele einer Mannschaft in einen Contao-Kalender
• tägliches Update der Spiele in einem Contao-Kalender
• stündliches Update der Ergebnisse der Spiele im Contao-Kalender

(IDs der Ligen und Mannschaften kann der Verein in seinem Vereinsaccount abrufen)

Funktionen

Elemente

Es stehen die folgenden Content-Elemente zur Verfügung.

Spielplan Team

Bei diesem Elementtyp stehen folgende Eingabefelder zur Verfügung:

1. Überschrift
2. Team ID: eine 6-stellige ID der Mannschaft, die der Übersicht im Vereinsaccount von handball4all entnommen werden kann
3. Mein Team: Hier muss manuell die genaue Bezeichnung der Mannschaft eingegeben werden. Im Frontend kann dann über die CSS Klasse "myteam" eine Hervorhebung der Mannschaft erfolgen

Hier ein Beispiel:

Tabelle Liga

Bei diesem Elementtyp stehen folgende Eingabefelder zur Verfügung:

1. Überschrift
2. Liga ID: eine 5-stellige ID der anzuzeigenden Liga, die der Übersicht im Vereinsaccount von handball4all entnommen werden kann
3. Mein Team: Hier muss manuell die genaue Bezeichnung der Mannschaft eingegeben werden. Im Frontend kann dann über die CSS Klasse "myteam" eine Hervorhebung der Mannschaft erfolgen.

Hier ein Beispiel:

Spielplan Liga

Bei diesem Elementtyp stehen folgende Eingabefelder zur Verfügung:

1. Überschrift
2. Liga ID: eine 5-stellige ID der anzuzeigenden Liga, die der Übersicht im Vereinsaccount von handball4all entnommen werden kann
3. Mein Team: Hier muss manuell die genaue Bezeichnung der Mannschaft eingegeben werden. Im Frontend kann dann über die CSS Klasse "myteam" eine Hervorhebung der Mannschaft erfolgen

Aktuelle Spiele Verein

Bei diesem Elementtyp stehen folgende Eingabefelder zur Verfügung:

1. Überschrift
2. Verein ID: eine ID des anzuzeigenden Vereins, die der Übersicht im Vereinsaccount von handball4all entnommen werden kann
3. Mein Team: Hier muss manuell die genaue Bezeichnung der Mannschaft eingegeben werden. Im Frontend kann dann über die CSS Klasse "myteam" eine Hervorhebung der Mannschaft erfolgen.

Kalender

Anlegen eines neuen Kalenders für einen Mannschaft

Es besteh die Möglichkeit für die Spiele einer Mannschaft einen eigenen Contao Kalender anzulegen, um dann die Contao Standard-Module zur Ansicht der Spiele zu nutzen. Dazu muss man beim Anlegen eines neuen Kalenders lediglich das Häkchen "Handball4all Update" aktivieren und die entsprechenden Felder füllen.

Dann am Besten mit "Speichern und Bearbeiten" schließen und in der Ansicht "Bearbeiten" des Kalenders auf "Update H4a Events" klicken.

Über einen CronJob werden dann für jeden Kalender, bei dem das Häkchen "Handball4all Update" gesetzt ist, einmal am Tag die Spiele aktualisiert, falls sich Termine ändern sollten

Außerdem wird über einen CronJob stündlich geprüft, ob für die Spiele neue Ergebnisse vorliegen und diese ebenfalls aktuaisiert.

Handball4all:

Nur Handballvereine folgender Verbände bzw. Oberligen dürfen die Daten verwenden

• Badischer HV
• Hamburger HV
• HV Rheinhessen
• HV Saar
• HV Schleswig-Holstein
• Pfälzer HV
• Südbadischer HV
• HV Westfalen
• HV Württemberg
• Oberliga Rheinland-Pfalz/Saar
• Fédération Luxembourgeoise de Handball
• Vorarlberger HV

Jede weitere Verwendung der Schnittstellen bzw. der abgerufenen Daten ist nicht erlaubt. Dies gilt insbesondere für die Darstellung auf Webseiten die:

• nicht vereinsbezogen sind,
• mehrere Ligen und/oder mehrere Vereine darstellen, sofern keine Spielgemeinschaft besteht und/ oder
• als Portalseiten ein möglichst weitreichendes Abbild unserer Daten verfolgen.