README.md

# Additional features for CKEditor

To add buttons, modify the `plugins.js` found in `djangocms_text_ckeditor/ckeditor/plugins/eoa/` and register the button in the `CKEDITOR_SETTINGS`.

See https://ckeditor.com/docs/ckeditor4/latest/api/CKEDITOR_plugins.html for reference.

Copy the directory tree `djangocms_text_ckeditor` into the `static` directory of the CMS-enabled site and add the following to `settings.py`.

```python
CKEDITOR_SETTINGS = {
    # 'stylesSet': 'default:/static/editor/styles/js/ckeditor.addstyles.js',
    'toolbar': 'EOA',
    # 'toolbar': 'CMS', # this was the default
    'toolbar_EOA': [
        # defaults, copied from ./env/lib/python3.7/site-packages/djangocms_text_ckeditor/static/djangocms_text_ckeditor/js/cms.ckeditor.js
        ['Undo', 'Redo'],
        ['cmsplugins', 'cmswidget', '-', 'ShowBlocks'],
        ['Format', 'Styles'],
        ['TextColor', 'BGColor', '-', 'PasteText', 'PasteFromWord'],
        ['Scayt'],
        ['Maximize', ''],
        '/',
        ['Bold', 'Italic', 'Underline', 'Strike', '-', 'Subscript', 'Superscript', '-', 'RemoveFormat'],
        ['JustifyLeft', 'JustifyCenter', 'JustifyRight', 'JustifyBlock'],
        ['HorizontalRule'],
        ['NumberedList', 'BulletedList'],
        ['Outdent', 'Indent', '-', 'Blockquote', '-', 'Link', 'Unlink', '-', 'Table'],
        ['Source'],
        ['Eoa-expandable'],

    ],
    'extraPlugins': 'eoa',
}
```