WordPress中文开发手册

  1. Home
  2. Docs
  3. WordPress中文开发手册
  4. WordPress插件开发
  5. Hooks
  6. 高级主题

高级主题

删除操作和过滤器

有时您想要从另一个插件,主题甚至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');