the_post

💡 云策文档标注

概述

the_post 是一个 WordPress 动作钩子，在文章数据设置完成后触发，允许开发者修改文章对象。文章对象和查询对象通过引用传递，无需返回值。

function my_the_post_action( $post_object ) {
    // modify post object here
}
add_action( 'the_post', 'my_the_post_action' );

📄 原文内容

Fires once the post data has been set up.

The ‘the_post’ action hook allows developers to modify the post object immediately after being queried and setup.

The post object is passed to this hook by reference so there is no need to return a value.

function my_the_post_action( $post_object ) {
// modify post object here
}
add_action( 'the_post', 'my_the_post_action' );

do_action_ref_array( 'the_post', array( &$post, &$this ) );

Used by	Description
WP_Query::setup_postdata()`wp-includes/class-wp-query.php`	Sets up global post data.

Version	Description
4.1.0	Introduced `$query` parameter.
2.8.0	Introduced.