alexantr/yii2-ckeditor

CKEditor widget for Yii 2

CKEditor widget for Yii 2

This extension renders a CKEditor widget for Yii framework 2.0., _(*1)

, _(*2)

Installation

Install extension through composer:, _(*3)

composer require alexantr/yii2-ckeditor

CKEditor version

This extension works with stable standard-all build. The standard-all build includes all official CKSource plugins with only those from the standard installation preset compiled into the ckeditor.js file and enabled in the configuration., _(*4)

Note: Since version 2.0 the extension loads CKEditor from CDN., _(*5)

Usage

The following code in a view file would render a CKEditor widget:, _(*6)

<?= alexantr\ckeditor\CKEditor::widget(['name' => 'attributeName']) ?>

Configuring the CKEditor options should be done using the clientOptions attribute:, _(*7)

<?= alexantr\ckeditor\CKEditor::widget([
    'name' => 'attributeName',
    'clientOptions' => [
        'extraPlugins' => 'autogrow,colorbutton,colordialog,iframe,justify,showblocks',
        'removePlugins' => 'resize',
        'autoGrow_maxHeight' => 900,
        'stylesSet' => [
            ['name' => 'Subscript', 'element' => 'sub'],
            ['name' => 'Superscript', 'element' => 'sup'],
        ],
    ],
]) ?>

If you want to use the CKEditor widget in an ActiveForm, it can be done like this:, _(*8)

<?= $form->field($model, 'attributeName')->widget(alexantr\ckeditor\CKEditor::className()) ?>

Using global configuration (presets)

To avoid repeating identical configuration in every widget you can set global configuration in @app/config/ckeditor.php. Options from widget's clientOptions will be merged with this configuration., _(*9)

You can change default path with presetPath attribute:, _(*10)

<?= alexantr\ckeditor\CKEditor::widget([
    'name' => 'attributeName',
    'presetPath' => '@backend/config/my-ckeditor-config.php',
]) ?>