做主题的过程中遇到了categories的一些参数设置问题,在中文Wordpress范围内搜索无果后,最终在Wordpress官网中找到了相应的内容,这里我就简要的把重点记录在此,算是对Wordpress中文化的一点补充吧…在Wordpress中,一般wp_list_categories来显示所有分类的链接列表,它有两种表示方法:list_cats()(deprecated)和wp_list_cats()(deprecated),下面是使用方法:<?phpwp_list_categories(‘参数‘);?>默认参数设置为:$defaults=array(‘show_option_all‘=>”,无链接的分类‘orderby‘=>‘name‘,按照分类名排序‘order‘=>‘ASC‘,升序‘show_last_update‘=>0,不显示分类中日志的最新时间戳‘style‘=>‘list‘,用列表显示分类‘show_count‘=>0,0,不显示分类下的日志数‘hide_empty‘=>1,DisplaysonlyCategorieswithposts‘use_desc_for_title‘=>1,显示分类链接中title标签的分类描述‘child_of‘=>0,子分类无限制‘feed‘=>”,无feed‘feed_image‘=>”,无feed图片显示‘exclude‘=>”,不在分类列表中显示该分类‘hierarchical‘=>true,分层显示父/子分类‘title_li‘=>__(‘Categories‘),在列表前作为标题显示分类‘echo‘=>1显示分类);用法举例:1、按照字母排序,并只显示ID为16、3、9和5的分类:
- <?phpwp_list_categories(‘orderby=name&include=3,5,9,16‘);?>
2、按照字母排序,显示每个分类的日志数,但不显示ID为10的分类
- <?phpwp_list_categories(‘orderby=name&show_count=1&exclude=10‘);?>
3、显示或隐藏列表头,在分类函数wp_list_categories中,title_li这个参数用于设置或者隐藏分类列表的头或者标题。它的默认值是:‘(__(’Categories’)’,这也就是为什么我们在不另设置分类列表标题的时候,它会显示“Categories”的原因。如果你在这里不设置任何参数,那么它将什么都不会显示。下面的例子是排除ID为4和7并且隐藏列表头的分类列表:
- <?phpwp_list_categories(‘exclude=4,7&title_li=‘);?>
接下来的例子是仅仅只显示ID为5、9和23,并且列表头显示为“诗歌”的分类列表:
- <?phpwp_list_categories(‘include=5,9,23&title_li=<h2>‘.__(‘诗歌‘).‘‘);?>
4、仅显示某个分类下的子分类,下面的示例代码生成了ID为8的父分类下的子分类根据其ID进行排序的链接列表(读起来真绕口-__-|||),它会显示每个分类下的文章数,并且隐藏链接的title标签中的分类描述,注意:如果父分类下没有任何文章,那么父分类将不会显示
- <?phpwp_list_categories(‘orderby=id&show_count=1&use_desc_for_title=0&child_of=8‘);?>
这个函数里设置的参数比较多,这里我稍作说明:我们可以看到不同参数之间使用了“&”这个“与符号”来进行区分连接,orderby=id按照ID排序,show_count=1显示分类下的文章数,use_desc_for_title=0隐藏分类描述,child_of=8指定ID为8的子分类。5、显示带有RSSFeed链接的分类列表,下面代码根据分类名对分类列表排序,并显示每个分类下的文章数和RSS的Feed链接。
- <?phpwp_list_categories(‘orderby=name&show_count=1&feed=RSS‘);?>
还可以使用RSS图标代替RSS链接
- <?phpwp_list_categories(‘orderby=name&show_count=1&feed_image=/images/rss.gif‘);?>
6、标记和样式化分类列表,从上面的例子中可以看到,我们将分类列表函数:wp_list_categories()套用在ul和li标签里,除此外我们还可以对其进行其它的样式化,个人认为这些工作直接在CSS里设置即可,原文档中的方法实际作用并不是很大,这里我就不多做介绍,有兴趣的朋友可以参考这里介绍这个函数中所用到的各种参数设置。orderby字符串型参数,分类的排序方式:orderby=ID(按照分类默认的ID排序)orderby=name(按照分类名排序,默认方式)orderby=count(按照分类下的文章数排序)order字符串型,分类按照升降序排序:order=ASC(默认的升序排列)order=DESC(降序排列)show_last_updated布尔型,用于是否显示最近更新的时间戳:show_last_updated=1(显示)show_last_updated=0(默认,不显示)style字符串型,控制分类的输出方式:style=list(按照列表的样式输出)style=none(无样式输出)show_count布尔型,是否显示每个分类下的文章数:show_count=0(默认不显示)show_count=1(显示)hide_empty布尔型,是否不显示没有文章的分类:hide_empty=1(默认,是的,不显示)hide_empty=0(显示)use_desc_for_title布尔型,是否将分类的描述插入其链接的title标签中:use_desc_for_title=1(默认,插入描述)use_desc_for_title=0(不插入)child_of整型,显示指定父分类ID下的子分类,无默认值feed字符串型,显示每个分类的RSS链接,并可以设置链接的文字,默认不显示feed_image字符串型,为RSS设置一个链接的图标,默认不显示exclude字符串型,根据分类的ID,按照升序将指定分类从分类列表中排除include字符串型,根据分类的ID,按照升序,将指定分类显示出来hierarchical布尔型,是否分层缩进显示子分类hierarchical=1(默认显示)hierarchical=0(不显示)hierarchical字符串型,设置分类的标题名和外部列表项目的样式,默认显示“_Categories”,如果没有设置这个值则不显示number整型,设置显示分类的数量,默认没有限制。echo(含糊不清…)布尔型,用于显示结果或保持为一个变量,默认显示原有分类。echo=1(默认显示)echo=0(不显示)depth(用处不大)整型,用于控制最多显示多少层的子分类。depth=0(默认按照分层缩进的方式显示全部分类和子分类)depth=-1(不按照缩进的方式显示全部分类)depth=1(只显示一层子分类)depth=n(显示n层子分类)show_option_all很少用,也不是很理解-__-|||