wordpress常用的钩子解析.doc

? ? ? ? wordpress 常用的钩子解析?? 本文列出了WordPress 2.1及以上版本中可用于插件开发的动作钩子（hook)。?想了解过滤器钩子和动作钩子的定义和作用？请看插件API。?想了解插件的基本编写过程？请看插件开发。?想查看过滤器钩子函数列表？请看插件API之常用过滤器。?想查找WordPress 2.1之前版本的过滤器钩子和动作钩子？请看Plugin API/Hooks 2.0.x。注意：为本文添加词条或做其它改动时，请参照当前格式。添加时请说明过滤器函数适用的数据类型，如果过滤器函数接收多个参数，请在参数列表中说明。在典型请求中运行的动作钩子在WordPress 2.7中，当已登录用户在默认主题打开网站主页时，WordPress会运行以下动作钩子函数：1.plugins_loaded2.sanitize_comment_cookies3.setup_theme4.auth_cookie_malformed5.auth_cookie_valid6.set_current_user7.init8.widgets_init9.parse_request10.send_headers11.pre_get_posts12.posts_selection13.wp14.template_redirect15.get_header16.wp_head17.wp_print_styles18.wp_print_scripts19.loop_start20.loop_end21.get_sidebar22.wp_meta23.get_footer24.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相同，更新信息存入数据库后执行该动作函数。xml