get_terms函数是WordPress中用于获取分类或标签的函数。它的详细用法如下:
语法:
get_terms( $args );
参数:
$args (array):用于指定获取分类或标签的参数。常用的参数有:
- taxonomy:要获取的分类或标签的类型。例如,如果要获取分类,可以设置为“category”,如果要获取标签,可以设置为“post_tag”。默认值为空。
- include:要包含的分类或标签的ID。默认值为空。
- exclude:要排除的分类或标签的ID。默认值为空。
- child_of:获取指定分类的所有子分类。默认值为0,表示获取所有分类。
- number:要获取的分类或标签的数量。默认值为0,表示获取所有分类或标签。
- orderby:按照什么字段来排序分类或标签。可以使用的值有:'id'(按照分类或标签的ID排序)、'name'(按照分类或标签的名称排序)、'slug'(按照分类或标签的别名排序)、'count'(按照分类或标签下的文章数量排序)。默认值为'name'。
- order:排序方式,可以是'ASC'(升序)或'DESC'(降序)。默认值为'ASC'。
- hide_empty:是否隐藏没有文章的分类或标签。设置为true表示隐藏,设置为false表示不隐藏。默认值为true。
- fields:所要返回的分类或标签的字段。可以是'id'(分类或标签的ID)、'name'(分类或标签的名称)、'slug'(分类或标签的别名)、'count'(分类或标签下的文章数量)、'parent'(分类或标签的父级ID)等。默认值为'all',返回所有字段。
返回值:
如果成功获取到分类或标签,则返回一个包含分类或标签对象的数组;如果没有获取到,则返回一个空数组。
示例用法:
1. 获取所有分类:
$categories = get_terms( 'category' );
2. 获取所有标签:
$tags = get_terms( 'post_tag' );
3. 获取一个分类下的子分类:
$subcategories = get_terms( array(
'taxonomy' => 'category',
'child_of' => 1, //要获取子分类的ID
) );
4. 获取指定ID的分类或标签:
$term = get_terms( array(
'taxonomy' => 'category',
'include' => array( 1, 2, 3 ), //要获取的分类ID
) );
5. 获取分类或标签的名称和ID:
$terms = get_terms( array(
'taxonomy' => 'category',
'fields' => 'id=>name',
) );
这些示例只是get_terms函数的一部分用法,根据实际需求可以灵活运用其它参数和功能。
0 个评论