Doku Benutzer BBCode Konvertierungs Modul
Stand 23.06.2024: Das BBCode-Konvertierungs-Modul wird nicht mehr weiterentwickelt. Sollten Sie noch Inhalte im BBCode-Format haben, wird empfohlen diese vor dem Update auf Ilch 2.2.2 zu konvertieren.
Inhaltsverzeichnis
Mit ilch 2.1.52 wechselten ilch und viele optionale Module und Layouts zur Nutzung des CKEditors 4 im HTML-Modus. Bestehende Inhalte, wie z.B. Beiträge im Forum, müssen einmalig von BBCode in HTML konvertiert werden, damit sie korrekt angezeigt werden. Hierfür wurde mit diesem Update auch das BBCode-Konvertierungs-Modul ausgeliefert. Es sollte bereits im Admincenter unter den nicht installierten Modulen aufgelistet sein. Es kann ebenfalls, wie alle optionalen Module, vom Updateserver nachinstalliert werden. Sollten Sie ilch 2.1.52 oder neuer frisch und ohne bestehende Inhalte installieren ist eine Konvertierung nicht nötig, da alle neuen Inhalte automatisch im HTML-Format abgespeichert werden. Der HTML-Modus kommt auch mit einigen neuen Funktionen, wie z.B. im Forum die Möglichkeit Beiträge mit Tabellen erstellen zu können. Der Hintergrund dieser Änderungen ist, dass auf einen Wechsel zu CKEditor 5 hingearbeitet wird. CKEditor 5 unterstützt kein BBCode.
- Nachdem Sie Ilch und alle Module und Layouts auf den aktuellen Stand gebracht haben, ist es erforderlich, dass die alten Inhalte von BBCode zu HTML konvertiert werden. Hierfür wurde ein Modul erstellt, welches die Konvertierung für unterstütze Ilch-Versionen, Module und Layouts durchführt. Sie werden mit einer Benachrichtigung im Admincenter darauf hingewiesen.
-
Installieren Sie das bereits mit dem Update auf 2.1.52 ausgelieferte Modul "BBCode-Konvertierung". Ein Klick auf die oben erwähnte Benachrichtigung führt sie direkt zur Seite der nicht installierten Module im Admincenter. Sollten Sie von einer älteren Version von Ilch direkt auf eine neuere Version als 2.1.52 wechseln, steht sehr wahrscheinlich ein Update für das Modul "BBCode-Konvertierung" zur Verfügung. Prüfen Sie daher nach der Installation des Moduls, ob eine neuere Version verfügbar ist.
-
Es wird empfohlen die Seite für die Konvertierung in den Wartungsmodus zu versetzen und eine Sicherheitskopie der Datenbank anzulegen.
- Rufen Sie das Modul "BBCode-Konvertierung" auf. Im Menü unter Hinweise sehen sie alle unterstützen Versionen der Module und Layouts. Bedenken Sie ebenfalls die Erläuterungen dort.
Der BBCode wird nur konvertiert, wenn der resultierende HTML-Code weiterhin in die entsprechende Spalte der Tabelle in der Datenbank passt, da dies andernfalls zu Datenverlust oder Fehlern führen würde.
- In der Übersicht des Moduls sehen Sie alle gefundenen und unterstützen Module und Layouts. Hier werden eventuell auch Warnungen angezeigt, betreffend des Wartungsmodus und der Erstellung einer Sicherheitskopie der Datenbank. Ist dies der Fall dann überprüfen Sie bitte, ob der Wartungsmodus aktiviert ist und eine aktuelle Sicherheitskopie der Datenbank erstellt wurde. Wählen Sie die Module und Layouts aus für welche Sie die Inhalte konvertieren möchten. Sie können einzelne Module oder Layouts auswählen oder auch alle. Wählen Sie anschließend im unteren Menü "konvertieren" aus.
- Sie können den Fortschritt der Konvertierung anhand der Fortschrittsanzeigen beobachten. Während der Konvertierung wird die Seite mehrfach aktualisiert. Schließen Sie während der Konvertierung nicht die Seite. Die Dauer der Konvertierung hängt z.B. von der Menge der Inhalte ab.
- Wenn die Konvertierung abgeschlossen ist, sind die Fortschrittsanzeigen gefüllt und es wird der Text "Konvertierung abgeschlossen" angezeigt.
- Wechseln Sie zurück zur Übersicht. Hier sollten Sie nun sehen, dass alle ausgewählten Module und Layouts konvertiert wurden.
- Sie können während der Wartungsmodus aktiviert ist z.B. stichprobenartig einige Inhalte, wie z.B. Beiträge im Forum, kontrollieren. Bitte beachten Sie, dass möglicherweise einige Inhalte nicht konvertiert wurden, wenn der resultierende Inhalt in HTML-Form nicht in die Spalte der Tabelle in der Datenbank gepasst hätte. Ist dies der Fall dann sehen Sie BBCode in den Inhalten. Dies kann z.B. längere Beiträge im Forum, die auch sehr viel BBCode enthalten, betreffen. Bei Problemen nutzen Sie die erstellten Sicherheitskopien. Anschließend können Sie den Wartungsmodus wieder deaktivieren.
Das Modul "BBCode-Konvertierung" wird für einige Zeit aktualisiert, um die aktuellen Versionen der Module und Layouts oder auch neue Module und Layouts zu unterstützen. Sollten Sie ein Modul oder Layout nutzen oder selber entwickelt/erstellt haben, welches nicht vom Modul "BBCode-Konvertierung" unterstützt wird, dann können Sie dies im Ilch-Forum melden. Nach Möglichkeit wird dann eine Unterstützung für das Modul oder Layout hinzugefügt. Bitte bedenken Sie, dass nicht jedes Modul oder Layout eine Konvertierung benötigt, da sie nie BBCode genutzt haben.
Wir werden in zukünftigen News über Aktualisierungen des Moduls und dessen Zukunft informieren.