get_terms()

WordPress 函数 get_terms() 搜索分类或标签参数

函数是 WordPress 中用于获取分类(terms)或标签(tags)的函数。它允许你检索与指定参数匹配的分类或标签。

以下是 get_terms() 函数的常见参数,以便搜索分类或标签:

  1. taxonomy(字符串):指定要检索的分类法(taxonomy)。通常,你可以使用 category(分类)或 post_tag(标签)作为值,但如果你有自定义分类法,也可以将其名称作为参数传递。

  2. orderby(字符串或数组,可选):用于指定结果的排序方式。可以使用的值包括:
    'name':按名称排序。
    'slug':按标识符排序。
    'term_group':按分类或标签组排序。
    'term_id':按分类或标签的 ID 排序。
    'count':按分类或标签的数量排序。
    'none':不排序。

  3. order(字符串,可选):用于指定排序顺序,可以是 'ASC'(升序)或 'DESC'(降序)。

  4. hide_empty(布尔值,可选):指定是否隐藏没有关联帖子的空分类或标签。默认为 true,即隐藏空分类或标签。

  5. include(数组,可选):用于包括特定分类或标签的 ID。只返回包括在此数组中的分类或标签。

  6. exclude(数组,可选):用于排除特定分类或标签的 ID。不返回在此数组中的分类或标签。

  7. parent(整数,可选):用于获取指定父分类或标签的子分类或标签。

  8. child_of(整数,可选):获取指定分类或标签的子分类或标签。与 parent 参数不同,child_of 只能获取指定分类或标签的直接子项。

  9. number(整数,可选):指定要返回的分类或标签的数量。

  10. offset(整数,可选):从结果中的某个位置开始返回分类或标签。

这些参数允许你根据不同的需求来筛选和排序分类或标签。你可以根据你的项目需求使用这些参数的组合来获取所需的分类或标签数据。例如,如果你想获取名称按升序排列的所有非空分类,可以这样使用:

$categories = get_terms(array(
    'taxonomy' => 'category',
    'orderby' => 'name',
    'order' => 'ASC',
    'hide_empty' => true
));

请注意,这只是一个示例,你可以根据你的具体需求来调整参数。根据不同的 WordPress 版本和项目环境,函数的行为可能会有所不同,因此请查阅官方文档以获取最新信息和使用示例。