管理界面的相關動作函數 · 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** 用戶退出登錄時執行此動作函數。