预装SevenHills主题的WordPress站点Gutenberg编辑器不显示求助

1. 主题层面排查 #

• 检查SevenHills主题自带配置：大部分搭配WPBakery的商业预装主题，会自带编辑器切换选项，通常在主题设置-后台功能/编辑器配置分类下，查找是否有强制启用经典编辑器、禁用古腾堡的开关。
• 检查主题functions.php文件代码：搜索是否存在以下禁用古腾堡的代码片段，存在的话直接注释或删除即可：

  // 禁用古腾堡的常见代码段
  add_filter('use_block_editor_for_post', '__return_false');
  add_filter('gutenberg_can_edit_post', '__return_false');
  add_filter('use_widgets_block_editor', '__return_false');
  

• 临时切换默认主题验证：后台切换到WordPress官方默认主题（如Twenty Twenty-Four），测试是否能正常打开古腾堡，如果可以则确定是SevenHills主题的限制。

2. 插件层面排查 #

• 排查其他已安装插件：除了WPBakery外，很多优化类、后台自定义类、经典编辑器相关插件都会强制禁用古腾堡，可通过批量禁用插件后逐枚启用的方式定位冲突插件。
• 检查隐藏的经典编辑器启用逻辑：部分插件不会在设置页显示禁用古腾堡的选项，但代码中默认加载了经典编辑器的过滤规则，排查时优先核对后台管理类、性能优化类插件的功能说明。

3. WordPress全局配置排查 #

• 检查站点根目录下的wp-config.php文件：搜索是否存在定义古腾堡禁用的常量，如下所示，找到后删除即可：

  define('GUTENBERG_DISABLED', true);
  

• 检查用户角色权限配置：当前登录的管理员账号是否有编辑对应文章类型的完整权限，可通过新建一个管理员账号测试是否能正常使用古腾堡编辑器。
• 检查文章类型配置：确认你要编辑的文章类型（通常是post）是否在注册时就设置了不支持块编辑器，可通过自定义文章类型管理工具查看对应文章类型的编辑器支持配置。

4. 自定义代码片段排查 #

• 检查额外添加的自定义代码：很多站点会通过代码片段插件、子主题functions.php、或者wp-content/mu-plugins目录下的必须插件添加禁用古腾堡的代码，重点排查这几个位置的代码内容。
• 检查后台的自定义代码管理模块：部分主题自带自定义代码插入功能，也有可能在里面加入了禁用古腾堡的过滤代码。

内容的提问来源于stack exchange，提问作者Leonardo Barilari