Kirby
Das Orimora-Sync-Kirby-Plugin importiert die veröffentlichten Dokumente einer Ordnerfreigabe in Kirby-Pages — nach demselben Browse-Import-(Pull-)Muster wie das WordPress-Plugin: ein nur-lesendes Ordnerfreigabe-Token authentifiziert nur-lesende Aufrufe an Orimora, und du mappst jede Orimora-Kollektion auf eine Kirby-Parent-Page + ein Template. Orimora bleibt die Quelle; das Kirby-spezifische Wissen (Feldformat, Escaping) lebt im Plugin.
Orimora ──Pull-API (Bearer kb_…)──▶ Kirby-Plugin ──▶ Kirby-Pages (Quelle) (Adapter)So funktioniert es
Abschnitt betitelt „So funktioniert es“-
Gib in Orimora eine Kollektion frei (Kollektions-Menü → „Mit einem Dienst verbinden”, Ziel CMS), um ein nur-lesendes, nur-veröffentlichtes Token (
kb_…) zu erzeugen. -
Öffne in Kirby im Panel Orimora, trage unter Verbindung die URL + das Ordnerfreigabe-Token ein und klicke Verbindung speichern. Das Token wird unter
site/orimora/gespeichert; es ist nur schreibbar und wird nie wieder angezeigt.Für ein gehärtetes Setup trägst du die Verbindung stattdessen in
site/config/config.phpein. Diese Werte haben Vorrang und halten das Secret aussite/orimora/heraus:return ['orimora.sync.url' => 'https://wiki.example.com','orimora.sync.token' => 'kb_…','orimora.sync.routeKey' => '…zufall…', // optional: aktiviert die Cron-Route]; -
Unter Mapping bekommt jede freigegebene Kollektion eine Zeile: wähle ihre Kirby-Elternseite + Template + Status und klicke Mapping speichern. Lass eine Kollektion auf überspringen, um sie nicht zu importieren. Die Ziel-Elternseiten und -Templates müssen in deiner Kirby-Site bereits existieren.
-
Unter Durchsuchen & importieren lädst du die Dokumente, wählst die gewünschten aus und klickst Auswahl importieren. Jedes wird eine Page unter seiner gemappten Elternseite. Ein Badge kennzeichnet jedes Dokument als neu, importiert oder neuere Version. Bilder werden in die Page heruntergeladen und auf Kirby-
(image: …)-Tags umgeschrieben. -
Importierte aktualisieren holt Titel + Body der bereits importierten Pages neu. Es importiert nie neue Dokumente und setzt nichts auf unlisted: ein in Orimora entferntes oder unveröffentlichtes Dokument wird schlicht nicht mehr aktualisiert, seine Page bleibt, wie du sie hinterlassen hast. Das ist Kuration, kein Spiegel.
Headless-Aktualisierung (Cron)
Abschnitt betitelt „Headless-Aktualisierung (Cron)“Hält bereits importierte Pages aktuell (Titel + Body). Neue Dokumente werden dabei nicht importiert; das bleibt eine bewusste Auswahl im Panel. Entweder der Kirby-CLI-Command:
kirby orimora:syncoder die secret-geschützte Route (nach Setzen von orimora.sync.routeKey):
curl -fsS "https://deine-site.example/orimora/sync?key=<routeKey>"Mermaid-Diagramme (optional)
Abschnitt betitelt „Mermaid-Diagramme (optional)“Importierte Dokumente behalten ihre mermaid-Codeblöcke, und das Plugin schreibt sie in das
Markup um, das die Mermaid-Bibliothek rendert. Das Rendern ist Opt-in: du hostest die Bibliothek
selbst und bindest ein Snippet in dein Layout ein. Die Schritte stehen in der
Plugin-README.
Installation (aus dem Quellcode)
Abschnitt betitelt „Installation (aus dem Quellcode)“Klone das Repository orimora-kirby-importer
nach site/plugins/orimora-sync (oder klone es woanders und symlinke es dorthin):
git clone https://github.com/Orimora-app/orimora-kirby-importer site/plugins/orimora-syncDas gebaute Panel-Asset ist mit-committet, es läuft also direkt — kein Build und kein composer install zum Betrieb nötig.
Sicherheit
Abschnitt betitelt „Sicherheit“- Das Token wird entweder im Panel gesetzt (gespeichert unter
site/orimora/, nur schreibbar, nie wieder angezeigt) oder, für gehärtete Setups, inconfig.php, die Vorrang hat. Nutzt du das Panel, haltesite/orimora/aus der Versionskontrolle heraus. Die Panel-UI sieht nur, ob eine Verbindung konfiguriert ist, nie das Token selbst. - Die Vertrauensgrenze ist ausgehend: das Plugin ruft Orimora nur mit dem nur-lesenden, nur-veröffentlichten Token. Es kann weder nach Orimora schreiben noch Entwürfe offenlegen.
- Separator-Sicherheit. Inhalte werden über die Kirby Page-API geschrieben, deren Serializer
den Feld-Separator
----automatisch escaped — ein Markdown-Body mit----(Thematic Breaks, Tabellen, Setext-Überschriften) kann keine fremden Kirby-Felder injizieren (Klasse der Advisory GHSA-x5mr-p6v4-wp93). - Panel-API-Routen sind durch Kirbys Auth geschützt; die Cron-Route durch einen timing-sicheren Schlüsselvergleich.
Quelle der Wahrheit (vs. WordPress)
Abschnitt betitelt „Quelle der Wahrheit (vs. WordPress)“Anders als beim WordPress-Plugin — wo das CMS Slug/Status/SEO besitzt — besitzt hier Orimora Titel + Body, und eine Aktualisierung überschreibt sie. Sag deinen Redakteuren, dass Body-Änderungen in Kirby eine Aktualisierung nicht überleben.
Grenzen (bewusst)
Abschnitt betitelt „Grenzen (bewusst)“- Flacher Baum: die Dokumente eines Ordners landen auf einer Ebene unter der Elternseite (Verschachtelung ist geplant).
- Voller Pull bei jeder Aktualisierung: es wird die gesamte Freigabe neu geholt, nicht nur geänderte Dokumente.
- Eine Ordnerfreigabe pro Site.
Siehe auch
Abschnitt betitelt „Siehe auch“- WordPress — dasselbe Browse-Import-Muster für WordPress
- Statische Seiten über die Pull-API — einen Ordner in jeden Markdown-SSG ziehen
- REST-API Überblick — der Pull-API-Kontrakt