WordPress:Function Reference/add action

描述

Hooks a function on to a specific action. See Plugin API for a list of hooks for action.

Hooks函数到一个特别的action。请看看Plugin API|插件API关于hooks for action的列表。

用法

%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%%

%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%%

例子

To email some friends whenever an entry is posted on your blog:

给一些朋友发送电子邮件，询问你的博客上是否已经发表了一篇文章。

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');

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');

参数

$tag

(string) The name of the action you wish to hook onto.

$tag

(string)你想要hook onto的action的名称。

$function_to_add

(callback) The name of the function you wish to be called. Note: any of the syntaxes explained in the PHP documentation for the 'callback' type are valid.

$function_to_add

(callback)你希望调用的函数的名称。注：the PHP documentation for the 'callback' type中解释的任何语法都是有效的。

$priority

How important your function is. Alter this to make your function be called before or after other functions. The default is 10, so (for example) setting it to 5 would make it run earlier and setting it to 12 would make it run later.

$priority

你的函数有多么重要。更改这个重要性，使得你的函数在其它函数之前或者之后得到调用。默认值是10，因此（例如）将这个值设置为5，会使得函数更早运行，如果设置为12，会使得函数迟一点运行。

$accepted_args

How many arguments your function takes. In WordPress 1.5.1+, hooked functions can take extra arguments that are set when the matching do_action() or apply_filters() call is run. For example, the action comment_id_not_found will pass any functions that hook onto it the ID of the requested comment.

$accepted_args

你的函数拥有多少个参数。在WordPress1.5.1+，hooked 函数可以获得，matching do_action() 或者apply_filters() call运行时，设置的额外参数。例如，action comment_id_not_found会传递任何hook onto it需要的评论ID的函数。