Hallo zusammen.
Da ich nicht so oft neue Versionen des CKEditor-Plugins veröffentliche ist es vielleicht gut, wenn ich nachfolgend einmal beschreibe, wie man den CKEditor ganz einfach auf den neuesten Stand bringt:
HowTo: Update CKEditor für CMSimple_XH (für CKEditor-Versionen 4.x)
Beim CKEditor sind alle Features als Plugins realisiert (klingt nach XH
).
Bei einem Update des Editors sollen natürlich auch wieder alle Features (Plugins) enthalten sein.
Damit das möglichst "simple" geht, stellen die CKEditor - Entwickler speziell dazu ein Online-Tool, den "Builder" bereit.
Die Anleitung gilt für die heute aktuellen CKEditor - Versionen 4.x.
CKEditor 5.x ist derzeit in Entwicklung und wird dann ein komplett neues XH-Plugin zur Installation benötigen.
Los geht's:
- Meldet euch per FTP auf eurem Server an.
- Im Ordner /plugins/ckeditor/ckeditor gibt es eine Datei "build-config.js"
- Öffne diese Datei in einem Texteditor.
- Ziemlich weit oben in den Kommentaren stehen drei Links:
Code: Select all
* (1) http://ckeditor.com/builder
* Visit online builder to build CKEditor from scratch.
*
* (2) http://ckeditor.com/builder/cfe........
* Visit online builder to build CKEditor, starting with the same setup as before.
*
* (3) http://ckeditor.com/builder/download/cfe.........
* Straight download link to the latest version of CKEditor (Optimized) with the same setup as before.
Link (1) führt zum Online-Builder für CKEditor
Link (2) Ruft den Builder auf und wählt automatisch die gleiche Konfiguration, die der Editor bisher hat, ermöglicht aber Änderungen
Link (3) Lädt die aktuellste Version von CKEditor, mit allen bisher gewählten Optionen, direkt herunter.
- Ich empfehle den 2. Link zu verwenden.
- Kopiert den 2. Link also in euren Browser und ruft die Seite auf. Es sollte sich der "CKEditor Builder" öffnen.
- Im CKEditor Builder solltet ihr gleich zu Punkt 2 "Select your plugins and skin" springen.
In der linken Liste seht Ihr dort alle ausgewählten Editor-Features (Plugins), rechts daneben stehen weitere Plugins, die Ihr einbinden könnt.
CK-Builder_2-Select_Plugins.png
- Weiter unten wählt ihr unter dem Punkt "Available skins" das gewünschte "Skin" für den Editor aus. Standard ist "moono" (* beachtet bitte den Hinweis zu den Skins ganz unten am Ende der Anleitung).
CK-Builder_2-Available_Skins.png
- Danach kommen unter Punkt 3 alle verfügbaren Sprachen, die CKEditor unterstützt. Bei meinen Downloads sind alle Sprachen ausgewählt. Ihr könnt eine Menge Platz sparen, wenn ihr nur die Sprachen im linken Auswahlfenster lasst, die ihr auch wirklich verwendet. Nur "English" sollte zur Sicherheit immer mit im Download bleiben.
CK-Builder_3-Languages.png
- Weiter unten setzt ihr nun das Häkchen um die Nutzungsbedingungen zu akzeptieren und makiert noch "Optimized" falls nicht schon geschehen.
CK-Builder_3-Download.png
- Jetzt klickt ihr den Download-Button. Es dauert kurz, bis die gewünschte Konfiguration zusammengestellt ist, danach wird die neue Version als ZIP-Archiv herunter geladen.
- Das ZIP entpackt ihr jetzt auf eurem Rechner. Es enthält in der obersten Ebene nur den Ordner "ckeditor". Darin enthalten ist eure neu geladene CKEeditor - Version.
Update des XH-Plugins:
- Meldet euch per FTP auf eurem Server an.
- Im Verzeichnis /plugins/ckeditor findet ihr nochmal einen Unterordner "ckeditor". Darin befindet sich euer "alter" Editor. Benennt das Verzeichnis mit eurem FTP-Programm erst einmal in z.B. "ckeditor_old" um (dann habt ihr ein Backup - falls was schief läuft).
- Jetzt kopiert ihr den zuvor auf euren Rechner entpackten Ordner "ckeditor" mit allen darin enthaltenen Ordnern und Dateien per FTP auf euren Server - natürlich in den selben Ordner in dem der unbenannte, alte Editor jetzt liegt.
- Damit wäre das Update erledigt.
Testen:
Löscht den Browser-Cache vollständig und meldet euch in eurer XH-Installation an, um den neuen Editor zu testen.
Wenn ihr an der Konfiguration nichts geändert habt und das im Plugin konfigurierte "Skin" im Update enthalten ist, sollte der neue CKEditor jetzt funktionieren.
Probleme:
sollte es eigentlich nicht geben
.
Im Moment fällt mir nur ein Fallstrick ein:
wenn ihr neue Plugins hinzugefügt habt und diese Plugins besondere Konfigurationseinstellungen benötigen, könnte der Editor u.U. nicht laden. Schaut euch in dem Fall die Dokumentation des Plugins genau an und erweitert entsprechend die init_*.js Dateien im Ordner /plugins/ckeditor/inits.
*)
Hinweis zu mehreren Skins: wollt ihr, so wie in meinen Versionen, mehrere Skins zur Auswahl anbieten, müsst ihr den Editor mehrmals komplett - jedoch mit anderem Skin generieren und herunter laden. Nach dem ersten Download wählt ihr einfach ein anderes Skin und ladet den kompletten Editor nochmals herunter.
Die Skins sind im ZIP unter /ckeditor/skins/ als Unterordner mit dem jeweiligen Skin-Namen enthalten. Kopiert bei der Installation auf dem Server einfach zusätzlich gewünschte Skins dort hinein.
Es ist wichtig, immer das Skin passend zur Konfiguration zu laden. Sonst kann es passieren, dass einzelne Buttons nicht in der Toolbar angezeigt werden können.
Sollte wirklich mal jemand diese Anleitung für ein Update nutzen, würde ich mich über Feedback / Verbesserungen / Berichtigungen freuen.
LG,
Holger
You do not have the required permissions to view the files attached to this post.