参数
- $category
-
(int)(可选) 类别ID。默认为当前类别ID。
返回
(string) 类别描述(如果可用)。
说明
如果在archive.php模板中使用,请将此函数放置在is_category()条件语句中
否则,此功能将停止处理“每月”和其他存档的页面。
源码
更新日志
版本 | 描述 |
---|---|
1.0.0 | 开始引入 |
使用示例
默认用法
通过回显标记的返回值,显示给定id的类别的描述。如果类别页面上没有给定和使用类别,则返回当前类别的描述。
<div><?php echo category_description(3); ?></div>
结果:
WordPress是我最喜欢的博客工具,我在这里分享使用WordPress的技巧。
注意:如果没有类别描述,则函数返回br标记。
使用类别Slug
使用类别slug显示类别的描述。
<?php echo category_description( get_category_by_slug( 'category-slug' )->term_id ); ?>
具有类别标题
<div> <strong><?php single_cat_title( __( 'Currently browsing', 'textdomain' ) ); ?></strong>: <?php echo category_description(); ?> </div>
结果:
<strong>Currently browsing WordPress</strong>: WordPress is a favorite blogging tool of mine and I share tips and tricks for using WordPress here.