2017 © Pedro Peláez
 

extension yii2-ckeditor-widget

ckeditor widget for yii2 framework, with ckfinder intergrated

image

maxwen/yii2-ckeditor-widget

ckeditor widget for yii2 framework, with ckfinder intergrated

  • Tuesday, March 28, 2017
  • by max.wen
  • Repository
  • 2 Watchers
  • 4 Stars
  • 29 Installations
  • JavaScript
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 12 Versions
  • 4 % Grown

The README.md

yii2-ckeditor-widget

CKEditor widget for yii2, support ckfinder,elfinder
This repo was forked from 2amigos/yii2-ckeditor-widget.
I made some customization., (*1)

Installation

composer require maxwen/yii2-ckeditor-widget

Configuration

Inorder to add your custom configure,
you need to add an controllerMap to you config/main.php:, (*2)

'controllerMap' => [
    'ckeditor' => [
        'class'    => 'maxwen\ckeditor\controllers\EditorController',
        'viewPath' => '@vendor/maxwen/yii2-ckeditor-widget/views/editor'
    ]
]

Then add you custom configure into params.php: see CKEditor.config, (*3)

 // CKEditor config rewrite
'ckeditorConfig' => [
        // custom options
        'language'   => 'en',
        'font_names' => 'Arial;Comic Sans MS;Courier New;Tahoma;Times New Roman;Verdana',
        'toolbar'    => 'Full',
        'skin'       => 'your skin name here'
        // etc...
    ],

Usage

The library comes with two widgets: CKEditor and CKEditorInline. One is for classic edition and the other for inline editing respectively., (*4)

Using a model with a basic preset:, (*5)


use maxwen\ckeditor\CKEditor;


= $form->field($model, 'text')->widget(CKEditor::className(), [
        'options' => ['rows' => 6],
        'editorConfig' => [
            'customConfig' => 'http://yourdoman.com/ckeditor/config.js',
            // etc ...
        ]
    ]) ?>

Using inline edition with basic preset:, (*6)


use maxwen\ckeditor\CKEditorInline;

 [
        // ...
    ]
    ]);?>

    This text can be edited now :)

How to add custom plugins

This is the way to add custom plugins to the editor. Since version 2.0 we are working with the packagist version of the CKEditor library, therefore we are required to use its configuration API in order to add external plugins., (*7)

Lets add the popular Code Editor Plugin for example. This plugin would allow us to add a button to our editor's toolbar so we can add code to the content we are editing., (*8)

Assuming you have downloaded the plugin and added to the root directory of your Yii2 site. I have it this way:, (*9)

+ frontend 
+ -- web 
    + -- pbckcode

We can now add it to our CKEditor widget. For this example I am using CKEditorInline widget. One thing you notice on this example is that we do not use the preset attribute; this is highly important as we want to add a customized toolbar to our widget. No more talking, here is the code:, (*10)

registerJs("CKEDITOR.plugins.addExternal('pbckcode', '/pbckcode/plugin.js', '');");

// ... 
// Using the plugin
 'custom', 'clientOptions' => [
    'extraPlugins' => 'pbckcode',
    'toolbarGroups' => [
        ['name' => 'undo'],
        ['name' => 'basicstyles', 'groups' => ['basicstyles', 'cleanup']],
        ['name' => 'colors'],
        ['name' => 'links', 'groups' => ['links', 'insert']],
        ['name' => 'others', 'groups' => ['others', 'about']],
        
        ['name' => 'pbckcode'] // 





    Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et
    dolore magna aliqua. 
, (*11)

About CKFinder

CKFinder is a commercial software, this repo just contains a demo version, you can purchase the full version here., (*12)

Further Information

Please, check the CKEditor plugin site documentation for further information about its configuration options., (*13)

The Versions

28/03 2017

dev-master

9999999-dev

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

The Development Requires

by Max Wen

28/03 2017

1.0.9

1.0.9.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

The Development Requires

by Max Wen

28/03 2017

1.0.8

1.0.8.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

27/03 2017

1.0.6

1.0.6.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

27/03 2017

1.0.5

1.0.5.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

27/03 2017

1.0.4

1.0.4.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

25/10 2016

1.0.3

1.0.3.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

19/10 2016

1.0.2

1.0.2.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

12/10 2016

1.0.1

1.0.1.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

10/10 2016

1.0

1.0.0.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

30/09 2016

0.1.1

0.1.1.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen

30/09 2016

0.1

0.1.0.0

ckeditor widget for yii2 framework, with ckfinder intergrated

  Sources   Download

MIT

The Requires

 

by Max Wen