常用函数-wp_count_posts()

说明

该函数在WordPress 2.5版本中被引入，函数输出每篇文章状态类型的数字。也可以使用wp_count_posts()作为带有第二个参数的template_tag使用，这样会将私密文章状态也包含进去。默认情况下以及用户未登录和一般页面访问者访问时，不显示私密状态文章计数。

函数返回对象的属性为文章状态。需要私密文章状态值时可利用isset() PHP函数来检验其属性。

用法

<?php wp_count_posts(‘type’); ?> 

<?php wp_count_posts(‘type’, ‘readable’); ?>

示例

缺省用法

缺省用法返回已发表文章的计数。这是一个对象，可以在内容中用var_dump()来调试输出结果。

<?php  
$count_posts = wp_count_posts();  
?>

获取发表状态文章的计数

要获取已发表文章的状态类型，应先调用wp_count_posts()函数然后确查看“发表”属性。

<?php  
$count_posts = wp_count_posts();    

$published_posts = $count_posts->publish;  
?>

若使用PHP5且只想获取一个文章状态，可以用下面更为便捷的方法。这个代码在PHP4中无法运行，因此如果希望保持后台的兼容性，应该选择上面的代码。

<?php  
$published_posts = wp_count_posts()->publish;  
?>

草稿计数

计算草稿数量方法与获取发表状态计数方法一致。

<?php  
$count_posts = wp_count_posts();    

$draft_posts = $count_posts->draft;  
?>

页面计数

计算页面类型数量的方法与计算文章一样，也需要利用第一个参数。查找某一状态下的页面数量与查找该状态下的日志方法相同。

<?php  
$count_pages = wp_count_posts('page');  
?>

其他用法

wp_count_posts() 可查找日志状态下任何日志类型的数量，包括附件以及将要添加的任何日志类型，也可以通过插件或WordPress部分核心团队达到这一效果。

参数

type

（字符）wp_posts中行的类型，用于核查哪种类型与post_type对应。默认post。

perm

（字符）该参数可将私密文章状态算入文章状态中，使用’readable’并要求用户登录。默认为empty string。

分类：中文手册