bbPress 子站点不显示编辑器问题

🧩 问题记录与分析：bbPress 子站点不显示编辑器问题

🧾 问题概述

在 WordPress 多站点环境中，主站点上的 bbPress 论坛页面能够正常显示编辑器工具栏，但在某个子站点（如开发者社区）中，bbPress 编辑器工具栏缺失，且无法正常输入内容。

这一问题在禁用了 BuddyPress 插件相关脚本之后开始出现，表现为：

• 话题/回复编辑器完全不渲染；

• 或渲染了 <textarea>，但无 JS 行为，无工具条。

🔍 调试过程与发现

✅ 1. 初步排查

• 确认当前主题无 JS 报错；

• bbPress 本体运行正常；

• 编辑器缺失并非由 bbPress 配置或权限问题引起；

• 主题和插件未被修改；

• Perfmatters 插件启用了脚本延迟和排除机制。

✅ 2. 定位问题资源

通过逐一对比主站点与子站点加载的资源，发现以下两项 在主站存在，子站被禁用：

这两项脚本属于 BuddyPress 插件，并在 bbPress 嵌套于 BuddyPress 的场景（如 /members/*/forums/）中被广泛使用。

其中，bp-legacy-js 是编辑器初始化的必要依赖之一。

🛠 问题原因

Perfmatters 插件启用了**脚本按需加载（Script Manager）**功能，错误地将 BuddyPress 脚本标记为“在该页面未使用”，从而在子站点完全移除这两个关键 JS。

由于 bbPress 与 BuddyPress 存在耦合关系，在用户页面（如成员/组/论坛活动）中必须加载 bp-legacy-js 才能正常启用编辑器。

✅ 解决方案

方法一：Perfmatters 中单独启用

进入 Perfmatters → Script Manager：

1. 访问子站的论坛页面；

2. 勾选 Always Load 选项，启用：

   • /wp-content/plugins/buddypress/bp-core/js/vendor/jquery-cookie.min.js

   • /wp-content/plugins/buddypress/bp-templates/bp-legacy/js/buddypress.min.js

   方法二：代码自动加载（推荐）

为避免日后手动错误，建议在主题或功能插件中加入以下代码，自动在 bbPress 页面加载必需脚本：

add_action('wp_enqueue_scripts', function () {
    if (function_exists('is_bbpress') && is_bbpress()) {
        wp_enqueue_script('bp-legacy-js');
        wp_enqueue_script('bp-jquery-cookie');
    }
}, 15);

📌 总结建议

• bbPress 与 BuddyPress 在页面层面存在 JS 依赖，不可完全分离；

• 使用 Perfmatters 或类似插件时，务必标记论坛页面为例外页面；

• 推荐使用代码控制资源加载，以避免“误优化”带来的功能损坏；

• 多站点环境中，子站点的 UI 问题常常源于资源未加载或被 CDN 缓存。