企业网站模板

WordPress函数:wp_list_categories(分类列表)实例及原理

作者 2021-05-21 634

原型:wp_list_categories( string|array $args = ” )

1、默认情况下,该函数生成无序列表,你应该使用

对其生成的内容进行包裹。
2、wp_list_categories()和list_cats()以及wp_list_cats()的使用类似,但是后面 2 个已经弃用。
3、如果你希望将这个结果作为变量的话,可以将”echo”=>0,然后按变量进行操作。
4、也可以使用get_categories(),来获取分类变量。
5、此函数的参数,接收字符串或数组,具体请见下面实例。
6、以下例子测试环境Wordpress4.8

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
<!--?php $args = array( "title_li"=>'</p>
<h2>' . __( '金三国', 'textdomain' ) . '</h2>
<p>',
			"show_option_all"=>'首页',
			"orderby"=>'ID',
			"style"=>'list',
			"show_count"=>1,
			"hide_empty"=>0,
			"use_desc_for_title"=>1,
			"child_of"=>0,
			"exclude"=>1,
			"hierarchical"=>1,
			"echo"=>1,
			"current_category"=>1,
			"hide_title_if_empty"=>1,
			"taxonomy"=>'category'
		);
 
	wp_list_categories($args);
?-->

不要被这些参数吓到,其实它很简单,你只需了解英文的大概意思即可,我们来看实例。

实例一、按字母顺序排序分类,只包括类别ID为2,4,7,9 的分类,你可以使用下面的代码:

1
<!--?php wp_list_categories('orderby=name&include=2,4,7,9'); ?-->

实例二、根据名称排列,显示文章数,并且排除ID为7的分类:

1
<!--?php wp_list_categories('orderby=name&show_count=1&exclude=7'); ?-->

实例三、 显示分类名称,显示分类所属的文章数量

1
<!--?php wp_list_categories('show_count=1&title_li=category'); ?-->

实例四、显示分类下的子分类,包括文章数量,同时显示空的子分类

1
<!--?php wp_list_categories('child_of=5&title_li=&show_count=1&hide_empty=0'); ?-->

实例五、你可以指定分类目录的标题及样式

1
2
3
4
5
<!--?php 
wp_list_categories('title_li=</p>
<h2>' . __( '金三国', 'textdomain' ) . '</h2>
<p>');
?-->

实例六、如果你不打算使用无序列表形式的分类,可以参考超链与换行形式的。

1
<!--?php wp_list_categories('style=0'); ?-->

实例七、根据分类名称进行排序,显示文章数量,并且显示每个分类的 RSS 订阅链接

1
<!--?php wp_list_categories('orderby=ID&show_count=1&feed=RSS'); //现在很不常用了 ?-->

实例八、在分类显示的超链接中,使用title属性,利于SEO

1
<!--?php wp_list_categories('use_desc_for_title=1'); ?-->

然后我们来大概的看下它的参数解释,不必担心,该函数你只需要知道它的存在及简单使用即可,因为不怎么用了。

参数 用途 参数值
show_option_all 指定站点首页的超链接 首页的名称(字符串)
order 升序或降序 ASC升序(默认)、
DESC降序
style 分类列表显示的样式 list 输出li,
none 使用<br >标签分隔列表项
show_count 是否显示文章数量 1,0
hide_empty 是否隐藏没有文章的分类 1,0
use_desc_for_title 是否在链接显示 title 属性 1,0
child_of 只显示此参数确定的分类的子分类 为8 显示ID为 8 的分类的子分类
为0则显示分类的所有子类
exclude 排除一个或多个分类。使用逗号分隔每个分类的ID,参数 include 必须为空。 4,7
exclude_tree 排除分类树。使用逗号分隔每个分类的ID,参数 include 必须为空。
include 只显示特定的分类,使用逗号分隔每个分类的ID 3,5,9,16
hierarchical 是否按层级显示分类 1,0
title_li 设置列表的标题,默认为“Categories”。 传递空字符串禁用
echo 显示结果或保存在一个变量里 1,0
depth 显示分类的深度(即显示多少层的子分类) 0 – 所有分类和子分类(默认)
-1 – 所有类别显示在平面(不缩进)的形式(覆盖hierarchical)。
1 – 只显示顶级分类
n – 任意大于1的值,根据n的具体数字来显示对应等级的分类。
current_category 默认为0,在当前分类下加样式值,便于美化 为0则根据页面动图添加当前样式值,填指定分类id,则仅在指定分类中添加样式值
pad_counts 父分类的文章数是否包括子分类的链接或文章数。 1,0
taxonomy 给定分类法 默认category

随着Wordpress版本的更新,此函数的使用频率越来越低,本wordpress教程的意义在于,你只需了解以上例子功能、使用的环境,即可,比如,你碰到需要调阅分类的时候,能想起这个函数就可以了。

点击【分享给朋友】生成专属代理二维码,享受推广消费现金奖励!

发表评论

好哇网,累计帮助1000+用户成功建站,为小微企业提供助力!

立刻开启你的建站之旅

留言咨询

现在加入好哇网,注册一个账号

Notice: Undefined index: HTTP_REFERER in /home/wwwroot/haowaweb/wp-content/plugins/wp-baidu-submit/wp_baidu_submit.php on line 68