tinymce上传本地图片的实现:imageUpload + jquery.form.js

使用tinymce作为网站的编辑器的时候,由于tinymce本身并不提供本地图片上传(提供付费图片上传插件),所以我们需要自己去集成这个功能。但是我在网上找了很多资料,都没有完整且有效的实现方法,经过对已有插件的研究,最终实现了这个功能。现在记录下来,为今后参考。

1. 使用imageUpload插件

tinymce拥有完备的插件体系,就像WordPress一样,tinymce本身就提供了一些核心插件,例如字体样式等,虽然都是编辑器的核心功能,但是仍然是通过插件实现的。它不提供图片上传功能,它的图片只能引用网络图片。所以我们可以通过插件的形式来实现这个功能。

imageUpload插件可以在这里获取和了解。按照作者的意图,在使用本插件的时候,必须先加载iframe form post插件,这个插件在这里下载

但是iframe form post插件的机制似乎出现了问题,导致我在使用时无法正常使用imageUpload插件,所以我选择了使用jquery.form.js这个插件。

2.使用jquery.form.js插件

jquery非常漂亮的封装了ajax,但是在进行表单提交的时候,特别是在上传图片的时候,就会出现问题,[type=file]无法被提交。而通过jquery.form.js插件,就可以很好的解决这个问题。

jquery.form.js并没有提交为官方插件,你可以在这里下载下来。点击这里进入插件的官方主页。

3.开始部署tinymce

说了这么多,到底怎么来实现tinymce的本地上传图片功能呢?按照下方的方法一步一步的操作即可。

1)集成tinymce

也就是在你的HTML中先集成tinymce,并可以正常使用。具体集成方法就不说了。

2)载入jQuery.form.js

在进行tinymce的某个实例化之前,要载入jquery.form.js,你可以直接在tinymce的js载入之后,立即载入jquery.form.js。

3)把插件丢入tinymce的插件目录

上面说过了,我们对imageUpload插件进行了改造,点击这里下载我改造过的插件(jquery.form.js也在这里面)。下载之后,解压出imageupload目录,把这个目录直接丢在tinymce的插件目录(tinymce/plugins)下。

4)初始化时配好配置

在第一步中我们正常集成了tinymce,说明你已经知道如何进行配置了。接下来你要让你的上传图标出现在编辑器工具栏中,并且能够上传图片成功。

<script>
    tinymce.init({
        selector: "#detail",
        language : "zh_CN",
        language_url : "__ASSETS__/TinymceEditor/langs/zh_CN.js", // 语言包,需要到官网去下载,你也可以不使用中文语言包
        menubar: false,
        convert_urls: false,
        height: 450,
        plugins: [
            "link imageupload"
        ],
        toolbar: "undo redo | imageupload link | bold italic | alignleft aligncenter alignright alignjustify",
        imageupload_url: '{:U("File/uploadPicture")}'
    });
</script>

要注意上面三个地方,一个是plugins中添加imageupload(初始化时载入插件),toolbar中要添加imageupload(工具栏中出现上传图片按钮),imageupload_url要设置文件上传到哪一个URL(用php去接收$_FILES['file']进行处理,比如上传、水印等)。

imageupload_url用来处理上传好的图片,同时要返回一个json,让插件知道上传是否成功。json格式在imageUpload的github上已经有了,如果成功的情况下,要返回:

{"error":false,"path":"http:\/\/www.mydomain.com\/myimage.jpg"}

这样子,上传成功后,就可以直接将图片插入到该位置了。

2015-11-19

已有12条评论
  1. sophone 2016-09-06 15:46

    下载了修改后的插件 放入到plugins中 并且在tinyMCE.init中分别添加了convert_urls plugins toolbar imageupload_url 但编辑器中并未显示图片上传按钮,请指点,谢谢

    • 否子戈 2016-09-06 21:01

      使用控制台查看报错,贴上错误信息

      • sophone 2016-09-07 10:11

        程序正常运行 启动后也没有报错 可以正常访问 就是imageupload没有加载 通过chrome浏览器去查看加载的所有js文件中也没有发现imageupload.js插件

      • sophone 2016-09-07 10:19

        现在从chrome浏览器中已经看到该js插件被加载 但是编辑器中依然没有图标可以点击上传

      • sophone 2016-09-07 11:14

        补充:JS加载了 但图标没出来 我使用的是django1.10环境 是否应该将css img文件放到static路径下?

  2. 小鱼博客 2016-12-22 18:32

    感谢博主,前端都没有问题,正在写后端,写好以后测试看

  3. 老衲法号小学生 2017-03-02 18:03

    博主我有个问题,为什么点了那个上传图标后弹出的那个窗口特别小,应该修改下哪里?还有选择上传图片或者文件显示先传错误是因为什么?必须写后台才能上传吗?

    • 否子戈 2017-03-03 20:38

      上传窗口是它自己的,我也不知道,上传错误肯定是前后端结合有问题,你要通过调试工具慢慢查一下原因

    • sky 2017-04-13 11:05

      请问一下上传图片的弹窗特别小你找到原因了吗?重新设置了对应的高宽也没变化呢

      • 否子戈 2017-04-13 19:48

        我不是很清楚你说的这个弹窗特别小是什么意思,没有遇到过,你可能需要自己慢慢调试。

      • 阿水 2017-06-12 20:49

        弹窗很小的问题,在这里能找到解决方案 http://www.cnblogs.com/hzj680539/p/5715489.html

        • 否子戈 2017-06-13 16:47

          非常感谢补充,希望其他同学可以看到!