Inhaus-Plugin: Monatsspruch der ÖAB als Kachel auf der Startseite
Monatsspruch der ÖAB als Startseiten-Kachel für Inhaus (ab 0.12.0): automatischer Abruf von oeab.de, eigene Angaben je Monat, Admin-Seite, Packskript für das installierbare ZIP, Tests. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| bin | ||
| src | ||
| tests | ||
| .gitignore | ||
| plugin.json | ||
| README.md | ||
Inhaus-Plugin „Monatsspruch“
Zeigt den Monatsspruch der Ökumenischen Arbeitsgemeinschaft für Bibellesen (ÖAB) als Kachel auf der Startseite des Inhaus-Mitarbeiterportals.
- Lädt die Monatssprüche eines Jahres automatisch von oeab.de/monatssprueche (einmal im Monat; ab Dezember auch das kommende Jahr) und speichert sie – fällt oeab.de aus, bleibt der Spruch stehen.
- Kachel mit Text, Bibelstelle, Übersetzung und Quellenhinweis; Position und Sichtbarkeit wie jede Kachel unter Administration → Portal → Startseite.
- Administration → Portal → Monatsspruch: Übersicht des Jahres, „Jetzt laden“ und eigene Angaben für einzelne Monate (z. B. bei Abruffehlern).
oeab.de bietet keine Schnittstelle; gelesen wird die öffentliche Jahresseite. Ändert sich deren Aufbau, meldet die Admin-Seite den Fehler, und der zuletzt geladene Spruch bleibt sichtbar. Bitte klären Sie die Nutzung der Bibeltexte (Übersetzungen) mit der ÖAB bzw. den Verlagen.
Voraussetzungen
Inhaus 0.12.0 oder neuer (nutzt die allgemeine Kachel core::Quote – kein eigener Build nötig).
Installation
bin/packageerzeugtdist/monatsspruch-<version>.zip(oder das ZIP aus den Releases dieses Repositorys verwenden).- Im Portal unter Administration → Plugins → Plugin hochladen das ZIP wählen.
- Plugin aktivieren – die Sprüche werden sofort geladen.
Entwicklung und Tests
Das Plugin in eine Inhaus-Entwicklungsumgebung nach plugins/monatsspruch kopieren oder
verlinken, dort aktivieren und die Tests aus dem Inhaus-Verzeichnis ausführen:
vendor-dev/bin/phpunit plugins/monatsspruch/tests
Aufbau:
| Datei | Zweck |
|---|---|
plugin.json |
Manifest (Name, Version, Mindestversion von Inhaus) |
src/MonatsspruchPlugin.php |
Kachel und Hintergrundaufgabe registrieren |
src/OeabParser.php |
Monatssprüche aus der Jahresseite lesen |
src/Verses.php |
Laden, Speichern, eigene Angaben |
src/Filament/Pages/MonatsspruchSettings.php |
Admin-Seite |
tests/ |
Tests inkl. gespeicherter Beispielseite |