WordPress函数remove_action()移除动作hook挂载的函数

remove_action() 函数移除一个附属于指定动作hook的函数。该方法可用来移除附属于特定动作hook的默认函数,并可能用其它函数取而代之。

重要:添加hook时的$function_to_remove 和$priority参数要能够相匹配,这样才可以移除hook。该原则也适用于过滤器和动作。移除失败时不进行警告提示。

示例

该函数与 remove_filter() 函数对等。

<?php remove_action($tag, $function_to_remove, $priority, $accepted_args); ?>

Woocommerce 商城插件中,移除商品详情页后边的“相关产品”展示,只需要移除hook钩子woocommerce_after_single_product_summary 下挂载的“相关产品”的函数即可。

/**
 * 产品详情页,取消“相关产品”展示
 * Remove related products output
 * 参考:http://yangjunwei.com/3102.html
 */
remove_action( 'woocommerce_after_single_product_summary', 'woocommerce_output_related_products', 20 );

参数

$tag

(字符串)(必需)将要被删除的函数所连接到的动作hook。

默认值:None

$function_to_remove

(回调)(必需) 将要被删除函数的名称

默认值:None

$priority

(整数)(可选)函数优先级(在函数最初连接时定义)

默认值:10

$accepted_args

(整数)(必需)函数所接受参数的数量。

默认值:1

返回的值

(布尔值)函数是否被移除。

Ttue

函数被成功移除

False

函数未被移除

参考Wordpress Code Reference详解

参与评论