WordPress: Function Reference/add action:修订间差异
来自站长百科
(新页面: == Description == Hooks a function on to a specific action. See Plugin API for a list of hooks for act...) |
无编辑摘要 |
||
第1行: | 第1行: | ||
== Description == | == Description == | ||
== 描述== | |||
Hooks a function on to a specific [[WordPress:Plugin_API#Actions|action]]. See [[WordPress:Plugin_API#Current_Hooks_For_actions|Plugin API]] for a list of hooks for action. | Hooks a function on to a specific [[WordPress:Plugin_API#Actions|action]]. See [[WordPress:Plugin_API#Current_Hooks_For_actions|Plugin API]] for a list of hooks for action. | ||
Hooks函数到一个特别的[[WordPress:Plugin_API#Actions|action]]。请看看[[WordPress:Plugin_API#Current_Hooks_For_actions|Plugin API|插件API]]关于hooks for action的列表。 | |||
== Usage == | == Usage == | ||
== 用法 == | |||
%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%% | |||
%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%% | %%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%% | ||
== Examples == | == Examples == | ||
== 例子 == | |||
To email some friends whenever an entry is posted on your blog: | To email some friends whenever an entry is posted on your blog: | ||
给一些朋友发送电子邮件,询问你的博客上是否已经发表了一篇文章。 | |||
<pre> | |||
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'); | |||
</pre> | |||
<pre> | <pre> | ||
第22行: | 第44行: | ||
== Parameters == | == Parameters == | ||
== 参数 == | |||
; <tt>$tag</tt> : (''string'') The name of the action you wish to hook onto. | ; <tt>$tag</tt> : (''string'') The name of the action you wish to hook onto. | ||
; <tt>$tag</tt> : (''string'')你想要hook onto的action的名称。 | |||
; <tt>$function_to_add</tt> : (''callback'') The name of the function you wish to be called. Note: any of the syntaxes explained in [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback the PHP documentation for the 'callback' type] are valid. | ; <tt>$function_to_add</tt> : (''callback'') The name of the function you wish to be called. Note: any of the syntaxes explained in [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback the PHP documentation for the 'callback' type] are valid. | ||
; <tt>$function_to_add</tt> : (''callback'')你希望调用的函数的名称。注:[http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback the PHP documentation for the 'callback' type]中解释的任何语法都是有效的。 | |||
; <tt>$priority</tt> : 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. | ; <tt>$priority</tt> : 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. | ||
; <tt>$priority</tt> :你的函数有多么重要。更改这个重要性,使得你的函数在其它函数之前或者之后得到调用。默认值是10,因此(例如)将这个值设置为5,会使得函数更早运行,如果设置为12,会使得函数迟一点运行。 | |||
; <tt>$accepted_args</tt> : 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 <tt>comment_id_not_found</tt> will pass any functions that hook onto it the ID of the requested comment. | ; <tt>$accepted_args</tt> : 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 <tt>comment_id_not_found</tt> will pass any functions that hook onto it the ID of the requested comment. | ||
; <tt>$accepted_args</tt> :你的函数拥有多少个参数。在WordPress1.5.1+,hooked 函数可以获得,matching do_action() 或者apply_filters() call运行时,设置的额外参数。例如,action <tt>comment_id_not_found</tt>会传递任何hook onto it需要的评论ID的函数。 |
2008年7月21日 (一) 15:32的版本
Description
描述
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的列表。
Usage
用法
%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%%
%%% <?php add_action($tag, $function_to_add, $priority = 10, $accepted_args = 1); ?> %%%
Examples
例子
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');
Parameters
参数
- $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的函数。