WordPress自定义插件激活时出现Header修改错误及Kadence安装问题

错误原因 #

你遇到的两个错误本质是同一问题导致的：

1. Cannot modify header information：WordPress插件激活流程需要执行HTTP跳转，但你的激活函数中直接调用的Theme_Upgrader/Plugin_Upgrader类默认会输出安装进度HTML，提前发送了内容，导致后续无法修改HTTP头。
2. ob_end_clean()：WordPress激活时会维护输出缓冲栈，而升级类的内部缓冲操作与激活流程的缓冲冲突，导致缓冲栈为空时仍尝试清理。

核心问题：插件激活钩子中不能直接执行会产生输出的操作，必须延迟到激活流程完成后再执行。

解决方案 #

1. 修改激活逻辑，延迟执行操作 #

将所有安装、清理操作从激活函数中移除，改用WP Cron单次事件或admin_init钩子延迟执行，确保激活跳转完成后再处理任务。

2. 自定义静默升级皮肤，抑制输出 #

默认的升级类会输出HTML进度，需要自定义一个无输出的升级皮肤，避免提前发送内容。

修改后的完整代码示例 #

第一步：修改插件激活函数

public static function activate() {
    // 调度单次事件，激活后1秒执行所有设置操作
    wp_schedule_single_event(time() + 1, 'custom_plugin_run_setup');
    
    // 或者用临时标记，在admin_init中触发（二选一即可）
    // update_option('custom_plugin_needs_setup', '1');
}

第二步：添加事件钩子与自定义静默皮肤

// 注册自定义事件钩子
add_action('custom_plugin_run_setup', [__CLASS__, 'run_all_setup_tasks']);

// 自定义静默升级皮肤，禁止所有输出
class Silent_Upgrader_Skin extends WP_Upgrader_Skin {
    public function feedback($feedback, ...$args) {}
    public function header() {}
    public function footer() {}
}

// 统一执行所有设置任务
public static function run_all_setup_tasks() {
    self::add_kadence();
    self::remove_default_content();
    self::delete_old_themes();
    self::install_svg_support();
    
    // 添加完成提示
    add_action('admin_notices', function() {
        echo '<div class="notice notice-success is-dismissible"><p>自定义插件初始化完成！</p></div>';
    });
}

第三步：修改add_kadence函数，使用静默皮肤

public static function add_kadence() {
    include_once(ABSPATH . 'wp-admin/includes/class-wp-upgrader.php');
    include_once(ABSPATH . 'wp-admin/includes/class-wp-upgrader-skins.php');

    $kadence_blocks_slug = 'kadence-blocks';
    $kadence_theme_slug = 'kadence';
    $child_theme_slug = $kadence_theme_slug . '-child';

    // 主主题安装
    $kadence_theme_installed = wp_get_theme($kadence_theme_slug);
    if (!$kadence_theme_installed->exists()) {
        $kadence_theme_url = 'https://downloads.wordpress.org/theme/' . $kadence_theme_slug . '.zip';
        $kadence_theme_installer = new Theme_Upgrader(new Silent_Upgrader_Skin());
        $installation = $kadence_theme_installer->install($kadence_theme_url);
        if (is_wp_error($installation)) {
            error_log('Kadence主题安装失败: ' . $installation->get_error_message());
            return;
        }
    }

    // 子主题安装与切换
    $child_theme_installed = wp_get_theme($child_theme_slug);
    if (!$child_theme_installed->exists()) {
        $kadence_child_theme_url = 'https://dl.dropboxusercontent.com/scl/fi/zca2facxnwbl3le9jg6ke/' . $kadence_theme_slug . '-child.zip?rlkey=fo2sjq4fbmwhctb677u559w2a&dl=0';
        $kadence_child_theme_installer = new Theme_Upgrader(new Silent_Upgrader_Skin());
        $installation = $kadence_child_theme_installer->install($kadence_child_theme_url);
        if (is_wp_error($installation)) {
            error_log('Kadence子主题安装失败: ' . $installation->get_error_message());
            return;
        }
        switch_theme($child_theme_slug);
    }

    // Kadence Blocks安装激活
    $kadence_blocks_path = $kadence_blocks_slug . '/' . $kadence_blocks_slug . '.php';
    $kadence_blocks_installed = file_exists(WP_PLUGIN_DIR . '/' . $kadence_blocks_path);
    if (!$kadence_blocks_installed || !is_plugin_active($kadence_blocks_path)) {
        $kadence_blocks_url = 'https://downloads.wordpress.org/plugin/' . $kadence_blocks_slug . '.zip';
        $kadence_blocks_installer = new Plugin_Upgrader(new Silent_Upgrader_Skin());
        $installation = $kadence_blocks_installer->install($kadence_blocks_url);
        if (is_wp_error($installation)) {
            error_log('Kadence Blocks插件安装失败: ' . $installation->get_error_message());
            return;
        }
        activate_plugin($kadence_blocks_path);
    }
}

第四步：补充其他设置函数示例（如删除默认内容）

public static function remove_default_content() {
    // 删除默认文章"Hello World!"
    $default_post = get_page_by_title('Hello World!', OBJECT, 'post');
    if ($default_post) {
        wp_delete_post($default_post->ID, true);
    }
    
    // 删除默认页面"Sample Page"
    $default_page = get_page_by_title('Sample Page', OBJECT, 'page');
    if ($default_page) {
        wp_delete_post($default_page->ID, true);
    }
}

public static function delete_old_themes() {
    $old_themes = ['twentytwentyfour', 'twentytwentythree'];
    foreach ($old_themes as $theme_slug) {
        $theme = wp_get_theme($theme_slug);
        if ($theme->exists()) {
            delete_theme($theme_slug);
        }
    }
}

public static function install_svg_support() {
    $svg_plugin_slug = 'svg-support';
    $svg_plugin_path = $svg_plugin_slug . '/' . $svg_plugin_slug . '.php';
    
    if (!file_exists(WP_PLUGIN_DIR . '/' . $svg_plugin_path) || !is_plugin_active($svg_plugin_path)) {
        include_once(ABSPATH . 'wp-admin/includes/class-wp-upgrader.php');
        $svg_installer = new Plugin_Upgrader(new Silent_Upgrader_Skin());
        $installation = $svg_installer->install('https://downloads.wordpress.org/plugin/svg-support.zip');
        if (!is_wp_error($installation)) {
            activate_plugin($svg_plugin_path);
        } else {
            error_log('SVG支持插件安装失败: ' . $installation->get_error_message());
        }
    }
}

关键说明 #

• 延迟执行：确保激活流程的HTTP跳转完成后再执行任务，避免输出冲突。
• 静默皮肤：完全抑制升级类的HTML输出，防止提前发送内容导致头信息错误。
• 统一调度：将所有初始化任务放在同一个函数中，便于维护和错误追踪。

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