当前位置:首页 > CMS教程 > WordPress > 列表

wordpress常用函数wp_list_categories()

发布:smiling 来源: PHP粉丝网  添加日期:2014-03-23 22:30:54 浏览: 评论:0 

wp_list_categories函数的作用它主要用来获取博客文章的分类信息并对获取的信息进行相关处理,下面我们就来一起看看此函数的一些例子.

wp_list_categories()函数是wordpress主题经常用到的一个函数,它主要用来获取博客文章的分类信息,并且通过对函数参数的适当设置,就可以将分类的相关信息显示出来,wp_list_categories()函数的参数和wp_get_archives()函数有点类似,在设置参数时都需要使用&连接,并且放在单引号 (’)中以字符串形式传递,如下例:

wp_list_categories(‘orderby=name&order=ASC& show_count=1&use_desc_for_title=1&feed=订阅&exclude=2,5& number=10′)。

上例中函数各参数的意义如下:

orderby=name:表示按分类名称的字母先后顺序显示分类信息,也可以将name换为ID等;

order=ASC:表示按照分类名称的字母的升序显示分类信息,将ASC改为DESC表示按降序;

show_count=1:在分类名称后显示分类中文章的数量有多少;

use_desc_for_title=1:使用该分类的描述信息为每个分类名称超链接添加一个title属性;

feed=订阅:在每个分类信息旁边添加一个名为“订阅”的超链接,提供该分类的RSS订阅;

exlude=2,5:在显示的分类中去除ID为2和5的分类;也可以用include=2,5表示只显示ID为2和5的分类;

number=10:表示只显示最先的10个分类。

wp_list_categories()函数一般用于侧边栏分类目录归档,这在一般的wordpress博客中我们可以常见到。也可以通过wp_list_categories()函数来制作网站头部导航栏菜单,这在大多数的CMS主题中我们就可以常常看到。

点评:用分类做为导航拦及wp_list_categories的用法,下面是具体的示例,感兴趣的朋友可以参考下哈

1.用分类做为导航拦,代码如下:

<?php wp_list_categories('depth=2&title_li=0&orderby=name&show_count=0');?> 

把这句加到header.php里的nav中,我的页面如下:

  1. <nav>  
  2. <div id="navDiv">  
  3. <ul id="nav">  
  4. <li<?php if(is_home()) echo ' class="current_page_item"' ?>><a href="<?php bloginfo('url'); ?>/">首页</a></li>  
  5. <?php //wp_list_pages('title_li=&depth=1&include='); ?>  
  6. <?php wp_list_categories('depth=2&title_li=0&orderby=name&show_count=0');?>  
  7. </ul>  
  8. </div>  
  9. </nav> 

原本是以page做为导航的,现在注掉,换用分类category来做导航.

2.下面说说wp_list_categories的用法

wp_list_categories 用来显示所有分类的链接列表,两种表示方法:list_cats()(deprecated) 和 wp_list_cats()(deprecated).代码如下:

<?php wp_list_categories('参数'); ?> 

默认参数设置为:

  1. <?php $args = array(  
  2. 'show_option_all' => '',//不列出分类链接  
  3. 'orderby' => 'name',//按照分类名排序  
  4. 'order' => 'ASC',//升序排列  
  5. 'style' => 'list',//列表显示分类  
  6. 'show_count' => 0,//不显示分类日志数量  
  7. 'hide_empty' => 1,//不显示没有日志的分类  
  8. 'use_desc_for_title' => 1,//显示分类描述  
  9. 'child_of' => 0,//不限制子分类  
  10. 'feed' => '',//不显示feed  
  11. 'feed_type' => '',//不显示feed类别  
  12. 'feed_image' => '',//不显示feed图片  
  13. 'exclude' => '',//不显示该分类  
  14. 'exclude_tree' => '',//不显示该分类树  
  15. 'include' => '',  
  16. 'hierarchical' => 1,//分层次显示父/子分类  
  17. 'title_li' => __( 'Categories' ),//用“Categories”为当前分类列表的标题  
  18. 'show_option_none' => __('No categories'),  
  19. 'number' => null,  
  20. 'echo' => 1,//显示(echos) 分类  
  21. 'depth' => 0,//不限制列表深度  
  22. 'current_category' => 0,  
  23. 'pad_counts' => 0,  
  24. 'taxonomy' => 'category',  
  25. 'walker' => null  
  26. ); ?> 

Tags: wordpress 函数 wp_list_categories()

分享到: