schachbulle / contao-vereinsregister-bundle
Vereinsregister des Deutschen Schachbundes mit Suche und Vereinsdetails im Frontend.
Package info
github.com/Samson1964/contao-vereinsregister-bundle
Type:contao-bundle
pkg:composer/schachbulle/contao-vereinsregister-bundle
Requires
- php: ^7.4 || ^8.0
- codefog/contao-haste: ^5.0
- contao/core-bundle: ^4.13 || ^5.0
- menatwork/contao-multicolumnwizard-bundle: ^3.6 || ^4.0
- schachbulle/contao-helper-bundle: ^2.0
Requires (Dev)
- contao/manager-plugin: ^2.0
Suggests
None
Provides
None
Conflicts
- contao/core: *
- contao/manager-plugin: <2.0 || >=3.0
Replaces
None
README
Vereinsregister des Deutschen Schachbundes für Contao 4.13 und Contao 5.
Das Bundle verwaltet Schachvereine mit ihrer Geschichte: Stammdaten, Chronik, frühere Namen, Vorsitzende und Mitglieder. Vereine lassen sich untereinander in Beziehung setzen — Vorgänger, Aufspaltungen und Nachfolger samt Grund der Nachfolge. Im Frontend zeigt ein Modul diese Angaben an und stellt sie anderen Erweiterungen über Insert-Tags zur Verlinkung bereit.
Installation
composer require schachbulle/contao-vereinsregister-bundle
Danach im Contao-Manager oder auf der Kommandozeile die Datenbank aktualisieren:
vendor/bin/contao-console contao:migrate
Backend
Das Backend-Modul Vereinsregister liegt im Bereich Inhalte. Zu jedem Verein führen vier Schaltflächen in die zugehörigen Datenbereiche: Chronik, Namen, Vorsitzende und Mitglieder.
Datumsangaben werden in den Formaten JJJJ, MM.JJJJ oder TT.MM.JJJJ
erfasst — für historische Angaben, bei denen oft nur das Jahr bekannt ist.
Einstellungen
Unter System → Einstellungen im Abschnitt Vereinsregister:
| Einstellung | Bedeutung |
|---|---|
| Detailseite | Die Seite, auf der das Frontend-Modul „Vereinsdetails" eingebunden ist. Ohne diese Angabe bleiben alle Vereinsnamen unverlinkt — auch die, die andere Erweiterungen ausgeben. |
| Bildgröße | Größe, auf die Bilder in den Frontend-Modulen gebracht werden. Ohne Angabe erscheinen sie in Originalgröße. |
Frontend-Modul „Vereinsdetails"
Das Modul arbeitet in zwei Zuständen:
- Mit Verein in der Adresse (
/verein/<ID>) zeigt es die Detailansicht mit vier Bereichen: Stammdaten samt Chronik, Namen, Vorsitzende, Mitglieder. - Ohne Verein zeigt es eine alphabetische Auswahlliste mit Suchfeld. Gesucht wird über den aktuellen Namen und über die früheren Namen, damit ein Verein auch unter seiner alten Bezeichnung gefunden wird.
Die vier Bereiche werden auf einmal ausgeliefert; erst das mitgelieferte Skript macht daraus eine Reiterleiste. Ohne JavaScript bleibt die Seite als Liste untereinander vollständig lesbar.
Ausführlich beschrieben ist das Modul samt Templates und CSS-Klassen in docs/frontend.md.
Insert-Tags
| Insert-Tag | Ergebnis |
|---|---|
{{vereinsregister_url::12}} |
Nur die Adresse der Detailseite des Vereins 12 |
{{vereinsregister_link::12}} |
Fertiger Textlink, beschriftet mit dem Vereinsnamen |
{{vereinsregister_link::12::Unser Verein}} |
Fertiger Textlink mit eigenem Text |
Ist keine Detailseite eingerichtet oder der Verein unveröffentlicht, kommt der Linktext unverlinkt zurück statt eines toten Links.
Für andere Erweiterungen
use Schachbulle\ContaoVereinsregisterBundle\Klassen\Helper; $strUrl = Helper::getVereinslink($intVereinsId);
Die Methode liefert eine leere Zeichenkette, wenn keine Detailseite eingerichtet ist — der Aufrufer soll den Namen dann unverlinkt ausgeben.
Anforderungen
- PHP 7.4 oder neuer
- Contao 4.13 LTS oder Contao 5
Lizenz
LGPL-3.0-or-later