Das ausführliche Handbuch für Bludit, Themes, Plugins und Hooks

Bevor man Theme, Plugin oder JavaScript verdächtigt, lohnt ein Blick eine Ebene tiefer: Läuft die PHP-Umgebung vollständig? Bludit nennt in der aktuellen englischen Dokumentation PHP 8.0 oder neuer sowie die Erweiterungen mbstring, gd, dom und json.

Fehlt eines dieser Module, kann die Installation bereits abbrechen oder spätere Funktionen wie Bildverarbeitung und XML-/DOM-Verarbeitung scheitern.

Wer Bludit erweitern will, sollte zuerst verstehen, welche Verzeichnisse zum Core gehören und welche den eigenen Zustand tragen. Das verhindert, dass ein Update selbst geschriebene Erweiterungen überschreibt oder ein Backup nur die Hälfte enthält.

Ein Bludit-Theme kann erstaunlich klein anfangen: ein Ordner, eine index.php, Metadaten und Sprachdaten. In diesem Tutorial entsteht daraus ein vollständiges, aber bewusst minimalistisches Blog-Theme mit Startseite, Einzelansicht, CSS, Pagebreak und Plugin-Hooks.

Das fertige Beispiel liegt in diesem Projekt außerdem als praxis-minimal-theme-1.0.0.zip bereit.

Ein einziges index.php reicht für den Einstieg. Für ein wartbares Theme lohnt danach die Aufteilung in Header, Footer, Home, Einzelbeitrag, Sidebar und Hilfsfunktionen. Dieses Tutorial zeigt die Architektur, die auch das mitgelieferte Theme „Bludit Journal“ verwendet.

Bludit dokumentiert die Theme-Installation klassisch: ZIP entpacken, Ordner nach bl-themes/ kopieren, anschließend im Adminbereich aktivieren. Für Administratoren, die keinen FTP-/WebFTP-Schritt möchten, lässt sich diese Lücke mit einem eigenen Admin-Plugin schließen.

Im Projekt ist ein funktionsfähiger Beispiel-Uploader enthalten. Das installierbare Paket liegt zusätzlich unter md-theme-uploader-1.0.0.zip.

Plugins sind in Bludit PHP-Klassen, die von Plugin erben. Der Einstieg ist klein, aber das System skaliert bis zu eigenen Adminseiten, Datenbanken, Hooks, Workspaces und API-ähnlichen Endpunkten.

Das fertige Minimalbeispiel kannst du als hello-box-plugin-1.0.0.zip herunterladen.