高级主题_WordPress插件开发手册

主题甚至可以从WordPress Core已注册的钩子中删除回调函数。

要从挂钩中删除回调函数，您需要调用 remove_action（）或 remove_filter（），这取决于回调函数是作为Action还是Filter来添加。

传递给remove_action（）/ remove_filter（）的参数应与传递给注册它的 add_action（）/ add_filter（）的参数相同。

警报：要成功删除回调函数，您必须在注册回调函数后执行删除。执行顺序很重要。

我们希望通过删除不必要的功能来改善大型主题的性能。

通过查看functions.php来分析主题的代码。

<?php
function my_theme_setup_slider()
{
    // ...
}
add_action('template_redirect', 'my_theme_setup_slider', 9);

my_theme_setup_slider函数正在添加一个我们不需要的滑块，这可能会加载一个巨大的CSS文件，然后是一个JavaScript初始化文件，它使用大小为1MB的自定义书写库。我们可以摆脱这一点。

因为我们希望在注册my_theme_setup_slider回调函数（functions.php执行）之后挂接到WordPress中，所以最好的机会是after_setup_theme钩子。

<?php
function wporg_disable_slider()
{
    // make sure all parameters match the add_action() call exactly
    remove_action('template_redirect', 'my_theme_setup_slider', 9);
}
// make sure we call remove_action() after add_action() has been called
add_action('after_setup_theme', 'wporg_disable_slider');

删除所有回调

您也可以使用 remove_all_actions（）/ remove_all_filters（） 来删除与钩子相关联的所有回调函数。

有时您想要在多个钩子上运行一个Action或Filter，但是根据当前调用它的行为有所不同。

您可以使用 current_action（）/ current_filter（）来确定当前的Action / Filter。

<?php
function wporg_modify_content($content)
{
    switch (current_filter()) {
        case 'the_content':
            // do something
            break;
        case 'the_excerpt':
            // do something
            break;
    }
    return $content;
}
add_filter('the_content', 'wporg_modify_content');
add_filter('the_excerpt', 'wporg_modify_content');

检查一个钩子有多少次运行

一些钩子在执行过程中被多次调用，但您可能只希望您的回调函数运行一次。

在这种情况下，您可以使用 did_action（）检查钩子运行的次数。

<?php
function wporg_custom()
{
    if (did_action('save_post') !== 1) {
        return;
    }
    // ...
}
add_action('save_post', 'wporg_custom');

用“all”钩子调试

如果你想要一个回调函数在每个钩子上触发，你可以注册到所有的钩子。有时，这在调试情况有助于确定特定事件何时发生或页面崩溃时有用。

<?php
function wporg_debug()
{
    echo '<p>' . current_action() . '</p>';
}
add_action('all', 'wporg_debug');

下一节：顶级菜单呈现在WordPress管理的左侧。每个菜单可能包含一组子菜单。