cakecoded/ckeditor

CkEditor plugin for CakePHP 3.x

CKEditor plugin for CakePHP

Installation

You can install this plugin into your CakePHP application using composer., _(*1)

The recommended way to install composer packages is:, _(*2)

composer require cakecoded/ckeditor

Then in config/bootstrap.php add:, _(*3)

Plugin::load('CkEditor');

In either src/Controller/AppController.php, or any controller where you want to use CKEditor, add:, _(*4)

public $helpers = ['CkEditor.Ck'];

Finally, in your template file, simply add this to call CKEditor:, _(*5)

echo $this->Ck->input('field_name');

This is the equilivant of using, _(*6)

echo $this->Form->input('field_name');

Except that CKEditor will be loaded instead of a text area!, _(*7)

Advanced Options

You can make adjustments to CKEditor and the form input as needed. There is full flexibility in this regard., _(*8)

The full explaination is as follows:, _(*9)

echo $this->Form->input($input, $options, $ckEditorOptions, $ckEditorUrl, $ckEditorPlugins);

```php @param string $input, <sub>(*10)</sub>

The name of the field, can be field_name or model.field_name

```php
@param array $options

Options include $options['label'] for a custom label and any other custom Form Helper options, <sub>(*11)</sub>

@param array $ckEditorOptions

This will pass any options from http://docs.ckeditor.com/#!/guide/dev_configuration to CKEditor, <sub>(*12)</sub>

@param string $ckEditorUrl

This gives an option to overwrite the CKEditor URL. You can use a local URL then if required., <sub>(*13)</sub>

@param array $ckEditorPlugins

An array of locally installed CKEditor plugins to include, as one sub-array per plugin, in the format specified in the CKEditor documentation at https://docs.ckeditor.com/ckeditor4/latest/api/CKEDITOR_plugins.html#addExternal., <sub>(*14)</sub>

Examples

Use an associated field name, <sub>(*15)</sub>

echo $this->Ck->input('category.description');

Generate a custom label, <sub>(*16)</sub>

echo $this->Ck->input('field_name', ['label' => 'A unique label']);

Add options to CKEditor from http://docs.ckeditor.com/#!/guide/dev_configuration, <sub>(*17)</sub>

echo $this->Ck->input('field_name', [], ['fullPage' => true, 'allowedContent' => 'true']);

Load a local version of CKEditor, or a different version, <sub>(*18)</sub>

echo $this->Ck->input('field_name', [], [], '/js/ckeditor.js');

Load a locally installed CKEditor plugin, <sub>(*19)</sub>

echo $this->Ck->input('field_name', [], [], null, [['myplugin', '/ckplugins/myplugin/', 'myplugin.js']]);

Example showing all the options together, <sub>(*20)</sub>

echo $this->Ck->input('field_name', ['label' => 'A unique label'], ['fullPage' => true, 'allowedContent' => 'true'], '/js/ckeditor.js', [['myplugin', '/ckplugins/myplugin/', 'myplugin.js']]);