概述

switch_theme 是一个 WordPress 动作钩子，在主题切换后触发，主要用于主题停用时的清理或设置操作。它允许开发者在主题被停用时执行特定函数，例如刷新重写规则或删除选项。

关键要点

• switch_theme 在博客主题更改后触发，但在下一个请求之前执行。
• 此钩子仅在被停用的主题中触发，适用于主题停用时的操作；主题激活时应使用 after_switch_theme。
• 钩子函数接收一个参数：新主题名称的字符串，但实际源参数包括 $new_name、$new_theme 和 $old_theme。
• 从 WordPress 4.5.0 版本开始引入了 $old_theme 参数，提供旧主题的 WP_Theme 实例。

代码示例

function deactivate_my_theme( $new_theme ) {
    flush_rewrite_rules(false);
}
add_action( 'switch_theme', 'deactivate_my_theme' );

add_action('switch_theme', 'mytheme_setup_options');

function mytheme_setup_options () {
  delete_option('mytheme_enable_features');
  delete_option('mytheme_enable_catalog');
}

注意事项

确保在主题停用时使用此钩子，避免与激活操作混淆；参数传递需注意版本差异，特别是 $old_theme 在 4.5.0 及之后可用。