Plugins

Ein Bludit-Plugin von Null erstellen: Struktur, Metadaten, Klasse und erster Hook

Vom leeren Ordner bis zum aktivierbaren Hello-World-Plugin, inklusive Sprachdateien und Hook-Verständnis.

~1 Minute Lesezeit

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.

1. Ordnerstruktur

bl-plugins/hello-box/
├── plugin.php
├── metadata.json
└── languages/
    ├── de_DE.json
    └── en.json

2. metadata.json

{
  "author": "Dein Name",
  "version": "1.0.0",
  "releaseDate": "2026-09-18",
  "license": "MIT",
  "compatible": "3.22",
  "notes": "Mein erstes Plugin"
}

3. Sprachdatei

{
  "plugin-data": {
    "name": "Hello Box",
    "description": "Kleines Tutorial-Plugin für die Sidebar."
  }
}

4. plugin.php

<?php defined('BLUDIT') or die('Bludit CMS.');

class pluginHelloBox extends Plugin
{
    public function siteSidebar()
    {
        return '<div class="hello-box"><strong>Hello Bludit!</strong><p>Mein erstes Plugin läuft.</p></div>';
    }
}

Wichtig ist, dass das aktive Theme den Hook siteSidebar überhaupt aufruft. Nicht jedes Theme unterstützt jeden Theme-Hook. Für universellere Plugins sind siteHead, siteBodyBegin und siteBodyEnd oft besser geeignet, weil viele Themes diese standardmäßig integrieren.

5. Installieren und aktivieren

  1. Pluginordner nach bl-plugins/ kopieren oder den mitgelieferten Plugin Uploader verwenden.
  2. Admin → Plugins öffnen.
  3. „Hello Box“ aktivieren.
  4. Frontend aufrufen und kontrollieren, ob das Theme den verwendeten Hook ausgibt.

Quellen und weiterführende Dokumentation