管理界面的相关动作函数 · wordpress二次开发快速入门

## **管理界面相关的动作钩子函数** **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 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** 在控制板的“简单”日志编辑框的结尾部分执行此动作函数（默认情况下，简单编辑框仅用于书签工具——没有“高级”选项）。 **update_option_(option_name)** update_option函数更新WordPress选项后，执行该动作函数。函数接收的参数：原选项值，新选项值。用户需要为希望更新的选项添加一个动作函数，例如更新“foo”时用函数update_option_foo来呼应。 **upload_files_(tab)** 执行该动作函数以显示上传文件管理界面上的某个页面；“tab”是自定义动作函数表的名称。可以用过滤器函数wp_upload_tabs来定义自定义表（参见插件API/常用过滤器函数）。 **user_register** 首次创建用户资料时执行此动作函数。函数接收的参数：用户ID。 **wp_ajax_(action)** 在管理菜单中执行此动作函数以运行未知类型的AJAX。 **wp_authenticate** 用户登录时，执行该动作函数以验证用户身份。函数接收的参数：用户名和密码数组。 **wp_login** 用户登录时执行此动作函数。 **wp_logout** 用户退出登录时执行此动作函数。