README

#laravel 4版的umeditor

####百度前端团队已经停止维护百度编辑器，最后一个版本更新日期为2014.3，请谨慎选择。

laravel 4版的umeditor是国内最好用的富文本web编辑器umeditor的封装，方便使用 laravel 的朋友能够快速配置和使用，以及在线更新编辑器。

##特点

方便配置
随时更新
使用composer进行安装管理，国际标准，方便快捷

##安装 && 使用

这里不详细介绍如何安装composer了，大家根据链接自行安装吧！

在命令行下直接执行composer require "zhuzhichao/umeditor"，版本的话无特殊需求则选择 ~1.0，当前使用的Umeditor版本为1.2.2

####配置 1.在 app/config/app.php 的 providers 数组中添加

'Zhuzhichao\Umeditor\UmeditorServiceProvider',

aliases 数组中添加

'Umeditor'        => 'Zhuzhichao\Umeditor\Umeditor',

同时确保 url 的值为web的地址，同时别忘了composer dumpautoload

2.在命令行下执行如下命令

php artisan config:publish zhuzhichao/umeditor

和

php artisan asset:publish zhuzhichao/umeditor

3.修改配置文件

// app/config/packages/zhuzhichao/umeditor/config.php
<?php
use Illuminate\Support\Facades\Config;

$url = Config::get('app.url').'/packages/zhuzhichao/umeditor/';

return [

    // 图片上传配置
    'upload' => [
        // 上传图片路径
        'savePath' => 'upload/',
        // 上传文件大小
        'maxSize' => 1000,
        // 上传文件类型
        'allowFiles' => [".gif" , ".png" , ".jpg" , ".jpeg" , ".bmp"],
    ],

    // 编辑器配置
    'editor' => [
        // umeditor 根路径
        'UMEDITOR_HOME_URL' => $url,

        // 图片上传编辑器配置
        'imageUrl' => 'umeditor/imageUp',
        'imagePath' => '',
        'imageFieldName' => 'upfile',

        //工具栏上的所有的功能按钮和下拉框，可以在new编辑器的实例时选择自己需要的从新定义
        'toolbar' => [
            'source | undo redo | bold italic underline strikethrough | superscript subscript | forecolor backcolor | removeformat |',
            'insertorderedlist insertunorderedlist | selectall cleardoc paragraph | fontfamily fontsize' ,
            '| justifyleft justifycenter justifyright justifyjustify |',
            'link unlink | emotion image video  | map',
            '| horizontal print preview fullscreen', 'drafts', 'formula'
        ],

       // ...
    ],
];

4.终于配置完成了

###使用

1.这里封装了以下方法可以方便大家添加编辑器的css和js，以及编辑器，直接在 blade 的模版中使用

// 添加css样式
{{ Umeditor::css() }}

// 添加编辑器样式
// 该方法有两个参数，
// 第一个为显示的编辑器内容【可选】
// 第二个为编辑器的attribute数组，可以控制编辑器的id,style,class等内容【可选】，默认id为myEditor
// example: Umeditor::content('', ['id'=>'textid', 'class'=>'text-umeditor'])
// 得到 <script type='text/plain'  id='textid' class='text-umeditor'></script>
{{ Umeditor::content() }}

// 添加js
{{ Umeditor::js() }}

2.文件的上传位置为 public/upload 文件夹下，请确保有写入权限

3.好嘞，终于大功告成，你可以参考这里来使用编辑器的一些方法了。

##bug 如果你遇到了问题，可以先尝试 composer update 来更新一下。如果问题依旧，请提交issue，我会及时回复。当然如果你能提交Pull Requests更好，^^

##贡献有什么新的想法和建议，欢迎提交issue或者Pull Requests。

##许可证 MIT

zhuzhichao / umeditor

维护者

详细信息

README