WordPress分类目录函数wp_list_categories用法详解.docx

WordPress分类目录函数wp_list_categories用法详解wp_list_categories函数的作用是调用wordpress博客分类。它丰富而实用的参数，可让你轻松获得想要的效果。操作简单，功能强大，掌握这个函数，对wordpress主题制作有很大帮助，是wordpress主题制作必须熟知的函数之一。wp_list_categories函数存放位置在wp-includes文件夹的category-template.php文件。可以在第452行找到，420行至450行是函数使用说明。此外，还可以参考官方wp_list_categories链接，里面介绍的很详尽。作用：按条件获取分类目录并按参数格式化用法?phpwp_list_categories($args);$args=array(show_option_all=,//是否列出分类链接orderby=name,//按名称排列order=ASC,//升、降序style=list,//是否用列表（ulli）show_count=0,//是否显示文章数量hide_empty=1,//是否显示无日志分类use_desc_for_title=1,//是否显示分类描述child_of=0,//是否限制子分类feed=,//是否显示rssfeed_type=,//rss类型feed_image=,//是否显示rss图片exclude=,//排除分类的ID，多个用,（英文逗号）分隔exclude_tree=,//排除分类树，即父分类及其下的子分类include=,//包括的分类hierarchical=true,//是否将子、父分类分级title_li= __(Categories),//列表标题的名称show_option_none= __(No categories),//无分类时显示的标题number=null,//显示分类的数量echo=1,//是否显示，显示或者返回字符串depth=0,//层级限制current_category=0,//添加一个没有的分类pad_counts=0,//这个我也不明白taxonomy=category,//使用的分类法walker=null//用于显示的类（很复杂的概念）?使用实例显示包括ID为3,5,9,16的分类链接，且按名称排列顺序ul?phpwp_list_categories(orderby=nameinclude=3,5,9,16);?/ul显示Poetry为标题的包括ID为5,9,23的分类列表ul?phpwp_list_categories(include=5,9,23title_li=h2. __(Poetry)./h2);?/ul当然你也可以像如下这样书写参数，将参数整合为数组。?php$taxonomy=genre;$orderby=name;$show_count=0;// 1 for yes, 0 for no$pad_counts=0;// 1 for yes, 0 for no$hierarchical=1;// 1 for yes, 0 for no$title=;?$args=array(taxonomy=$taxonomy,orderby=$orderby,show_count=$show_count,pad_counts=$pad_counts,hierarchical=$hierarchical,title_li=$title);??ul?phpwp_list_categories($args);?/ultaxonomy分类法，是相对于标签（tag）的概念。主题中最常用的实例（获取所有分类目录，并按名字排序，获取深度为3，标题格式化为无）：这个实例常用于下拉菜单中，需要相关css和js支持，如果没有css，将会出现格式问题，如所有子目录堆叠而不是下拉，但是功能没问题。ul id=”nav”lia href=”?php echo get_settings(‘home’); ?/” title=”?phpbloginfo(‘description’); ?”Home/a/li?phpwp_list_categories(‘sort_column=nametitle_li=depth=3′); ?/ul按照分类名排序，并只显示 ID 为1、2、3和4的分类： ?phpwp_list_categories(‘orderby=nameinclude=1,2,3,4′); ?按照分类名排序，并显示每个分类的日志数，但不显示 ID 为10的分类 ?phpwp_list_categories(‘orderby=nameshow_count=1exclude=10′); ?显示或隐藏列表标题title_li