README

Summernote editor integration for Laravel.

使用

安装

$ composer require "hinet/laravel-summernote"

配置

添加下面一行到 config/app.php 中 providers 部分：

Hinet\LaravelSummernote\SummernoteServiceProvider::class,

发布配置文件与资源

$ php artisan vendor:publish --provider='Hinet\LaravelSummernote\SummernoteServiceProvider'

如果发布异常可以使用:

$ php artisan vendor:publish

然后选择Hinet\LaravelSummernote\SummernoteServiceProvider

模板引入编辑器

这行的作用是引入编辑器需要的 css,js 等文件，所以你不需要再手动去引入它们。
```
@include('vendor.summernote.assets')
```

编辑器的初始化

<!-- 实例化编辑器 -->
<script type="text/javascript">
    $(function() {
        $('#content').summernote($.extend(summernoteOptions, {
            lang:'zh-CN',//根据config/app.php中配置的语言
            height: 300,
        }));
    });
</script>

<!-- 编辑器容器 -->
<textarea type="text" class="form-control" name="content" id="content"></textarea>

使用Markdown插件

<!-- 实例化编辑器 -->
<script src="/assets/vendor/summernote/plugin/markdown/markdown-it.js"></script>
<script src="/assets/vendor/summernote/plugin/markdown/summernote-ext-markdown.js"></script>
<script type="text/javascript">
    $(function() {
        $('#content').summernote($.extend(summernoteOptions, {
            lang:'zh-CN',//根据config/app.php中配置的语言
            height: 300,
            toolbar : [
                ['style', ['style']], 
                ['font', ['bold', 'underline', 'clear']], 
                ['fontname', ['fontname']], 
                ['color', ['color']], 
                ['para', ['ul', 'ol', 'paragraph']], 
                ['table', ['table']], 
                ['insert', ['link', 'picture', 'video']], 
                ['markdown'], 
                ['view', ['fullscreen', 'codeview', 'help']]
            ],
        }));
    });
</script>

<!-- 编辑器容器 -->
<textarea type="text" class="form-control" name="content" id="content"></textarea>

说明

如果你使用的是 laravel 5.3 以下版本，请先创建软链接：

# 请在项目根目录执行以下命令
$ ln -s `pwd`/storage/app/public `pwd`/public/storage

在 config/summernote.php 配置 disk 为 'public' 情况下，上传路径在：public/uploads/ 下，确认该目录存在并可写。
如果要修改上传路径，请在 config/summernote.php 里各种类型的上传路径，但是都在 public 下。
请在 .env 中正确配置 APP_URL 为你的当前域名，否则可能上传成功了，但是无法正确显示。

七牛支持

如果你想使用七牛云储存，需要进行下面几个简单的操作：

1.安装和配置 laravel-filesystem-qiniu

2.配置 config/summernote.php 的 disk 为 qiniu:

'disk' => 'qiniu'

3.剩下时间打局 LOL，已经完事了。

七牛的 access_key 和 secret_key 可以在这里找到：https://portal.qiniu.com/user/key ,在创建 bucket （空间）的时候，推荐大家都使用公开的空间。

事件

你肯定有一些朋友肯定会有一些比较特殊的场景，那么你可以使用本插件提供的事件来支持：

请按照 Laravel 事件的文档来使用： https://laravel.com/docs/5.4/events#registering-events-and-listeners

上传中事件

Hinet\LaravelSummernote\Events\Uploading

在保存文件之前，你可以拿到一些信息：

$event->file 这是请求的已经上传的文件对象，Symfony\Component\HttpFoundation\File\UploadedFile 实例。
$event->filename 这是即将存储时用的新文件名
$event->config 上传配置，数组。

你可以在本事件监听器返回值，返回值将替换 $filename 作为存储文件名。

上传完成事件

Hinet\LaravelSummernote\Events\Uploaded

它有两个属性：

$event->file 与 Uploading 一样，上传的文件

$event->result 上传结构，数组，包含以下信息：

'state' => 'SUCCESS',
'url' => 'http://xxxxxx.qiniucdn.com/xxx/xxx.jpg',
'title' => '文件名.jpg',
'original' => '上传时的源文件名.jpg',
'type' => 'jpg',
'size' => 17283,

你可以监听此事件用于一些后续处理任务，比如记录到数据库。

License

MIT

hinet / laravel-summernote

Maintainers

Details

README

使用

安装

配置

说明

七牛支持

事件

上传中事件

上传完成事件

License