| 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.
Updates
Ab Version 1.1.0 aktualisiert sich das Plugin über Inhaus (ab 0.24.0): Inhaus prüft täglich
die Releases dieses Repositorys (update_url in plugin.json) und zeigt unter
Administration → Plugins „Update verfügbar“ mit „Jetzt aktualisieren“.
Neue Version veröffentlichen: Version in plugin.json erhöhen, bin/package, Release
v<version> mit dem ZIP als Anhang anlegen.
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 |