Laravel Ueditor百度编辑器-轻识

百度编辑器 For Laravel 5

支持自定义路由, 默认前后台独立控制器,支持重写方法方便自己的业务逻辑处理,支持扩展图片助手(推荐使用Intervention\Image第三方包)

官网

NinJa911工作室.

疑问讨论

请在issue里new一个.

授权

此Laravel 扩展包基于MIT协议开源MIT license.

安装

1.Composer 安装

composer require "zhangmazi/laravel-ueditor:^1.0"

2.编辑config/app.php文件,在节点[providers]中加入

Zhangmazi\Ueditor\UeditorServiceProivder::class

3.在命令行工具执行

php artisan vendor:publish --provider="Zhangmazi\Ueditor\UeditorServiceProivder"

相关资源配置会成功发布到:config/zhangmazi/(配置); public/assets/(静态资源); resources/views/vendor/zhangmazi/(视图,包含demo所需).

配置

1.配置config/zhangmazi/filesystem.php

请根据注释填写,特别要注意root和url_root,这个2个很关键,因为直接导致你是否能上传成功和是否能正常开放预览附件; root的物理路径一定有0755或者0777(当需要建立子目录时)权限.

2.配置config/zhangmazi/ueditor.php

请根据注释填写,节点[routes]支持多组应用场景,其配置其实就Laravel的Route原生配置方法; 其中带有"group_"前缀的都不填,将不使用路由组模式; 如果"via_integrate"为true,将将适用内置命名空间,同时不要修改"uese".

3.配置config/zhangmazi/ext2mime.php

这个增加上传安全性的, 如果您觉得多了和少了, 请自行根据格式进行修改.

使用

Demo使用

开发此包时, 为了增加体验感, 特为大家准备了demo.

访问 http://localhost/zhangmazi/ueditor/demo/index, 其中localhost跟更改为你自己的绑定的域名.

为了安全性, 在[.env]文件中APP_DEBUG=true才能使用demo,否则无法访问以上demo相关路由地址.

如何使用

1.在您的视图中, 在body闭包前(即</body>),加入以下代码

@include("zhangmazi::ueditor")

2.在您的视图中, 需要占位编辑器的dom节点内,加入以下代码

<script id="ueditor_filed" name="article_content" type="text/plain"></script>

其中id="ueditor_filed"这里是需要给百度编辑器创建的时候用到的名字, 如果同一个页面有多个,这个id请用不同的名字替换.

3.在您的视图中, 在body闭包前(即</body>),加入以下代码

<script>
    var ueditor_full = UE.getEditor('ueditor_filed', {
    'serverUrl' : '{{ route("zhangmazi_front_ueditor_service", ['_token' => csrf_token()]) }}'
});
</script>

如果需要更多参考以及调用样板,比如如何自定义编辑工具栏、同一个页面多个编辑器,请查看阅读文件 vendor/zhangmazi/ueditor/src/views/ueditorDemoIndex.blade.php

自定义扩展

以下说明需要一定PHP知识和Laravel5框架了解背景

1.扩展继承内置控制器

新建一个控制器,并继承内置控制器"Zhangmazi\Ueditor\UeditorFrontController".

<?php
/**
 * 自定义的编辑器控制器.
 * 可以观看 Zhangmazi\Ueditor\UeditorUploaderAbstract 类的方法,根据自身业务选择性重写覆盖
 *
 * @author ninja911<ninja911@qq.com>
 * @date   2016-08-20 22:22
 */
namespace App\Http\Controllers;

use Zhangmazi\Ueditor\UeditorFrontController;

class CustomUeditorController extends UeditorFrontController
{
    /**
     * 记录上传日志(这些方法都可以重写覆盖)
     * @return mixed
     */
    protected function insertRecord()
    {

    }

    /**
     * 验证是否合法(这些方法都可以重写覆盖)
     * @return bool|mixed
     */
    protected function checkGuard()
    {
        //Auth....
        return true;
    }

    /**
     * 获取相对于public_path()根目录的相对目录
     * @return bool|mixed
     */
    protected function getRelativeDir()
    {
        return 'uploads/ueditor';
    }
}

?>

把相关路由配置一下,不用内置的

3.查看路由清单,看是否生效,命令行里执行

php artisan route:list