WordPress教程
WordPress 主题开发 setup_postdata 函数用法详解
PetitQ
收藏
setup_postdate 函数可以设置全局$post 变量，是一个比较神奇的函数，能将对象变量声明到全局的$post 变量中，这样我们就可以像在主循环中为所欲为的使用模板标签了。使得自定义查询文章语句后也可以使用 the_permalink()、the_title()等来直接获取文章信息，具体使用方法如：
<?phpglobal $wpdb, $post; //注意这里要申明$post
$str = "SELECT $wpdb->posts.* FROM $wpdb->posts WHERE post_type = 'post' AND post_status = 'publish'";
$result = $wpdb->get_results( $str );
if ( $result ) {
foreach ( $result as $post ): //如果这里获取的是$post_id，可以$post = get_post($post_id);
setup_postdata( $post );
?><li><a href="<?php the_permalink()?>"><?php the_title();?></a></li>
<?phpendforeach;
}?>
也想出现在这里？联系我们吧
说这么多都只是空谈，setup_postdata 这个函数平时我们很少用到，以至于目前为止我还没找到一个中文的介绍文章。只是在其他文章中能找到只字片语，但因为确实很实用，所以就单独行文，备忘之。
函数描述
我的解释是：将我们自定义查询的文章对象声明到全局$post 变量中，以便我们使用模板标签。这里的查询变量我们需要从 get_post()或是 get_posts 查询获得，当然只要是标准的文章对象，你都可以用 setup_postdata 来声明到全局去，不仅限于这两个函数。
常规使用
<?php//获取全局变量，global $post;
setup_postdata( $post );
?>
官方的例子太简单就这么坑爹，来一个复杂点的：
<ul>
<?php//定义查询条件$args = array( 'numberposts' => 5, 'offset'=> 1, 'category' => 1 );
//获得查询文章（多篇）$myposts = get_posts( $args );
//遍历文章数组foreach( $myposts as $post ) : setup_postdata($post); ?>
setup_postdata( $post );
<li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?phpendforeach;
//重置 算是setup_postdata( )的反函数wp_reset_postdata();
?></ul>
这样是不是就清晰多了？再来一个例子吧，以下的例子源自 我目前用的主题的边栏的随机/最新 文章显示模块:
function dw_side_post($i=3){
global $post;
$mylist = '';
$mytitle = is_single() ? '最新文章':'随机推荐';
$posts = is_single() ? get_posts("numberposts={$i}&orderby=post_date"):get_posts("numberposts={$i}&orderby=rand");
foreach($posts as $post) {
setup_postdata($post);
$mylist .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
}$output = '<div class="widget"><div class="title">'.$mytitle.'</div><ul>'.$mylist.'</ul></div>';
echo $output;
}
PS:使用本函数的时候，请注意不要在主循环中使用，不然会达不到你预期的效果，怎样退出循环，这个你可以在调用该函数不成功的时候去搜搜。
专业提供WordPress主题安装、深度汉化、加速优化等各类网站建设服务，详询在线客服！
也想出现在这里？联系我们吧
