编辑“WordPress常用函数add action”

<span style="border:1px solid #000; text-align:center; float:right; padding:6px;"><strong>导航:</strong> 
[[WordPress常用函数(中)|
上一页]] | {{Template:WordPress导航}}</span>
<div style="clear:both;"></div>
==说明==
将函数连接到指定[http://codex.wordpress.org/Plugin_API#Actions action]（动作）。

在[http://codex.wordpress.org/Plugin_API/Action_Reference Plugin API/Action   Reference] 上查看动作hook列表。wordpress核心调用[http://codex.wordpress.org/Function_Reference/do_action do_action()] 时触发动作。

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

==示例==
博客发表新内容时用[[电子邮件]]通知朋友：

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

'''参数'''

<STRONG>$tag</STRONG>

（字符串）希望连接到的动作名称（在[http://codex.wordpress.org/Plugin_API/Action_Reference Plugin API/Action   Reference] 上查看动作hook列表）

<STRONG>$function_to_add</STRONG>

（回调）希望调用的函数名称。注意： [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback the   PHP documentation for the 'callback' type]中解释的语法均可用。

'''$priority'''

函数的重要程度。改变此参数以决定函数与其他函数的调用顺序。默认值为10，因此（例如）将值设为5时函数运行较早，设为12时运行则较晚。

'''$accepted_args'''

函数所接受参数的数量。在WordPress 1.5.1及之后版本中，连接的函数可吸收其它在调用do_action() 或 apply_filters()时设置的参数。例如，comment_id_not_found动作将传递任何函数，若该函数将所请求的评论编号连接到该动作。

==相关条目==
*[[Drupal]] 
*[[OBLOG]] 
*[[X-Space]] 
*[[SaBlog-X]] 
*[[Bo-Blog]]

[[category:WordPress中文文档|G]]
[[category:WordPress网站开发|G]]
[[category:WordPress开发文档|G]]