README

Yii2 框架的 redactor 扩展。此版本是从 yiidoc/yii2-redactor 分支出来的，以允许一些额外的设置和选项。

安装时，如果尚未在 packagelist 上发布，请将 "yiidoc/" 替换为 "stump90/"，并附带一个存储库...

变更

添加了英语（英国）语言

    'clientOptions' => [
        ...
        'lang' => 'en_gb',
        ...
    ]

.size()

.size() 替换为 .length 以兼容 JQuery。

removePastedImages (默认 false)

添加了额外的选项来移除粘贴到内容中的图片（作为 base64 数据）- 比pastePlainText 限制更少。

removePastedImagesMessage (默认空白)

添加了额外的选项来告诉用户上传图片的正确方式。

        'clientOptions' => [
            ...
            'pastePlainText' => false,
            'removePastedImages' => true,
            'removePastedImagesMessage' => "<h1>Please upload images via filemanager or drag'n'drop</h1>",
            ...
        ]

authUserDir 配置选项

添加了额外的配置选项 - authUserDir（默认空白，只允许字符 a-zA-Z0-9）当设置时，此选项会隐藏已登录用户的 ID，并使用一个公共文件夹为所有已登录用户。访客用户的文件路径仍然是 'guest'。

    'modules' => [
        'redactor' => [
            'class' => 'yii\redactor\RedactorModule',
            'uploadDir' => '@webroot/uploads',
            'uploadUrl' => '@web/uploads',
            'imageAllowExtensions'=>['jpg','jpeg','png','gif','webp'],
            'authUserDir' => 'files'
        ],
    ],

集成 Redactor-10-clipboardPaste-plugin

集成了 CFDan 的 clipboardPaste 插件，并添加了剪贴板上传操作。

来源：https://github.com/CFDan/Redactor-10-clipboardPaste-plugin

        'clientOptions' => [
            ...
            'removePastedImages' => true,
            'removePastedImagesMessage' => "",
            'plugins' => ['fontcolor','imagemanager','filemanager','clipboardPaste'],
            'clipboardUploadUrl' => ['/redactor/upload/image-clip'],
            'clipboardUpload' => true,
            ...
        ]

原始 yiidoc/yii2-redactor Readme

安装

安装此扩展的首选方法是使用 composer。

运行

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

或

 "yiidoc/yii2-redactor": "*"

将此添加到 composer.json 的 require 部分。

配置

添加到配置文件（config/web.php 或 common\config\main.php）

    'modules' => [
        'redactor' => 'yii\redactor\RedactorModule',
    ],

或如果您想更改上传目录，则到 path/to/uploadfolder（默认值 @webroot/uploads）

    'modules' => [
        'redactor' => [
            'class' => 'yii\redactor\RedactorModule',
            'uploadDir' => '@webroot/path/to/uploadfolder',
            'uploadUrl' => '@web/path/to/uploadfolder',
            'imageAllowExtensions'=>['jpg','png','gif']
        ],
    ],

注意：您需要创建上传文件夹，并设置文件夹的 chmod 和安全设置，以便上传参考：使用 .htaccess 保护您的上传文件夹，如何设置安全的媒体上传

配置视图/表单

<?= $form->field($model, 'body')->widget(\yii\redactor\widgets\Redactor::className()) ?>

或不使用 ActiveField

<?= \yii\redactor\widgets\Redactor::widget([
    'model' => $model,
    'attribute' => 'body'
]) ?>

或配置高级 redactor 参考文档

<?= $form->field($model, 'body')->widget(\yii\redactor\widgets\Redactor::className(), [
    'clientOptions' => [
        'imageManagerJson' => ['/redactor/upload/image-json'],
        'imageUpload' => ['/redactor/upload/image'],
        'fileUpload' => ['/redactor/upload/file'],
        'lang' => 'zh_cn',
        'plugins' => ['clips', 'fontcolor','imagemanager']
    ]
])?>

stump90 / yii2-redactor

维护者

详细信息