WordPress发布文章的动作钩子有哪些?

更新于 2020-10-16 16:38:07首发于 2017-09-07 09:46:45555

WordPress 发布文章相关的动作钩子：

publish_post：参数一个（$post_ID），点击发布文章时就会被触发；
save_post：参数一个（$post_ID），发布或更新文章时就会被触发；
edit_post：参数两个（$post_ID, $post），只要编辑已经存在的文章就会被触发；
publish_future_post：参数一个（$post_ID），到定时发布文章设定的时间点就会被触发，如果设定的时间早于发布时间，不会被触发；
transition_post_status：参数三个（$new_status, $old_status, $post），实现功能比较强大，可以根据文章发布状态的变化实现一些功能。
{$old_status}_to_{$new_status}：参数一个（$post），比如 draft_to_publish 是通常的文章发布事件
future_to_publish 则可以用来处理定时文章发布事件。
post_updated：参数三个（$post_ID, $post_after, $post_before），已存在文章更新了就会被触发。

其中 $post 为文章对象；$post_ID 为文章 ID；$post_status 为文章对象的发布状态（包括 new，publish，future，draft，pending，private，trash，auto-draft 等）；$post_type 为文章对象的发布类型（包括 post，page，attachment，revision 等）。

对比上面的函数说明可以发现，post_updated 事件是最强大的，可以获取到文章修改前后的所有内容，参数较多；其次是 transition_post_status 事件，功能也比较强；接着是 {$old_status}_to_{$new_status} 事件，针对性较强，可以对特定情况进行事件抓取；而 publish_post、save_post、edit_post 和 publish_future_post 这四个事件就相对比较简单，可以视情况而用。

WordPress 中有关发布、编辑文章的代码主要在文件 /wp-includes/post.php 里，主要函数有 wp_update_post、wp_insert_post 等，有兴趣可以去细细看下源码或者官方网站上的相关文档，一定会收获不少的。

以上内容整理自@蔓草札记