将功能挂钩到特定操作。

原型

add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 )

描述

动作是WordPress核心在执行期间或特定事件发生时在特定点启动的钩子。插件可以指定使用Action API在这些点上执行其一个或多个PHP函数。

参数

$tag (string) (Required) $ function_to_add挂钩的操作的名称。

$function_to_add (callable) (Required) 你希望调用的函数的名称。

$priority (int) (Optional)  用于指定与特定操作关联的功能的执行顺序。较低的数字与先前的执行相对应,具有相同优先级的函数按照它们添加到操作的顺序执行。

$accepted_args (int) (Optional)  函数接受的参数数量。

返回值

(true)  永远都会回归真实。

源文件

路径:wp-includes/plugin.php

<?php
...
function add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1) {
	return add_filter($tag, $function_to_add, $priority, $accepted_args);
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/add_action/