WordPress 中 add_action 函数的用法

add_action 函数可以说是 WordPress 中最常用的函数之一。简而言之,它允许在发生特定挂钩时运行函数。在本文中,我们将向您介绍 add_action 函数的基本用法。

例如,如果您想在文章中添加预计阅读时间,既可以使用该函数。

add_action 函数用法

<?php add_action($hook, $function_to_add, $priority, $accepted_args); ?>

add_action 函数参数

$hook

此必选参数确定将被挂钩的操作。每当运行此操作时, add_action 中定义的关联函数也将运行。这可以是运行的任何操作的名称,包括位于主题或插件中的操作。

$function_to_add

这是一个必选参数,允许您定义将在先前定义的操作发生时运行的函数。只需在此处放置所需函数的名称,即可在每次调用$hook 参数中的操作时运行它。

$priority

此为可选参数,允许您定义函数的执行顺序。如果您有多个函数发生在特定操作挂钩上,可以调整此参数以确定它们执行的顺序。较小的数字执行得更早,较大的数字和具有相同优先级的函数将按照它们添加的顺序执行。

$accepted_args

$accepted_args 参数允许定义从操作挂钩到在 add_action 函数中调用的函数的参数数量

代码示例

<?php
function detect_published_post ( $new_status = NULL, $old_status = NULL, $post_ID = NULL ) {
if ( 'publish' == $new_status && 'publish' != $old_status ) {
echo 'This new post has been published: ' . $post_ID->post_title;
}
}

add_action( 'transition_post_status', 'detect_published_post', 10, 3 );
?>

在这个例子中,我们在 transition_post_status 钩子启动时调用了 detect_published_post 函数  。我们将优先级定义为 10,将接受的参数定义为 3,因为 transition_post_status 挂钩提供新状态、旧状态和文章 ID 等信息。由于我们想在代码中使用这些参数,所以在函数中定义了它们。我们可以很容易地对这些信息做任何想做的事情,并在帖子状态发生变化时立即进行更改。

作者:牛奇网,本站文章均为辛苦原创,在此严正声明,本站内容严禁采集转载,面斥不雅请好自为之,本文网址:https://www.niuqi360.com/wordpress/wordpress-add_action-function/

(0)
上一篇 5小时前

相关推荐

发表评论

登录后才能评论