add_filter()

描述

WordPress提供了过滤器挂钩，以允许插件在运行时修改各种类型的内部数据。

插件可以通过将回调绑定到过滤器挂钩来修改数据。稍后应用过滤器时，将按优先级顺序运行每个绑定的回调，并有机会通过返回新值来修改值。

以下示例显示了如何将回调函数绑定到过滤器挂钩。

请注意，将$ example传递给回调，（可能）对其进行了修改，然后返回：

函数example_callback（$ example）{
    //也许以某种方式修改$ example。
    返回$ example;
}
add_filter（'example_filter'，'example_callback'）;  

绑定的回调可以接受从不
接受到相应的apply_filters（）调用中作为参数传递的参数总数。

换句话说，如果apply_filters（）调用总共传递了四个参数，则绑定到
该参数的回调可以不接受任何参数（与1相同）或最多接受四个参数。重要的是，
$ accepted_args值必须反映绑定回调实际
选择接受的参数数量。如果回调没有接受任何参数，则认为
与接受1个参数相同。例如：

//过滤调用。
$ value = https://developer.wordpress.org/reference/functions/add_filter/apply_filters('hook'，$ value，$ arg2，$ arg3）;

//接受零/一参数。
函数example_callback（）{
    ...
    返回“一些价值”；
}
add_filter（'hook'，'example_callback'）; //其中$ priority默认为10，$ accepted_args默认为1。

//接受两个参数（三个可能）。
函数example_callback（$ value，$ arg2）{
    ...
    返回$ maybe_modified_value;
}
add_filter（'hook'，'example_callback'，10，2）; //其中$ priority为10，$ accepted_args为2。 

_注意：_无论回调是否有效，该函数都将返回true。请您自己保重。这样做是出于优化目的，因此一切都尽可能快。