ckeditor konfigurieren

If you have created additional (non official) documentation or tutorials or something like that please post this here
Post Reply
User avatar
santscho
Posts: 1442
Joined: Mon 2. Apr 2007, 08:56
Location: Schweiz

ckeditor konfigurieren

Post by santscho »

In diesem Tutorial zeige ich, wie man
- Funktionen des ckeditors ausschaltet, damit Autoren keinen "Unfug" anstellen können (z.B. eigene Farben verwenden)
- Die CSS des Frontends verwenden, statt die CSS des ckeditors

Alle Einstellungen werden in der config.js des ckeditors vorgenommen. Vorher ein Backup der Datei erstellen:

Code: Select all

include/inc_ext/ckeditor/config.js
Buttons entfernen
In diesem Beispiel möchte ich Textformatierungen, Styles, Schriften, Bilder, iFrame, Textfarbe und Hintergrundfarbe deaktivieren. Einfach eine config.removeButtons-Konfiguration einfügen:

Code: Select all

config.removeButtons = 'Underline,Strike,Styles,Font,Image,Iframe,TextColor,BGColor';
Nur bestimmte Formate erlauben
Im Format-Dropdown möchte ich, dass nur <p> und <h5> auswählbar sind. Eine config.format_tags-Konfiguration einfügen:

Code: Select all

config.format_tags = 'p;h5';
Frontend-CSS verwenden
In meinem Beispiel möchte ich die Stile von meiner Frontend-Bootstrap-CSS verwenden. Die ckeditor-Stile werden deaktiviert. Eine config.contentsCss-Konfiguration einfügen:

Code: Select all

config.contentsCss = 'template/inc_css/ckeditor.css';
im inc_css erstelle ich eine leere CSS-Datei "ckeditor.css". In dieser CSS importiere ich die gewünschten CSS. Zusätzlich füge ich noch eine body-Klasse mit etwas Padding ein, damit der der Text im ckeditor nicht am Rand klebt:

Code: Select all

@import url(assets/bootstrap/css/bootstrap.min.css);
@import url(https://fonts.googleapis.com/css?family=Lobster&amp;subset=cyrillic);
@import url(assets/fonts/fontawesome-all.min.css);
@import url(assets/fonts/font-awesome.min.css);
@import url(assets/fonts/fontawesome5-overrides.min.css);
body {
  padding: 10px;
}
Nun noch den Browser-Cache leeren und einen Browser-Refresh ausführen. Und schon sind die Frontend-Stile im ckeditor reflektiert.

Hier noch meine ckeditor-Konfiguration als Ganzes:

Code: Select all

/**
 * @license Copyright (c) 2003-2019, CKSource - Frederico Knabben. All rights reserved.
 * For licensing, see https://ckeditor.com/legal/ckeditor-oss-license
 */

CKEDITOR.editorConfig = function( config ) {
    // Define changes to default configuration here. For example:
    // config.language = 'fr';
    // config.uiColor = '#AADC6E';

    // For the complete reference:
    // http://docs.ckeditor.com/#!/api/CKEDITOR.config

    config.toolbar = [
        { name: 'tools', items: ['Maximize', '-', 'Source', '-', 'Undo', 'Redo', '-', 'Paste', 'PasteText', 'PasteFromWord', '-', 'Find', '-', 'ShowBlocks' ] },
        { name: 'links', items: [ 'Link', 'Unlink', 'Anchor' ] },
        { name: 'colors', items: [ 'TextColor', 'BGColor' ] },
        { name: 'basicstyles', groups: [ 'basicstyles', 'cleanup' ], items: [ 'Bold', 'Italic', 'Underline', 'Strike', 'Subscript', 'Superscript', '-', 'RemoveFormat' ] },
        { name: 'paragraph', groups: [ 'align', 'list', 'indent', 'blocks' ], items: [ 'JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock', '-', 'BulletedList', 'NumberedList', '-', 'Outdent', 'Indent', '-', 'Blockquote', 'CreateDiv'] },
        { name: 'insert', items: [ 'Image', 'Table', 'HorizontalRule', 'Iframe', 'SpecialChar' ] },
        { name: 'styles', items: [ 'Styles', 'Format', 'Font' ] },
        { name: 'about', items: [ 'About' ] }
    ];

    // Remove some buttons, provided by the standard plugins, which we don't
    // need to have in the Standard(s) toolbar.
    //config.removeButtons = 'Underline,Subscript,Superscript';
    config.removeButtons = 'Underline,Strike,Styles,Font,Image,Iframe,TextColor,BGColor';
    // set some recommend defaults
    config.extraPlugins = 'magicline,image2';
    config.extraAllowedContent = 'div;p;span;ul;ol;li;table;td;style;*[id];*(*);*{*}';
    config.forcePasteAsPlainText = true;
    config.pasteFromWordRemoveFontStyles = true;
    config.pasteFromWordRemoveStyles = true;
    config.pasteFromWordPromptCleanup = true;
    config.protectedSource.push(/<i[^>]*><\/i>/g);
    config.protectedSource.push(/<span[^>]*><\/span>/g);

    config.image2_altRequired = true;
    config.image2_alignClasses = ['image-left', 'image-center', 'image-right'];
    config.image2_captionedClass = 'image-captioned';
    config.format_tags = 'p;h5';
    config.contentsCss = 'template/inc_css/ckeditor.css';

};

Last edited by santscho on Wed 13. May 2020, 21:36, edited 1 time in total.
Schon Konfuzius sagte: "Sei kein YAML-Lappen". YAML-phpwcms-Integration auf http://www.yaml.phpwcms.org
User avatar
Oliver Georgi
Site Admin
Posts: 9888
Joined: Fri 3. Oct 2003, 22:22
Contact:

Re: ckeditor konfigurieren

Post by Oliver Georgi »

Danke für das Aufdröseln.

ABER die Konfiguration NICHT hier include/inc_ext/ckeditor/config.js vornehmen! Mit einem Update geht das zumeist verloren.

Alle custom Anpassungen haben hier template/config/ckeditor zu erfolgen. Dort finden sich Beispieldateien.
Bildschirmfoto 2020-05-13 um 08.11.59.png
Bildschirmfoto 2020-05-13 um 08.11.59.png (102.86 KiB) Viewed 6402 times
Vor allem lassen sich damit angepasste Versionen für die mehrfach verfügbaren CKEditor-Instanzen (zum Beispiel Reiter/Tabs) wie für die sonstigen WYSIWYG-Bereiche definieren.
Oliver Georgi | phpwcms Developer | GitHub | LinkedIn | Систрон
nameless1
Posts: 878
Joined: Sun 27. Apr 2008, 23:22

Re: ckeditor konfigurieren

Post by nameless1 »

super arbeit. danke!
vllt. ins wiki in github verschieben? @oliver
User avatar
Oliver Georgi
Site Admin
Posts: 9888
Joined: Fri 3. Oct 2003, 22:22
Contact:

Re: ckeditor konfigurieren

Post by Oliver Georgi »

nameless1 wrote: Wed 13. May 2020, 11:54 super arbeit. danke!
vllt. ins wiki in github verschieben? @oliver
Ich habe Wiki zum Bearbeiten (braucht GitHub Account) freigegeben – gibt dort auch schon einen Eintrag:
https://github.com/slackero/phpwcms/wik ... tion/_edit
Oliver Georgi | phpwcms Developer | GitHub | LinkedIn | Систрон
nameless1
Posts: 878
Joined: Sun 27. Apr 2008, 23:22

Re: ckeditor konfigurieren

Post by nameless1 »

Cool. Danke!
Überarbeitest Du @santscho
User avatar
santscho
Posts: 1442
Joined: Mon 2. Apr 2007, 08:56
Location: Schweiz

Re: ckeditor konfigurieren

Post by santscho »

Oliver Georgi wrote: Wed 13. May 2020, 08:10 Alle custom Anpassungen haben hier template/config/ckeditor zu erfolgen. Dort finden sich Beispieldateien.
Vor allem lassen sich damit angepasste Versionen für die mehrfach verfügbaren CKEditor-Instanzen (zum Beispiel Reiter/Tabs) wie für die sonstigen WYSIWYG-Bereiche definieren.
Oh, das habe ich nicht gewusst. Ist natürlich viel besser so. Und wie kann man den CKEditor-Instanzen die entsprechende config.js zuteilen? durch das anfügen von z.B. "tabs" (ckeditor.config-tabs.sample.js)?
Schon Konfuzius sagte: "Sei kein YAML-Lappen". YAML-phpwcms-Integration auf http://www.yaml.phpwcms.org
User avatar
Uwe367
Posts: 1206
Joined: Sat 15. Sep 2007, 07:19
Location: Koblenz

Re: ckeditor konfigurieren

Post by Uwe367 »

Danke dir Ralph. Sehr aufschlußreich :D
User avatar
Oliver Georgi
Site Admin
Posts: 9888
Joined: Fri 3. Oct 2003, 22:22
Contact:

Re: ckeditor konfigurieren

Post by Oliver Georgi »

santscho wrote: Wed 13. May 2020, 21:21 Und wie kann man den CKEditor-Instanzen die entsprechende config.js zuteilen? durch das anfügen von z.B. "tabs" (ckeditor.config-tabs.sample.js)?
Einfach das .sample herausnehmen.

Code: Select all

ckeditor.config.js
ckeditor.config-tabs.js
Oliver Georgi | phpwcms Developer | GitHub | LinkedIn | Систрон
User avatar
santscho
Posts: 1442
Joined: Mon 2. Apr 2007, 08:56
Location: Schweiz

Re: ckeditor konfigurieren

Post by santscho »

Oliver Georgi wrote: Thu 14. May 2020, 07:11 Einfach das .sample herausnehmen.
...mit dem -tabs funktioniert das. Habe mal versucht mit:

Code: Select all

ckeditor.config-wysiwyg.js

Code: Select all

ckeditor.config-images.js
scheint so, als wäre diese Funktion nicht für alle CPs verfügbar. Ist aber auch nicht schlimm. In den 15 Jahren mit phpwcms auch nie vermisst.
Schon Konfuzius sagte: "Sei kein YAML-Lappen". YAML-phpwcms-Integration auf http://www.yaml.phpwcms.org
User avatar
Oliver Georgi
Site Admin
Posts: 9888
Joined: Fri 3. Oct 2003, 22:22
Contact:

Re: ckeditor konfigurieren

Post by Oliver Georgi »

Nein, das hast Du mißverstanden – -tabs bezieht sich nur auf die CKEDitor-Instanzen, wo es zur mehrfach Nutzung in einem CP kommen kann. Das betraf bei Einführung nur den CP Tabs, inzwischen greift das auch für Custom WYSIWYG-Felder in den CPs, die benutzerdefinierte Felder unterstützen.

Wäre aber interessanter Ansatz, das auch auf weitere CPs auszuweiten.
Oliver Georgi | phpwcms Developer | GitHub | LinkedIn | Систрон
Post Reply