get_term_by函数是WordPress中用来获取分类法、标签法、自定义分类法的分类项信息的函数。
函数原型如下:
get_term_by( string $field, mixed $value, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' )
参数说明:
$field:表示需要匹配的字段名。可以是id(分类ID)、name(分类名称)、slug(分类别名)、term_group(分类组)中的一个。
$value:表示需要匹配的值。
$taxonomy:表示分类法的名称,默认为空。如果提供了分类法名称,函数会在指定的分类法中查找分类项。
$output:表示返回的分类项的数据类型,默认为OBJECT。可以是OBJECT(返回分类项对象)、ARRAY_A(返回关联数组)、ARRAY_N(返回索引数组)中的一种。
$filter:表示是否对返回结果进行过滤,默认为'raw'。可以是'raw'(不进行过滤)或'edit'(对结果进行编辑过滤)。
函数返回值:
如果能够找到匹配的分类项,则返回找到的分类项;如果找不到匹配的分类项,则返回false。
示例用法:
1. 通过分类别名获取分类项对象:
$term = get_term_by('slug', 'news', 'category');
这个示例通过分类别名news在分类法category中找到对应的分类项,并将返回结果保存到$term变量中。
2. 通过分类名称获取分类项数组:
$term = get_term_by('name', 'news', 'category', 'ARRAY_A');
这个示例通过分类名称news在分类法category中找到对应的分类项,并将返回结果保存为一个关联数组。
3. 通过分类ID获取分类项对象:
$term = get_term_by('id', 3, 'category');
这个示例通过分类ID为3在分类法category中找到对应的分类项,并将返回结果保存到$term变量中。
需要注意的是,如果提供了分类法名称,那么函数只会在指定的分类法中查找分类项。如果不提供分类法名称,那么函数会在所有已注册的分类法中查找分类项。
0 个评论