README

yii2-ueditor

Xwom-Yii2的百度UEditor扩展

扩展特点：

支持多实例
支持缩略图（默认关闭）
支持缩放（默认关闭）
支持水印（默认关闭）
图片管理加载优化
与yii2-filemanager 图库集成（稍后更新）
与layui-gii 集成（稍后更新）

安装

推荐使用 composer 来安装扩展.

使用如下命令安装：

php composer.phar require --prefer-dist jinowom/yii2-ueditor "dev-master"

或者将 "jinowom/yii2-ueditor": "*" 添加到项目的 composer.json 文件.

使用方法

安装完毕后，进行简单的配置即可使用。

后端支持

继承 jinowom\ueditor\UEditorController 来实现自己的后端。（推荐）

class UeditorController extends \jinowom\ueditor\UEditorController
{
    public function init(){
        parent::init();
        //do something
        //这里可以对扩展的访问权限进行控制
    }
    
    public function actionConfig(){
        //do something
        //这里可以对 config 请求进行自定义响应，不需要定制的就删除此方法
    }
    
    /**
     * 定制上传方法（覆盖父方法）
     * @param $fieldName
     * @param $config
     * @param $base64
     * @return array
     */
    protected function upload($fieldName, $config, $base64 = 'upload')
    {
        $instance = UploadLogic::getInstance('ali');
        $return = $instance->upload($fieldName, 'store');
        return [
            'state' => 'SUCCESS',
            'url' => $return['url'],
            'thumbnail' => $return['url'],
            'width' => 500,
            'height' => 500
        ];
    }
    // more modify ...
    // 更多的修改
}

通过继承来编写自己的 Controller，可以精细的控制每个 action 的响应，推荐使用这种方式使用。

需要注意的是在 View 模板文件中使用扩展的时候需要指定 serverUrl 为自己编写的 controller 地址。

通过配置 controllerMap 使用默认的后端。

修改配置文件，基础模板的配置文件是 config/web.php，高级模板的配置文件是 config/main.php。

    'controllerMap' => [
        'ueditor' => [
            'class' => 'jinowom\ueditor\UEditorController',
        ]
    ],

简单配置即可使用，还可以配置更多选项：

<?php
    'controllerMap' => [
        'ueditor' => [
            'class' => 'jinowom\ueditor\UEditorController',
            'thumbnail' => false,//如果将'thumbnail'设置为空，将不生成缩略图。
            'watermark' => [    //默认不生存水印
                'path' => '', //水印图片路径
                'position' => 9 //position in [1, 9]，表示从左上到右下的 9 个位置，即如1表示左上，5表示中间，9表示右下。
            ],
            'zoom' => ['height' => 500, 'width' => 500], //缩放，默认不缩放
            'config' => [
                //server config @see http://fex-team.github.io/ueditor/#server-config
                'imagePathFormat' => '/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}',
                'scrawlPathFormat' => '/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}',
                'snapscreenPathFormat' => '/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}',
                'catcherPathFormat' => '/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}',
                'videoPathFormat' => '/upload/video/{yyyy}{mm}{dd}/{time}{rand:6}',
                'filePathFormat' => '/upload/file/{yyyy}{mm}{dd}/{rand:4}_{filename}',
                'imageManagerListPath' => '/upload/image/',
                'fileManagerListPath' => '/upload/file/',
            ]
        ]
    ],

扩展默认生成 200x200 的缩略图，缩略图大小可以通过 thumbnail 来控制。

    'thumbnail' => ['height' => 200, 'width' => 200]

如果将 thumbnail 设置为 false，就不会生成缩略图。

更多配置可以查看 UEditorController的 public 属性。

在模板中使用

使用 ActiveRecord

就像使用普通的扩展一样。

<?= $form->field($model, 'content')->widget(\jinowom\ueditor\UEditor::className()) ?>

或者

<?= \jinowom\ueditor\UEditor::widget([
    'model' => $model,
    'attribute' => 'content',
]) ?>

还可以配置更多属性：

<?= \jinowom\ueditor\UEditor::widget([
    'model' => $model,
    'attribute' => 'content',
    'config' => [
        //client config @see http://fex-team.github.io/ueditor/#start-config
        'serverUrl' => ['/ueditor/index'],//确保serverUrl正确指向后端地址
        'lang' => 'zh-cn',
        'iframeCssUrl' => Yii::getAlias('@web') . '/static/css/ueditor.css',// 自定义编辑器内显示效果
    ]
]) ?>

需要注意的是 serverUrl 属性，默认后端地址是 /ueditor/index，如果配置了多个后端，则需要分别指定。

当作普通表单使用

<?= \jinowom\ueditor\UEditor::widget([
    'name' => $name,
    'value' => $value,
]) ?>

其他

编辑器内默认情况下行高为1，大段中文编辑显示效果非常差，但是可以通过设置 iframeCssUrl 来修改编辑器内显示效果。

默认不支持内网 IP 图片远程采集，如果部署在内网且需要这个功能,请配置UEditorController::allowIntranet为true。

jinowom / yii2-ueditor

Maintainers

Details

README

yii2-ueditor

安装

使用方法

后端支持

在模板中使用

其他

相关链接