Archiv
Vom leeren Ordner bis zum aktivierbaren Hello-World-Plugin, inklusive Sprachdateien und Hook-Verständnis.
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.
So bekommt ein Plugin konfigurierbare Felder, persistente Werte und einen eigenen Workspace.
Sobald ein Plugin konfigurierbar werden soll, kommt Bludits Plugin-Datenbank ins Spiel. Die Basisklasse legt pro Plugin eine kleine Flat-File-Datenbank unter bl-content/databases/plugins/ an. Dafür definierst du Felder in init(), renderst Einstellungen in form() und speicherst sie in post().
Komplexe Plugin-Oberflächen sauber in den Bludit-Adminbereich integrieren.
Nicht jede Erweiterung passt in die normale Plugin-Einstellungsseite. Für Dashboards, Importer, Uploader oder komplexe Werkzeuge kann ein Plugin eine eigene Adminseite registrieren. Bludit stellt dafür adminController(), adminView() und adminSidebar() bereit.
WordPress-ähnlicher ZIP-Upload für bl-plugins – mit Adminroute, CSRF, ZIP-Slip-Schutz, Limits und Strukturprüfung.
Die offizielle Standardinstallation eines Bludit-Plugins läuft über Entpacken und Kopieren nach bl-plugins/. Für einen WordPress-ähnlichen Workflow kann man einen ZIP-Uploader als Plugin bauen. Der kritische Teil ist nicht der Datei-Input, sondern die sichere Behandlung des Archivs.
Der in diesem Projekt enthaltene Uploader kann als md-plugin-uploader-1.0.0.zip geladen werden.
Welche Hooks wann laufen, welche vom Theme abhängen und wie man den richtigen Erweiterungspunkt auswählt.
Hooks sind das eigentliche Erweiterungsmodell von Bludit. Ein Hook ist eine Methode im Plugin, die Bludit oder ein Theme an einem definierten Punkt ausführt. Wer den richtigen Hook wählt, braucht viel seltener Core-Patches.
Praxisguide für Inhalte, Page-Objekte, Kategorien und Seiten-Hooks.
Für Plugins ist eine Seite nicht nur HTML. Bludit stellt Page-Objekte und Datenbankobjekte bereit. Damit kann ein Plugin Inhalte lesen, Felder ändern, Kategorien auswerten oder nach Create/Modify/Delete reagieren.