WordPress的hook(钩子)是一种机制,允许开发人员在特定的时间点执行自己的代码。其中一个常用的hook是add_term_relationship,用于在给一个分类或标签添加关联对象的时候触发。
add_term_relationship的用法如下:
add_action( 'add_term_relationship', 'my_function', 10, 3 );
function my_function( $object_id, $term_id, $taxonomy ) {
// 在这里添加你的代码
}
参数说明:
- $object_id:关联对象的ID,通常是文章或自定义文章类型的ID。
- $term_id:分类或标签的ID。
- $taxonomy:分类或标签所属的分类法或标签法。
在my_function函数中,你可以编写你想要执行的代码。比如,你可以在一个文章被添加到一个特定标签时发送一封电子邮件通知管理员。
可以通过add_action来注册add_term_relationship钩子。第一个参数是钩子的名称,第二个参数是要执行的函数名,第三个参数是指定函数的优先级,默认为10,数字越小优先级越高。最后一个参数是函数的参数数量,这里是3,对应着上面提到的三个参数。
需要注意的是,add_term_relationship只在添加新的关联时触发一次,而不会在更新或删除关联时触发。
另外,也可以使用remove_action函数来取消已注册的add_term_relationship钩子,例如:
remove_action( 'add_term_relationship', 'my_function', 10 );
这样,my_function函数将不再被执行。
总结来说,add_term_relationship钩子可以用于在给一个分类或标签添加关联对象时执行自定义的代码,可以对该函数进行注册和取消注册。