inhaus-plugin-monatsspruch/README.md
Friederich Loheide cb27dad0e6 Monatsspruch 1.0.0
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>
2026-09-26 16:54:56 +00:00

2.1 KiB
Raw Permalink Blame History

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

  1. bin/package erzeugt dist/monatsspruch-<version>.zip (oder das ZIP aus den Releases dieses Repositorys verwenden).
  2. Im Portal unter Administration → Plugins → Plugin hochladen das ZIP wählen.
  3. 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