分类列表(wp_list_categories())函数用法详解

来源:互联网 发布:淘宝拍卖商业房 税费 编辑:程序博客网 时间:2024/06/05 17:57
正如标题所说,Wordpress是用wp_list_categories这个函数来显示分类的,其用法是:< ?php wp_list_categories('arguments'); ?>。如:优搜网

arguments即参数,默认参数设置为:

$defaults = array('show_option_all' => '', 不列出分类链接'orderby' => 'name', 按照分类名排序'order' => 'ASC', 升序排列'show_last_update' => 0, 不显示分类中日志的最新时间戳'style' => 'list',列表显示分类'show_count' => 0, 不显示分类日志数量'hide_empty' => 1, 不显示没有日志的分类'use_desc_for_title' => 1, 显示分类描述'child_of' => 0, 不限制子分类'feed' => '', 不显示feed'feed_image' => '', 不显示feed图片'exclude' => '', 不显示该分类'hierarchical' => true, 分层次显示父/子分类'title_li' => __('Categories'), 用“Categories”为当前分类列表的标题'echo' => 1, 显示(echos) 分类'depth' => 0 不限制列表深度);

用法举例:

  1. 按照分类名排序,并只显示 ID 为1、2、3和4的分类:
      < ?php
      wp_list_categories('orderby=name&include=1,2,3,4'); ?>
  2. 按照分类名排序,并显示每个分类的日志数,但不显示 ID 为10的分类
      < ?php
      wp_list_categories('orderby=name&show_count=1&exclude=10'); ?>
  3. 显示或隐藏列表标题

    title_li 这个参数用于显示或者隐藏分类列表的标题,它的默认值为'(__('Categories')',即显示分类列表的标题,如果不设置或设置为空,它将什么也不显示。下面的例子将不显示id为4和7的分类,并不显示list_categories列表的标题:

      < ?php
      wp_list_categories('exclude=4,7&title_li='); ?>


    接下来的例子是仅仅只显示 ID为5、9和23的分类,并且列表标题显示为“Poetry”表:

      < ?php
      wp_list_categories('include=5,9,23&title_li=' . __('Poetry') . '' ); ?>
  4. 仅显示某个分类下的子分类

    下面的示例代码生成了 ID 为8的父分类下的子分类根据其 ID 进行排序的链接列表,它会显示每个分类下的文章数,并且隐藏链接的 title 标签中的分类描述,注意:如果父分类下没有任何文章,那么父分类将不会显示(读起来貌似很难理解,不过照着做就理解了)

      < ?php wp_list_categories('orderby=id&show_count=1
      &use_desc_for_title=0&child_of=8'); ?>
  5. 显示带有 RSS Feed 链接的分类列表

    面代码根据分类名对分类列表排序,并显示每个分类下的文章数和 RSS 的 Feed 链接:

      < ?php
      wp_list_categories('orderby=name&show_count=1&feed=RSS'); ?>


    还可以使用 RSS 图标代替 RSS 链接

      < ?php
      wp_list_categories('orderby=name&show_count=1
      &feed_image=/images/rss.gif'); ?>

原创粉丝点击