织梦ueditor1.3.6有何新功能或问题？

核心概念：为什么需要集成？

1. 织梦 DedeCMS：一个老牌的 PHP 内容管理系统，以其强大的后台和标签化模板引擎著称，但其自带的编辑器功能简陋,用户体验差。
2. UEditor：百度开源的富文本编辑器，功能强大（支持图片、视频、表格、代码高亮等），界面美观,可定制性高。

集成 UEditor 的目的，就是用 UEditor 替换掉织梦后台默认的文本编辑器,提升内容编辑的效率和体验。

如何将 UEditor 1.3.6 集成到织梦 DedeCMS？

以下是详细的集成步骤，适用于织梦 5.7 等主流版本。

第 1 步：下载 UEditor 1.3.6

1. 访问 UEditor 官方 GitHub 仓库：https://github.com/fex-team/ueditor
2. 在 Releases 页面找到 3.6 版本并下载。
3. 下载后，你会得到一个压缩包，解压后你会看到 php、utf8-php、jsp、net 等文件夹。我们只需要 utf8-php 文件夹，因为织梦是 PHP 且使用 UTF-8 编码。
4. 将 utf8-php 文件夹重命名为 ueditor（这个名字可以自定义，但后续配置要对应）。

第 2 步：上传 UEditor 文件到织梦服务器

1. 使用 FTP 工具将重命名后的 ueditor 文件夹上传到织梦网站的根目录下的 /include/ 文件夹中。
   • 你的文件路径应该是：/网站根目录/include/ueditor/

第 3 步：修改织梦编辑器调用文件

这是最关键的一步，织梦通过一个文件来决定调用哪个编辑器，我们需要修改它来指向 UEditor。

1. 找到织梦根目录下的文件：/include/inc/inc_fun_funAdmin.php
2. 打开这个文件，找到 GetEditor() 函数。
3. 在函数内部，找到 $editor = 'full'; 这一行,这行代码决定了编辑器的类型。
4. 将其修改为：

   // 在 inc_fun_funAdmin.php 文件中
   // function GetEditor() 函数内
   $editor = 'ueditor'; // 将 'full' 改为 'ueditor'

   • 原理：织梦的编辑器调用逻辑是，$editor 的值不是 full、simple 等内置值，就会去查找一个对应的配置文件，当 $editor = 'ueditor' 时，它会去寻找 ../inc/inc_config_ueditor.php 这个文件。

第 4 步：创建 UEditor 配置文件

根据上一步的原理,我们需要创建一个自定义的配置文件。

1. 在 /include/inc/ 目录下，新建一个文件，命名为 inc_config_ueditor.php。

   
   （图片来源网络，侵删）

2. 将以下代码复制并粘贴到这个新文件中：

   <?php
   $cfg_editor = 'ueditor';
   $cfg_ueditor_path = $cfg_cmspath.'/include/ueditor/'; // UEditor 的路径，确保正确
   ?>

   • $cfg_ueditor_path：这里的 $cfg_cmspath 是织梦的全局变量，代表网站的根目录，所以这个路径通常不需要修改，除非你把 UEditor 放在了其他位置。

第 5 步：修改 UEditor 初始化文件

为了让织梦能正确加载和初始化 UEditor，我们需要修改 UEditor 自带的初始化文件。

1. 找到 UEditor 文件夹中的初始化文件：/include/ueditor/ueditor.config.js

2. 打开它，找到 window.UEDITOR_CONFIG 对象。

   
   （图片来源网络，侵删）

3. 修改 UEDITOR_CONFIG.serverUrl 的值，让它指向织梦处理 UEditor 请求的 PHP 文件。

   // 在 ueditor.config.js 文件中
   window.UEDITOR_CONFIG = {
       // ... 其他配置 ...
       serverUrl: "/include/ueditor/php/controller.php", // 确保这个路径是正确的
       // ... 其他配置 ...
   };

第 6 步：修改织梦内容编辑模板

我们需要告诉织梦在哪个页面上使用 UEditor。

1. 找到织梦后台内容编辑的模板文件，通常位于：/dede/templets/
2. 在该目录下，找到 article_edit.htm（用于编辑文章）和 article_add.htm（用于添加文章）等文件。
3. 在这些文件中，找到调用 GetEditor() 函数的地方，它通常看起来像这样：

   {dede:field.body function='GetEditor(@me,650,400)'/}

4. 确认：由于我们在第 3 步已经全局修改了 GetEditor() 的行为，这里的代码通常不需要改动，它会自动使用我们配置的 UEditor，但请确保 @me、650（宽度）、400（高度）这些参数符合你的需求。

第 7 步：清理缓存并测试

1. 登录织梦后台，进入【系统】->【SQL命令行工具】。
2. 在命令行窗口中输入 optimize tables dede_arctype,dede_archives,dede_sysconfig; 并执行,这可以优化数据库表并可能清理一些缓存。
3. 清理浏览器缓存。
4. 尝试【新增文章】或【编辑文章】，你应该能看到 UEditor 编辑器已经成功替换了原来的编辑器。

常见问题与解决方案

问题：图片/附件上传失败，提示 请求上传接口http://xxx/ueditor/php/controller.php出错。

• 原因：这几乎 100% 是权限问题。controller.php 文件需要写入权限来处理上传的文件。
• 解决方案：
  1. 通过 FTP 或服务器控制台，确保以下目录具有 755 或 777 的写入权限：
     • /include/ueditor/php/
     • /include/ueditor/php/upload/
     • /include/ueditor/php/upload/file/ (存放上传的文件)
     • /include/ueditor/php/upload/image/ (存放上传的图片)
     • /include/ueditor/php/upload/video/ (存放上传的视频)
     • /include/ueditor/php/upload/scrawl/ (存放涂鸦图片)
  2. 安全提示：777 权限存在安全风险，操作完成后应尽快改回 755，如果空间支持，建议设置正确的用户和组，而不是直接 777。

问题：编辑器加载不出来，或者样式错乱。

• 原因：
  • 路径错误：ueditor.config.js 中的 serverUrl 路径不正确。
  • JS/CSS 文件路径错误：UEditor 的 JS 和 CSS 文件路径可能依赖于 ueditor.config.js 中的 UEDITOR_CONFIG.UEDITOR_HOME_URL。
• 解决方案：
  1. 检查 ueditor.config.js 中的 serverUrl 是否正确。
  2. 检查 article_edit.htm 中引入 UEditor 的 JS 文件路径是否正确，通常应该是：

     <script type="text/javascript" charset="utf-8" src="/include/ueditor/ueditor.config.js"></script>
     <script type="text/javascript" charset="utf-8" src="/include/ueditor/ueditor.all.min.js"></script>

  3. 使用浏览器开发者工具（按 F12）查看 Console（控制台）和 Network（网络）标签，看是否有 404 错误,这能帮你快速定位是哪个文件路径错了。

问题：UEditor 的工具栏按钮太多或太少，想自定义。

• 原因：工具栏的配置项在 ueditor.config.js 文件中。
• 解决方案：
  1. 打开 /include/ueditor/ueditor.config.js。
  2. 找到 toolbars 配置项。
  3. 根据你的需求，修改数组内的元素，只显示最常用的按钮：

     window.UEDITOR_CONFIG = {
         // ...
         toolbars: [
             ['source', 'undo', 'redo', 'bold', 'italic', 'underline', 'fontfamily', 'fontsize', 'forecolor', 'backcolor', 'justifyleft', 'justifycenter', 'justifyright', 'link', 'unlink', 'insertimage', 'insertvideo', 'fullscreen']
         ]
         // ...
     };

问题：如何修改 UEditor 的默认字体、字号等？

• 原因：这些样式定义在 UEditor 的 CSS 文件中。
• 解决方案：
  1. 打开 /include/ueditor/themes/default/css/ueditor.css。
  2. 在文件中搜索 .edui-default .edui-for-fontsize .edui-listitem 等相关样式,进行修改。
  3. 或者，你可以创建一个自定义的 CSS 文件，在 article_edit.htm 中引入它,用更高优先级的样式来覆盖默认样式。

升级与维护建议

1. 安全性：UEditor 1.3.6 版本比较老，可能存在一些已知的漏洞，如果你的网站对安全性要求极高，建议关注官方更新，或寻找更新、更安全的编辑器替代方案（如 TinyMCE, CKEditor 5 等）。
2. 保持更新：虽然 1.3.6 很稳定，但如果官方发布了修复安全补丁的版本,可以考虑升级。
3. 备份：在进行任何修改（尤其是文件修改）之前,务必备份你的网站文件和数据库。

希望这份详细的指南能帮助你成功地在织梦系统中使用 UEditor 1.3.6！