djangocms-text-ckeditor 2.1.4

cms.plugins.text and djangocms-text-ckeditor can’t be used at the same time.

Warning

For django CMS 2.3 and 2.4 use djangocms-text-ckeditor < 2 (e.g.: version 1.0.10).

djangocms-text-ckeditor >= 2 is compatible with django CMS 3 only.

Installation

This plugin requires django CMS 2.3 or higher to be properly installed.

In your projects virtualenv, run pip install djangocms-text-ckeditor.

Add 'djangocms_text_ckeditor' to your INSTALLED_APPS setting BEFORE the cms entry.

Run manage.py migrate djangocms_text_ckeditor.

Upgrading from cms.plugins.text

Remove cms.plugins.text from INSTALLED_APPS

Add djangocms_text_ckeditor to INSTALLED_APPS

Run python manage.py migrate djangocms_text_ckeditor 0001 --fake

Usage

Default content in Placeholder

If you use Django-CMS >= 3.0, you can use TextPlugin in “default_plugins”
(see docs about the CMS_PLACEHOLDER_CONF setting in Django CMS 3.0).
TextPlugin requires just one value: body where you write your default
HTML content. If you want to add some “default children” to your
automagically added plugin (i.e. a LinkPlugin), you have to put children
references in the body. References are "%(_tag_child_<order>)s" with the
inserted order of chidren. For example:

CKEDITOR_SETTINGS

This is the default dict that holds all CKEditor settings. If you want to
use the CKEditor in your own models, then use the HTMLField from
djangocms_text_ckeditor.fields and replace 'toolbar': 'CMS' with
'toolbar': 'HTMLField' in the above settings, in order to add an

Configurable sanitizer

djangocms-text-ckeditor uses html5lib to sanitize HTML to avoid
security issues and to check for correct HTML code.
Sanitisation may strip tags usesful for some use cases such as iframe;
you may customize the tags and attributes allowed by overriding the
TEXT_ADDITIONAL_TAGS and TEXT_ADDITIONAL_ATTRIBUTES settings: