Perfmatters在wordpress与bbpress环境

1. ✅ Perfmatters 的工作原理简析

2. 🚫 为何在特定环境下需要排除这些 CSS 文件

3. 📋 每条排除路径的详细说明与原因

4. ⚙️ 如何正确设置排除规则

✅ 一、Perfmatters 的工作原理简析

Perfmatters 是一个轻量级性能优化插件，主要通过“按需加载（Asset Unloading）”来加速 WordPress 页面加载：

• 👉 精简 HTTP 请求

• 👉 延迟或禁用不必要的 JS/CSS 文件

• 👉 移除默认行为（如表情脚本、oEmbed）

• 👉 针对每个页面类型单独配置加载资源（条件逻辑）

它的核心理念是：“页面不需要的，就不加载”。

然而，这种策略在涉及复杂插件（如 bbPress、BuddyPress）时，若误判或卸载核心 CSS 文件，会直接造成界面错乱或功能失效。

🚫 二、为什么要“排除”这些 CSS 文件？

在论坛（bbPress）、社区（BuddyPress）或其他交互插件中，大量核心功能依赖特定 CSS：

• bbPress： 帖子结构、按钮、用户资料样式

• BuddyPress： 活动流、好友系统、消息系统等模块的 UI

• 自定义主题： 可能将组件样式集成于主题下的 lib/css/*.css

• 第三方插件（如 AudioIgniter、AI Engine Pro）： 播放器与 AI 聊天界面需要完整样式

Perfmatters 如果默认判断某些页面未使用这些样式，就可能卸载，导致界面失控。

所以，我们需要在 Asset Unloading 中“排除”这些关键 CSS 文件，确保它们永远不会被卸载。

📋 三、排除路径

/wp-content/themes/newvfx/lib/css/bbpress.css
/wp-content/fv-flowplayer-custom/style-1.css
/wp-content/plugins/bbpress/templates/default/css/bbpress.min.css
/wp-content/plugins/buddypress/bp-templates/bp-legacy/css/buddypress.min.css
/wp-content/themes/newvfx/lib/css/bp.css
/wp-content/plugins/open-social/res/main.css
/wp-content/themes/newvfx/style.css
/wp-content/plugins/audioigniter/player/build/style.css
/wp-content/plugins/ai-engine-pro/themes/timeless.css
/wp-content/themes/newvfx-child/style.css

⚙️ 四、如何正确设置排除

方法一：

在 Perfmatters 插件界面操作

1. 打开 WordPress 后台 → Perfmatters → Assets

2. 进入任一页面，启用“Script Manager”

3. 找到对应 CSS 项目，点击「排除（Always Load）」或添加“条件规则”

4. 对论坛、社区、播放器页面添加 Always Load，避免被卸载

方法二：

通过条件规则（正则/路径）手动添加

在 wp-content/themes/your-theme/functions.php 中使用 Perfmatters 提供的 Hook：

add_filter('perfmatters_exclude_assets', function($excluded) {
    $excluded[] = '/wp-content/plugins/bbpress/templates/default/css/bbpress.min.css';
    $excluded[] = '/wp-content/plugins/buddypress/bp-templates/bp-legacy/css/buddypress.min.css';
    $excluded[] = '/wp-content/themes/newvfx/style.css';
    return $excluded;
});

✅ 建议配合页面模板 ID、URL path（如 /forum/、/members/）来判断是否排除。

🧠 总结：为何排除 Perfmatters 中的某些资源？