wp_list_categories function is a function in WordPress used to list categories in the system. This function has many parameters that control the output. Suddenly today I was asked by a friend, so I sorted it out.
Because of the extended widget functionality built into WordPress,
So we can display a category list in the sidebar or other location we want without using any function,
Therefore, the wp_list_categories function is rarely used,
This function is somewhat similar to wp_list_bookmarks,
wp_list_categories Description
The wp_list_categories function is a function used in WordPress to list category links in the system.
The original English text is not available. If you are interested, you can read the official documentation.
Usage
<?php wp_list_categories( $args ); $args = array( 'show_option_all' => '',//是否列出分类链接 'orderby' => 'name',//按名称排列 'order' => 'ASC',//升、降序 'style' => 'list',//是否用列表(ul>li) 'show_count' => 0,//是否显示文章数量 'hide_empty' => 1,//是否显示无日志分类 'use_desc_for_title' => 1,//是否显示分类描述 'child_of' => 0,//是否限制子分类 'feed' => '',//是否显示rss 'feed_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//用于显示的类(很复杂的概念) ?>
Regarding 'pad_counts', I don't understand what this parameter is used for,
If you are interested, you can study the official documentation of this parameter.
You can also check wp_list_bookmarks to use it.
pad_counts (boolean) Calculates link or post counts by including items from child categories. If show_counts and hierarchical are true this is automatically set to true. This parameter added at Version 2.9 Valid values: 1 (true) 0 (false) – default
Usage examples
The display includes category links with IDs 3, 5, 9, and 16, sorted by name
<ul> <?php wp_list_categories('orderby=name&include=3,5,9,16'); ?> </ul>
Display the category list with IDs 5, 9, and 23 titled Poetry
<ul> <?php wp_list_categories('include=5,9,23&title_li=<h2>' . __('Poetry') . '</h2>' ); ?> </ul>
Of course, you can also write parameters as follows and integrate the parameters into an array.
<?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> <?php wp_list_categories( $args ); ?> </ul>
Taxonomy classification is a concept relative to tags.