karneds/yii2-redactor

Extension redactor for Yii2 Framework.

dev-master 2014-04-07 12:15 UTC

Requires

• yiiext/imperavi-redactor-widget: *
• yiisoft/yii2: *

BSD-3-Clause

• Nghia Nguyen
• Popov Denis

• wysiwyg
• extension
• Redactor
• html editor
• yii2
• imperavi

README

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist "karneds/yii2-redactor *"

or add

"karneds/yii2-redactor": "*"

to the require section of your composer.json.

Usage:

in controller

    public function actions(){
        return [
            'file' => [
                'class'=>'yii\redactor\actions\FileUploadAction',
                'uploadDir'=>'@webroot/uploads/files/'
            ],
            'image' => [
                'class'=>'yii\redactor\actions\ImageUploadAction',
                'uploadDir'=>'@webroot/uploads/images/'
            ],
            'imagejson' => [
                'class'=>'yii\redactor\actions\ImageGetJsonAction',
                'sourcePath'=>'@webroot/uploadsimages/'
            ],
            'clipboard' => [
                'class'=>'yii\redactor\actions\ClipboardUploadAction',
                'uploadDir'=>'@webroot/uploads/files/'
            ],
        ];
    }

in view

    use \yii\helpers\Url;
    ...
    <?= $form->field($model,'text')->widget(yii\redactor\widgets\Redactor::className(),[
        'clientOptions'=>[
            'lang'=>'ru',
            'formattingTags'=>['p', 'blockquote', 'pre', 'h2', 'h3', 'h4'],
            'imageTabLink'=>false,
            'imageGetJson' => Url::toRoute(['pages/imagejson']),
            'imageUpload' => Url::toRoute(['pages/image']),
            'clipboardUploadUrl' =>Url::toRoute(['pages/clipboard']),
            'fileUpload' => Url::toRoute(['pages/file']),
            'plugins' => ['clips', 'fullscreen']
        ]
    ])?>

Advanced application template

in config.php

    'components' => [
       'urlManagerFrontend'=>[
            'class' => 'yii\web\UrlManager',
            'baseUrl'=>'',
            'hostInfo'=>'http://example.com'
       ],
    ]

in controller

        public function actions(){
            return [
                'image' => [
                    'class'=>'yii\redactor\actions\ImageUploadAction',
                    'uploadDir'=>'@frontend/web/uploads/images/',
                    'baseDir'=>'@frontend/web',
                    'baseUrl'=>Yii::$app->urlManagerFrontend->hostInfo.Yii::$app->urlManagerFrontend->baseUrl
                ],
                'imagejson' => [
                    'class'=>'yii\redactor\actions\ImageGetJsonAction',
                    'sourcePath'=>'@frontend/web/uploads/images/'
                    'baseDir'=>'@frontend/web',
                    'baseUrl'=>Yii::$app->urlManagerFrontend->hostInfo.Yii::$app->urlManagerFrontend->baseUrl
                ],
        ];
    }

in view

    use \yii\helpers\Url;
    ...
    <?= $form->field($model,'text')->widget(yii\redactor\widgets\Redactor::className(),[
        'clientOptions'=>[
            'lang'=>'ru',
            'imageGetJson' => Url::toRoute(['pages/imagejson']),
            'imageUpload' => Url::toRoute(['pages/image'])
        ]
    ])?>