Praxis & Fehlerbehebung

Bilder und Medien: Uploads, Thumbnails und IMAGE_RESTRICT verstehen

Bludit kann Bilder hochladen und Vorschaubilder erzeugen. Wenn das scheitert, sind PHP-GD, Uploadlimits und der tatsächliche Speicherpfad die ersten Prüfstellen.

~1 Minute Lesezeit

Bilder wirken im Editor wie eine Kleinigkeit, technisch greifen aber mehrere Ebenen ineinander: Browser-Upload, PHP-Limits, Dateiprüfung, Bildverarbeitung und schließlich der Speicherort im bl-content-Baum.

Bludits Dokumentation beschreibt den üblichen Ablauf direkt im Editor: Bild auswählen, hochladen und anschließend in den Inhalt einfügen.

Wenn der Upload nicht funktioniert

  • Prüfe, ob die PHP-Erweiterung gd vorhanden ist. Bludit nutzt sie zur Bildverarbeitung.
  • Prüfe upload_max_filesize und post_max_size in PHP.
  • Prüfe Schreibrechte auf bl-content/uploads und gegebenenfalls die seitenbezogenen Unterordner.
  • Prüfe Dateityp und tatsächlichen MIME-Type statt nur die Dateiendung.

Was IMAGE_RESTRICT ändert

Bei aktivierter Option können Medien seitenbezogen unter bl-content/uploads/pages/<uuid>/ liegen. Das ist wichtig, wenn Theme, Editor oder ein eigener Medienadapter URLs erzeugen: Der Pfad darf nicht pauschal als globaler Uploadordner angenommen werden.

Warum Thumbnails wichtig sind

Die API-Dokumentation beschreibt, dass beim Bild-Upload auch ein Thumbnail erzeugt wird. Themes sollten diese kleineren Varianten nutzen, wenn keine große Originaldatei benötigt wird.

Weiterführende Quellen