wp_list_categories( string|array $args = 39;' );
这个函数有一个参数,它的参数既可以是字符串类型的数据,也可以是一个数组类型的数据,这点跟wp_list_pages()函数类似。
二、wp_list_categories()函数的参数详解。$args = array('show_option_all' => '',//是否列出分类链接;'orderby' => 'name',//按名称排列;'order' => 'ASC',//分类目录的排序。升、降序;'style' => 'list',//是否用列表(ul>li)标签;'show_count' => 0,//是否显示文章数量;'hide_empty' => 1,//是否显示没有文章的分类;'use_desc_for_title' => 1,//是否显示分类描述;'child_of' => 0,//是否限定子分类 ;'exclude' => '',//打消分类的ID,多个用',(英文逗号)'分隔;'exclude_tree' => '',//打消分类树,即父分类及其下的子分类;'include' => '',//包括哪些分类的ID;'title_li' => 'Categories',//导航菜单的列表标题名称;'show_option_none' =>'No categories',//网站没有分类时显示的标题;'number' => null,//显示分类的数量;'echo' => 1,//是否打印到前台页面显示,1显示,0不显示而是返回字符串;'hierarchical' => true,//是否将子、父分类分级;'depth' => 0,//层级限定;'current_category' => 0,//指定分类ID,在前台页面链接添加current-cat的CSS类,方便修正样式;'pad_counts' => 0,//打算包括子分类的链接或文章数;'taxonomy' => 'category',//利用的文章分类类型;'walker' => null//天生列表 Walker 类;);
以上,我们列举了wp_list_categories()函数的紧张的参数,以及它们都代表什么。实在,在我们的实际利用中,并不是每一个参数都会用到,一样平常情形下,我们只会利用个中的某几个。我们会不才面的案例中详细讲授。
三、wp_list_categories()案例。案例1:分类目录导航列表按层级来排列。
$menu = array( 'depth' =>0, 'title_li'=>'', 'echo'=>1,);wp_list_categories($menu);
如下图,子分类会按层级的关系,缩进去2格;并且没有显示列表的标题。
案例2:只显示顶级分类,不显示子分类,并显示列表标题。
$menu = array( 'depth' =>1, 'title_li'=>'这是分类列表的标题', 'echo'=>1,);wp_list_categories($menu);
这里,我们把depth参数的值设成1,就表示只显示一级分类目录,子分类就不会显示;如果设成2,就会显示2级分类,子分类就会显示;如果设成3,就会显示3级分类,子分类和子分类的子分类都会显示出来;以此类推。设成0,表示所有分类都显示,并且按层级显示。其余,我们这里也添加了分类菜单的列表标题,这样,如果在侧边伴,这个标题还是非常管用的;如果是顶部导航菜单,这个标题还是省略比较好。效果如下图:
案例3:打消某些分类。也便是不让某些分类显示出来。代码如下:
$menu = array( 'depth' =>1, 'title_li'=>'', 'echo'=>1, 'exclude' => '52,81,103',);wp_list_categories($menu);
这里,我们设置了打消3个分类,它们的ID号分别是:52(亲子),81(养生),103(家居)。这样,我们在wordpress网站的前台页面的导航菜单中就看不到这几个分类目录。如下图,可以比拟一下上图:
好了,关于wordpress网站分类目录导航菜单函数wp_list_categories(),这里我们就只举这几个案例,在实际运用中,我们可以根据不同的需求,来设置不同的参数,要做到灵巧多变。这些参数还是很好理解的,只需多练习,就可轻松节制。