管理界面的相关动作函数

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

activate_(插件文件名)

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

activity_box_end

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

add_category_form_pre

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

admin_head

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

admin_head-(page_hook)或admin_head-(plguin_page)

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

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 tutorial ）。

manage_pages_custom_column

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

password_reset

用户将旧密码更改为新密码前执行此动作函数。

personal_options_update

用户在控制板中更新设置时执行此动作函数。

plugins_loaded

所有插件加载完毕后执行此动作函数。

profile_personal_options

在用户资料编辑iemian的“关于您自己”版块结尾处执行此动作函数。

profile_update

更新用户资料时执行此动作函数。函数结合搜的参数：用户ID。

register_form

在新用户注册表结尾部分前执行此动作函数。

register_post

处理新用户注册请求前执行此动作函数。

restrict_manage_posts

需要编辑的日志列表显示在管理菜单界面前，执行此动作函数。

retrieve_password

检索用户密码以发送密码提醒邮件时执行此动作函数。函数接收的参数：登录名。

set_current_user

默认函数wp_set_current_user更改用户后，执行此动作函数。注意：wp_set_current_user是一个“插入式”函数，即插件可以改写该函数；参见插件API。

show_user_profile

在用户资料编辑界面结尾部分执行此动作函数。

simple_edit_form

在控制板的“简单”日志编辑框的结尾部分执行此动作函数（默认情况下，简单编辑框仅用于书签工具——没有“高级”选项）。

updateoption(option_name)

update_option函数更新WordPress选项后，执行该动作函数。函数接收的参数：原选项值，新选项值。用户需要为希望更新的选项添加一个动作函数，例如更新“foo”时用函数update_option_foo来呼应。

uploadfiles(tab)

执行该动作函数以显示上传文件管理界面上的某个页面；“tab”是自定义动作函数表的名称。可以用过滤器函数wp_upload_tabs来定义自定义表（参见插件API/常用过滤器函数）。

user_register

首次创建用户资料时执行此动作函数。函数接收的参数：用户ID。

wpajax(action)

在管理菜单中执行此动作函数以运行未知类型的AJAX。

wp_authenticate

用户登录时，执行该动作函数以验证用户身份。函数接收的参数：用户名和密码数组。

wp_login

用户登录时执行此动作函数。

wp_logout

用户退出登录时执行此动作函数。