WordPress 使用 WP_Term_Query 代替 get_terms

WordPress 4.6 提供了新的查询分类的方法,比如WP_Query,WP_User_Query以及 WP_Comment_Query
WordPress 程序为你准备好了一切,你可以使用 WordPress 自带的查询分类的方法完成你所需要的东西,你不需要在你的数据库里去写复杂的SQL 查询。

WP_Term_Query

/**
* WP_Term_Query 应用举例
*
* @author 智慧宫
* @link http://lerm.net
*/
$term_query = new WP_Term_Query( $args );
if ( ! empty( $term_query->terms ) ) {
    foreach ( $term_query ->terms as $term ) {
        echo $term->name;
    }
} else {
    echo 'No term found.';
}

参数解释:

上面例子中的 $args 有很多查询分类法参数.

  • taxonomy
    (字符串|数组) 分类法名称或分类发的数组,对结果应加以限制。
  • orderby
    (字符串) 分类项按顺序排列。接受术语字段(‘name’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’)
  • order
    (字符串) 按升序或降序排列分类项,接受 ‘ASC’ (ascending) 或者 ‘DESC’ (descending).默认 ‘ASC’.
  • hide_empty
    (布尔|整型) 是否隐藏没有文章的分类项,接受1|true 或者 0|false, 默认 1|true.
  • include
    (数组|字符串) 用数组或者逗号分隔需要获取的分类项的ID,无默认值
  • exclude
    (数组|字符串) 用数组或者逗号分隔不需要获取的分类项的ID,无默认值,如果include不为空,那就$exclude会被忽略
  • exclude_tree
    (数组|字符串) 用数组或者逗号分隔不需要获取的分类项的ID,排除后代分类项,如果 $include 不为空,$exclude_tree 会被忽略。
  • number
    (整型|字符串) 返回的最大项数 . 接受 |0 (全部) 或者任何正整数. 默认|0 (全部).
  • offset
    (整型) 跳过的文章数量。
  • fields
    (字符串) 查询条件. 接受 ‘all’ (返回全部的分类项的对象的数组), ‘ids’ (返回ids的数组), ‘id=>parent’ (返回ID为键,父级分类项IDs为值的数组), ‘names’ (返回分类项的名称的数组), ‘count’ (返回与分类项匹配的数字), ‘id=>name’ (返回ID为键,分类项名称为值的数组), or ‘id=>slug’ ( 返回ID为键,分类项slug为值的关联数组). 默认为 ‘all’.
  • name
    (字符串|数组) 可选. 返回的分类项的名称或者返回的数组的名称
  • slug
    (字符串|数组) 可选. 任何含有slug的分类项都可以作为该变量的值。默认为空字符串
  • hierarchical
    (布尔) 是否返回层级分类法(即使$HIDEIOLL被设置为真)默认为 true
  • search
    (字符串) 分类项匹配的搜索条件,将使用前后通配符对SQL进行格式化
  • name__like
    (字符串) 检索与 $name__like 相匹配的分类项
  • description__like
    (字符串) 检索描述像 $description__like 的分类项
    Retrieve terms where the description is LIKE .
  • pad_counts
    (布尔) 是否计算包括 $terms 在内的所有子辈,默认为:false
  • get
    (字符串) 是否返回分类项,无论是父级或者分项法否是为空,接受 all或者 empty
  • child_of
    (整型) 获取该分类项的所有后代,如果有多个分类法, $child_of 被忽略.默认为0.
  • parent
    (整型|字符串) 获取该ID的子term 父级分类项的ID检索直系子代分类项
  • childless
    (布尔) 限制没有子代的分类项的结果,在non-hierarchical分类法中不起作用,默认为False
    True to limit results to terms that have no children. This parameter has no effect on non-hierarchical taxonomies. Default false.
  • cache_domain
    (字符串) 当此查询存储在对象缓存中时,将产生唯一的缓存密钥,默认为 core.
  • update_term_meta_cache
    (布尔) 是否匹配分类项的元缓存
    Whether to prime meta caches for matched terms. Default true.
  • meta_query
    (数组)自定义字段参数. 详见 WP_Meta_Query.
  • meta_key
    (字符串) 自定义字段的键. 可以用于 $meta_value
  • meta_value
    (字符串) 自定义字段的值.通常与 $meta_key 一起使用.

Category 中检索分类项

/**
* WP_Term_Query 使应用举例
*
* @author 智慧宫
* @link http://lerm.net
*/
$term_query = new WP_Term_Query( array( 'taxonomy' => 'category' ) );
if ( ! empty( $term_query->terms ) ) {
    foreach ( $term_query ->terms as $term ) {
        echo $term->name;
    }
} else {
    echo 'No term found.';
}

发表评论

  1. 吃馒头的猫 回复

    受教了