Ready to get started?Download WordPress


Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

zh-cn:函数参考/add action

本文已被标记为未完成状态。您可以将其补充或翻译完整,以此帮助完善 Codex。



对于这些动作,您可以在Plugin API/Action Reference上查看。当在Wordpress内部调用do_action()时,这些动作将被触发。


 <?php add_action$tag$function_to_add$priority$accepted_args ); ?> 


(string) (参数必需) 动作的名字。 (对于这些动作,您可以在Plugin API/Action Reference上查看。)
Default: 没有默认值
(callback) (参数必需) 动作触发时,被调用函数的名字。 注释:在PHP文档中 'callback' 类型的语法解释是有效的。
Default: 没有默认值
(int) (参数可选) 函数的优先级。改变这个值可以让您的函数在其他函数之前执行,或者是之后执行。默认值为10,例如把这个值设置为5将更早的被执行,设置为12将会晚一些执行。也就是小的值被优先执行。
Default: 10
(int) (参数可选) 函数参数的个数。在 WordPress 1.5.1+, 当匹配的 do_action()apply_filters()运行,钩子函数可以传入格外的参数。例如动作comment_id_not_found可以传入评论的ID。
Default: 1


Simple Hook


function email_friends($post_ID)  {
   $friends = 'bob@example.org, susie@example.org';
   mail($friends, "sally's blog updated" , 'I just put something on my blog: http://blog.example.com');
   return $post_ID;

add_action('publish_post', 'email_friends');

获取 参数

The hooked function takes one argument from the action. Specifically, the 'echo_comment_id' function, takes the argument $comment_ID. It then echos the value of the received argument.

function echo_comment_id($comment_ID) {
   echo "I just received $comment_ID";
add_action('comment_id_not_found','echo_comment_id', 10, 1);


To find out the number and name of arguments for an action, simply search the code base for the matching do_action() call. For example, if you are hooking into 'save_post', you would find it in post.php:

do_action('save_post', $post_ID, $post);

Your add_action call would look like:

add_action('save_post', 'my_save_post', 10, 2);

And your function would be:

function my_save_post($post_ID, $post){
  //code here

Change Log

Since: 1.2.0

Source File

add_action() is located in wp-includes/plugin.php.


Actions: has_action(), add_action(), do_action(), do_action_ref_array(), did_action(), remove_action(), remove_all_actions()

See also index of Function Reference and index of Template Tags.
This article is marked as in need of editing. You can help Codex by editing it.