Mit BookStack 26.03 erscheint ein Release, das vor allem die Anpassbarkeit und Erweiterbarkeit in den Mittelpunkt stellt. Kernstück ist ein neues Modulsystem für Themes, flankiert von erweiterten Theme-Events, neuen Sicherheits- und Filteroptionen sowie kleineren API- und UI-Optimierungen.
Vor dem Update: Wichtige Hinweise für Admins
Vor dem Upgrade solltet ihr ein paar technische Punkte prüfen.
- Seit 25.12.x gab es mehrere Security-Releases, deren Änderungen vollständig in 26.03 einfließen.
- Der Mailversand nutzt jetzt die Domain aus
APP_URLim SMTP-HELO, was bei restriktiven MTAs relevant sein kann – ein Testversand nach dem Update ist sinnvoll. - Im Theme-Verzeichnis ist
modules/nun für Theme-Module reserviert; falls dieser Ordner bereits existiert, sollte er vor dem Update umbenannt werden. - Die im Zuge der Security-Releases verschärfte Inhaltsfilterung bleibt bestehen; das neue
APP_CONTENT_FILTERINGersetzt langfristig das bisherigeALLOW_CONTENT_SCRIPTS.
Neues Theme-Modulsystem: Erweiterungen wie „Plugins“
Das neue Theme-Modulsystem hebt die bisherigen Theme-Anpassungen auf ein deutlich modulareres Niveau.
- Module können parallel in einem aktiven Theme koexistieren, statt dass Anpassungen mühsam zusammengeführt werden müssen.
- Jedes Modul besitzt eine
bookstack-module.jsonmit Metadaten und bringt seine eigenenviews/mit, wodurch das Theme-Verzeichnis übersichtlich bleibt. - Ein optionaler
head/-Ordner im Modul wird automatisch in den<head>-Bereich der Standardansichten eingebunden, ideal für zusätzliche Scripts oder Meta-Tags.
Module lassen sich bequem über einen Artisan-Installationsbefehl aus einer lokalen Datei oder direkt per URL einspielen. Die bisherigen Theme-Hacks wurden bereits auf dieses System umgestellt und können so einfacher verteilt und aktualisiert werden.
Weitere technische Neuerungen im Überblick
Neben dem Modulsystem bringt BookStack 26.03 zusätzliche technische Verbesserungen, die vor allem Integratoren und Betreiber interessieren.
- Erweiterte Theme-Events ermöglichen tiefere Integrationen, etwa das Einhängen eigener Views oder die Manipulation von Seiteninhalten vor dem Speichern bzw. Rendern.
- Über ein neues Event lässt sich die OIDC-Redirect-URL anpassen, um anspruchsvollere Single-Sign-On-Szenarien abbilden zu können.
- Die bereits eingeführte, stärkere Inhaltsfilterung auf Basis von HTML Purifier wurde weiter verfeinert und über
APP_CONTENT_FILTERINGbesser steuerbar gemacht. - Die REST-API liefert beim Lesen eines einzelnen Books nun auch Informationen zu den zugehörigen Regalen, was Integrationen und Synchronisationen vereinfacht.
UI-Feinschliff und kleinere Verbesserungen
Für Nutzerinnen und Nutzer bringt 26.03 eine Reihe von Detailverbesserungen im Alltag.
- Nach dem Löschen eines Books innerhalb eines Regals landet man wieder im entsprechenden Regal, was die Navigation konsistenter macht.
- Die Beschreibung für pro-Seite-Limits in Listenansichten wurde klarer formuliert.
- Draw.io-Diagramme nutzen nun einen Pointer-Cursor, wodurch interaktive Elemente besser erkennbar sind.
- Kleinere UI-Bugs – etwa unnötige Leerflächen bei leeren Beschreibungen – wurden behoben.
Ausblick: Mehr Module, AI-Features und neue Plattformen
Mit dem Modulsystem ist die Grundlage gelegt, BookStack künftig stärker über wiederverwendbare Erweiterungen zu individualisieren. Parallel arbeitet das Projekt an einem AI-/LLM-basierten Query-System sowie an angepassten Installations- und Supportpfaden für kommende Plattformversionen wie Ubuntu 26.04 LTS.
So aktualisieren Sie BookStack richtig
Planen Sie das Update, wenn kaum Nutzer aktiv sind. Machen Sie vorher eine Sicherung Ihrer Daten, damit nichts verloren geht. Testen Sie nach der Aktualisierung, ob alles funktioniert, siehe dazu auch unsere detaillierte Schritt-für-Schritt-Anleitung: „BookStack Updates: Schritt-für-Schritt“.
Warum diese Updates für Sie wichtig sind
Durch die neuen Versionen wird Ihr BookStack noch benutzerfreundlicher, stabiler und vor allem sicherer. Regelmäßige Aktualisierungen sorgen dafür, dass Sie effizienter arbeiten können und Ihre wichtigen Dokumente geschützt sind.
Wenn Sie weitere Tipps zum sicheren Arbeiten mit Dokumentationssystemen und Cloud-Tools brauchen, schauen Sie gern in unserem Blog vorbei: https://blog.admin-intelligence.de/. Bei Fragen oder Unterstützung beim Update stehen wir Ihnen auch direkt über unsere Kontaktseite zur Verfügung: https://www.admin-intelligence.de/kontakt/
Detaillierte Informationen zu den beiden Updates erhalten Sie im Blog von BookStack.
Wenn Sie Beratung und Support von BookStack benötigen, dann dann schauen Sie doch auf unserer Webseite vorbie und nehmen Sie gerne Kontakt zu uns auf.
schnelle Problemlösung durch langjährige Erfahrung