wp_list_categories函数用法详解

本以为写完新手教程之后,可以不写新手应用方面的文章了的,可今天又有朋友在群里问如何显示每个分类下文章数量这个基础性问题,看来Wordpress中文化还有很长的一段路要走,我们任重而道远啊!好,解决你的问题先:
正如标题所说,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. 显示或隐藏列表标题
  4. 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’) . ” ); ?>

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

      < ?php wp_list_categories('orderby=id&show_count=1 &use_desc_for_title=0&child_of=8'); ?>

  7. 显示带有 RSS Feed 链接的分类列表
  8. 面代码根据分类名对分类列表排序,并显示每个分类下的文章数和 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'); ?>

好了,问题基本解决了,有什么不懂请提出来!
翻译这篇文章好累啊,老臭老长的,很多人还叫嚣看不懂,不能再简单啦!老规矩,贴下原文地址。
谁家有多的月饼,掷过来犒劳犒劳先?!嘿嘿,笑话了,今天是中秋节,本鱼代表Wopus团队全体成员在这里真诚的祝福大家“千好万好事事好、月圆情圆人团圆”!

Comments

24 responses to “wp_list_categories函数用法详解”

  1. aunsen Avatar

    鱼版每次发这么深奥的东西,看的我好郁闷的说…

  2. 显示分类文章数量 Avatar
    显示分类文章数量

    你好,请问具体放在哪个文件的哪个页面的哪个位置?越具体越好,谢谢。

    1. 呵呵 Avatar

      请问有QQ群交流吗

  3. 辐射鱼 Avatar

    俺不是版主,月饼呢?

  4. 辐射鱼 Avatar

    放在你想放的任何位置,不过博客一般放侧边栏,Wopus中文平台都把分类放导航了

  5. ThinkAgain Avatar

    写得很详细。 🙂
    祝wopus团队的各位中秋快乐。也祝wopus越来越壮大。

  6. 酋 长 Avatar

    @ ThinkAgain 谢谢,WordPress在国内的发展,还是需要你这种大牛牛的支持。。中秋快乐~~

  7. 辐射鱼 Avatar

    ThinkAgain你的站现在好慢

  8. Toby Avatar

    辐射鱼,去给他优化下~嘿嘿!

  9. 辐射鱼 Avatar

    @Toby:别个思维很严谨,不用我吧?只是他挂的东西太多了

  10. 天涯行客 Avatar

    怎么使分类横向排列,比如像wopus中文平台那样

  11. 酋 长 Avatar

    @ 天涯行客,我们没有使用这个函数,我们直接是用的具体链接地址。
    你可以看看wopus的源代码就明白了!

  12. Bodhi Avatar

    好像民间有中文的 WordPress Docs wiki,否则这样一条函数一条函数的写文章,累人。

  13. Don Avatar

    請問該如何只顯示主分類而其他子分類不顯示?

  14. 辐射鱼 Avatar

    child_of设为-1看看

  15. […] 本文转载来之:https://www.wopus.org/how-to-use-wp_list_categories.html只供学习 […]

  16. 猪猪 Avatar

    这个不错,回头我去修改一下模板看看~~~HOHO~~~

    1. 辐射鱼 Avatar

      鼓励大家自觉动手

  17. nooidea Avatar

    还有点复杂

    1. 酋 长 Avatar

      慢慢看,不然下次拒绝回答你的问题,哈哈~~

  18. 贺昌 Avatar

    受教了,参考解说修改了自己的代码~

  19. […] 15:15 | 来源: 原创 | 作者: 辐射鱼 | 评论: 21条评论 […]

  20. 拼一把博客 Avatar

    这个方法是在wordpress的哪个页面下啊?