最新消息:重新回归WordPress,我要比较认真的开始更新我的博客了。

WordPress常用钩子(ACTION)

程序问题 hanlei 1814浏览

在典型请求中运行的动作钩子

在WordPress中,当已登录用户在默认主题打开网站主页时,WordPress会运行以下动作钩子函数:

  1. plugins_loaded
  2. sanitize_comment_cookies
  3. setup_theme
  4. auth_cookie_malformed
  5. auth_cookie_valid
  6. set_current_user
  7. init
  8. widgets_init
  9. parse_request
  10. send_headers
  11. pre_get_posts
  12. posts_selection
  13. wp
  14. template_redirect
  15. get_header
  16. wp_head
  17. wp_print_styles
  18. wp_print_scripts
  19. loop_start
  20. loop_end
  21. get_sidebar
  22. wp_meta
  23. get_footer
  24. wp_footer

日志、页面、附件以及类别相关的动作钩子函数

add_attachment

附件文件首次加入数据库时,执行add_attachment函数。函数接收的参数:附件ID。

add_category

与create_category相同。

clean_post_cache

清除日志缓存时,执行该动作函数。函数接收的参数:日志ID。参见clean_post_cache()

create_category

生成新类别时,执行该动作函数。函数接收的参数:类别ID。

delete_attachment

从数据库和相应链接/日志中删除某个类别后,执行该动作函数。函数接收的参数:类别ID。

delete_post

将要删除某篇日志或页面时,执行该动作函数。函数接收的参数:日志ID或页面ID。

deleted_post

删除某篇日志或页面后,执行该动作函数。函数接收的参数:日志ID或页面ID。

edit_attachment

数据库中附件文件被更新时执行该动作函数。函数接收的参数:附件ID。

edit_category

更新/编辑某个类别时(包括添加/删除日志或博客反向链接,或更新日志/博客反向链接的类别),执行该动作函数。函数接收的参数:类别ID。

edit_post

更新/编辑某篇日志或页面时(包括添加/更新评论,这会导致日志评论总数的更新),执行该动作函数。函数接收的参数:日志ID或页面ID。

pre_post_update

更新日志或页面前执行该动作函数。函数接收的参数:日志ID。

private_to_publish

当日志状态从private(私密)更改为published(公开)时,执行该动作函数。函数接收的参数:日志对象。(用以翻译日志状态的动作函数目前可用;参见wp_transition_post_status())。

publish_page

发表页面或编辑某个状态为“published”的页面时,执行该动作函数。函数接收的参数:页面ID。(警告:该动作函数不能在WordPress 2.3以及更高版本中运行;但动作函数’transition_post_status’能够运行。更新信息:publish_page动作函数可在WordPress 2.6及之后版本中运行。)

publish_phone

通过电子邮件添加新日志后,执行该动作函数。函数接收的参数:日志ID。

publish_post

发表日志或编辑某个状态为“published”的日志时,执行该动作函数。函数接收的参数:日志ID。

save_post

新建或更新一篇日志/页面时,执行该动作函数。更新可以来自导入、日志/页面编辑框、xmlrpc或邮件日志。函数接收的参数:日志ID。

更新信息存入数据库后执行该动作函数。

注意:日志ID可能会参照日志的修改版而不是最新发布版。wp_is_post_revision可获取日志最新版的ID。

wp_insert_post

与save_post相同,更新信息存入数据库后执行该动作函数。

xmlrpc_public_post

通过XMLRPC请求发表日志,或通过XMLRPC编辑某个状态为“published”的日志时,执行该动作函数。函数接收的参数:日志ID。

评论、Ping以及引用通告相关动作钩子函数

comment_closed

尝试显示评论输入框而日志却设置为不允许评论时,执行该动作函数。函数接收的参数:日志ID。

comment_id_not_found

试图显示评论或评论输入框却未找到日志ID时,执行该动作函数。函数接收的参数:日志ID。

comment_flood_trigger

调用wp_die以阻止接收评论前,若检测到评论数量异常增多,执行该动作函数。函数接收的参数:上一次评论发表时间,当前评论发表时间。

comment_on_draft

日志为草稿状态却试图显示评论或评论输入框时,执行该动作函数。函数接收的参数:日志ID。

comment_post

评论刚被存入数据库时,执行此动作函数。函数接收的参数:评论ID,评论审核状态(”spam”,0(表示未审核),1(表示已审核))。

edit_comment

数据库中的评论被更新或编辑后,执行此动作函数。函数接收的参数:评论ID。

delete_comment

评论即将被删除前,执行此动作函数。函数接收的参数:评论ID。

pingback_post

日志新添加pingback后,执行此动作函数。函数接收的参数:评论ID。

pre_ping

执行pingback前,执行此动作函数。函数接收的参数:将要处理的日志链接数组,以及日志的“pung”设置。

trackback_post

日志新添加trackback后,执行此动作函数。函数接收的参数:评论ID。

wp_blacklist_check

执行该动作函数以判断评论是否应被禁止。函数接收的参数:评论者的名称、电子邮件、URL、评论内容、IP地址、用户代理(浏览器)。该函数可执行wp_die以拒绝评论,也可以修改某个参数以使评论中可包含用户在WordPress选项中设置的黑名单关键词。

wp_set_comment_status

评论状态发生改变时,执行此动作函数。函数接收的参数:评论ID,表明新状态的状态字符串(”delete”, “approve”, “spam”, “hold”)。

反向链接动作钩子函数

add_link

新反向链接首次加入数据库时,执行此动作函数。函数接收的参数:链接ID。

delete_link

删除反向链接时,执行此动作函数。函数接收的参数:链接ID。

edit_link

编辑反向链接时,执行此动作函数。函数接收的参数:链接ID。

Feed动作钩子函数

atom_entry

在atom订阅中,显示某篇博客日志信息后(但关闭该日志标签前),执行此动作函数。

atom_head

在atom订阅中,显示所订阅的某个博客信息后,还未显示该博客第一篇日志前,执行此动作函数。

atom_ns

为atom订阅的根XML元素执行此动作函数(以添加命名空间)。

commentrss2_item

在评论订阅中,显示某条评论信息后(但关闭该评论的标签前),执行此动作函数。函数接收的参数:评论ID,日志ID。

do_feed_(feed)

生成订阅信息时执行此动作函数,其中的订阅指的是订阅类型(rss2,atom,rdf等)。显示订阅信息所用优先级应低于10。函数接收的参数:true(评论订阅),或false(日志订阅)。

rdf_header

在rdf订阅中,显示所订阅的博客信息后,还未显示该博客第一篇日志前,执行此动作函数。

rdf_item

在RDF订阅中,显示某篇博客日志信息后(但关闭该日志标签前),执行此动作函数。

rdf_ns

为RDF订阅的根XML元素执行此动作函数(以添加命名空间)。

rss_head

在RSS订阅中,显示所订阅的博客信息后,还未显示该博客第一篇日志前,执行此动作函数。

rss_item

在RSS订阅中,显示某篇博客日志信息后(但关闭该日志标签前),执行此动作函数。

rss2_head

在RSS2订阅中,显示所订阅的博客信息后,还未显示该博客第一篇日志前,执行此动作函数。

rss2_item

在RSS2订阅中,显示某篇博客日志信息后(但关闭该日志标签前),执行此动作函数。

rss2_ns

为RSS2订阅的根XML元素执行此动作函数(以添加命名空间)。

模板相关动作钩子函数

comment_form

在标准WordPress主题中执行此动作函数以插入评论表单。函数接收的参数:日志ID。

do_robots

模板文件选择器认为这是一个来自robots.txt的请求时,执行该动作函数。

do_rebotstxt

在do_robots函数为robots.txt文件显示“Disallow”链接前,执行此动作函数。

get_footer

加载footer.php模板文件前,模板调用get_footer函数时执行此动作函数。

get_header

加载header.php模板文件前,模板调用get_header函数时执行此动作函数。

switch_theme

更改博客主题时执行此动作函数。函数接收的参数:新主题的名称。

template_redirect

决定用以显示所请求页面的模板文件前执行此动作函数,以便插件改写对模板文件的选择。示例(仅供参考,无实际用途):将所有请求重定向到当前主题目录下的all.php模板文件。

function all_on_one () {
	include(TEMPLATEPATH . '/all.php');
	exit;
}

add_action('template_redirect', 'all_on_one');

wp_footer

模板在博客页面的最下方附近调用wp_footer函数时执行该动作函数。

wp_head

模板调用wp_head函数时执行动作函数wp_head。wp_head通常被放在页面模板最上方<head>和 </head>之间。该动作函数不接受参数。

wp_meta

模板文件sidebar.php调用wp_meta函数以允许插件在侧边栏加入内容时,执行此动作函数。

wp_print_scripts

WordPress将已记录的JavaScript脚本输入页面的页眉部分前,执行此动作函数。

管理界面相关的动作钩子函数

activate_(插件文件名)

首次激活某插件时执行此动作函数。参见常用函数-register_activation_hook

activity_box_end

在控制板界面上的活动框末端执行该动作函数。

add_category_form_pre

添加分类的文本框尚未显示在管理菜单的界面上时,执行此动作函数。

admin_head

在控制板的HTML版块<head>中执行此动作函数。

admin_head-(page_hook)或admin_head-(plguin_page)

在插件所生成页面的控制板的HTML版块<head>中执行此动作函数。

admin_init

加载管理界面前执行该动作函数。参见wp-admin/admin.php,wp-admin/admin-post.php,以及wp-admin/admin-ajax.php。

admin_footer

在主标签中的控制板末端执行该动作函数。

admin_print_scripts

在HTML的信息头部分执行此动作函数,以使插件将JavaScript脚本添加到所有管理界面。

admin_print_styles

在HTML的信息头部分执行此动作函数,以使插件将CSS或样式表单添加到所有管理界面。

admin_print_scripts-(page_hook) 或 admin_print_scripts-(plugin_page)

执行此动作函数,以便将JavaScript脚本输入某个由插件生成的管理页面的HTML信息头部分。使用add_management_page(), add_options_page()等函数将插件菜单选项添加到管理菜单中时,返回(page_hook)。示例如下:

function myplugin_menu() {
  if ( function_exists('add_management_page') ) {
    $page = add_management_page( 'myplugin', 'myplugin', 9, __FILE__, 'myplugin_admin_page' );
    add_action( "admin_print_scripts-$page", 'myplugin_admin_head' );
  }

check_passwords

创建新用户账号时,执行该动作函数以验证两次输入的密码是否一致。函数接收的参数:登录名数组,首次输入的密码,第二次输入的密码。

dbx_page_advanced

在管理菜单的页面编辑界面上“advanced”版块的最下方执行此动作函数。

dbx_page_sidebar

在管理菜单的页面编辑界面工具条的最下方执行此动作函数。

dbx_post_advanced

在管理菜单的日志编辑界面上“advanced”版块的最下方执行此动作函数。

dbx_post_siderbar

在管理菜单的日志编辑界面工具条的最下方执行此动作函数。WordPress 2.5或更高版本中则执行?add_meta_box()函数。

deactivate_(插件文件名)

禁用插件时执行此动作函数。

delete_user

删除用户时执行此动作函数。函数接收的参数:用户ID。

edit_category_form

添加/编辑分类表显示在界面上后(HTML表标签结束前),执行此动作函数。

edit_category_form_pre

编辑分类表显示在管理菜单界面前,执行此动作函数。

edit_tag_form

添加/编辑标签表显示在界面上后(HTML表标签结束前),执行此动作函数。

edit_tag_form_pre

编辑标签表显示在管理菜单界面前,执行此动作函数。

edit_form_advanced

在管理菜单中日志编辑框的“advanced”版块前执行此动作函数。

edit_page_form

在管理菜单中页面编辑框的“advanced”版块前执行此动作函数。

edit_user_profile

在管理菜单中用户资料的最后部分执行此动作函数。

load_(page)

加载管理菜单页面时执行此动作函数。该动作函数不能直接添加——添加管理菜单过程参见定制插件管理菜单。如果希望直接添加该函数,add_options_page和类似函数返回的值能够给出动作函数名称。

login_form

在登录框的结尾部分前执行此动作函数。

login_head

在登录界面HTML页眉部分的结尾部分前执行此动作函数。

lost_password

在“通过电子邮件找回密码”显示在登录界面前执行此动作函数。

lostpassward_form

在通过电子邮件找回密码的表格尾部执行此动作函数,使插件能够提供更多字段。

lostpassward_post

用户要求通过电子邮件找回密码时执行此动作函数,使插件能够在找回密码前修改PHP $_POST变量。

manage_link_custom_column

反向链接管理界面中出现未知列名称时执行此动作函数。函数接收的参数:列名称,链接ID。参见插件API/常用过滤器函数中的过滤器函数manage_links_columns,该函数可添加自定义列。

manage_posts_custom_column

日志管理界面中出现未知列名称时执行此动作函数。函数接收的参数:列名称,日志ID。参见插件API/常用过滤器函数中的过滤器函数manage_posts_columns,该函数可添加自定义列。(具体用法和示例参见?Scompt’s tutorialHANLEI'BLOG » WordPress常用钩子(ACTION)