当前浏览:首页 / WordPress函数 / category_description()

category_description( int $category )

检索类别描述

cat

category 分类more...

description 描述


参数

$category

(int)(可选) 类别ID。默认为当前类别ID。


返回

(string) 类别描述(如果可用)。


说明

如果在archive.php模板中使用,请将此函数放置在is_category()条件语句中
否则,此功能将停止处理“每月”和其他存档的页面。



源码

查看源码 官方文档


更新日志

版本描述
1.0.0开始引入

使用示例

  • 示例1

    默认用法

    通过回显标记的返回值,显示给定id的类别的描述。如果类别页面上没有给定和使用类别,则返回当前类别的描述。

     <div><?php echo category_description(3); ?></div> 
    

    结果:

    WordPress是我最喜欢的博客工具,我在这里分享使用WordPress的技巧。

    注意:如果没有类别描述,则函数返回br标记。

  • 示例2

    使用类别Slug

    使用类别slug显示类别的描述。

    <?php echo category_description( get_category_by_slug( 'category-slug' )->term_id ); ?> 
    
  • 示例3

    具有类别标题

     <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.