WordPress函数term_exists()检查分类元素是否存在
WordPress 中的函数term_exists()
检查给定分类中是否存在特定术语。它需要三个参数:$term
、$taxonomy
、$parent_term
推荐:[最新版]WordPress问答插件免费下载DW Question Answer Pro插件
term_exists()函数基本语法
描述
检查分类元素是否存在
用法
term_exists ( $term , $taxonomy , $parent_term );
参数
- $term (string|int)(必需)您要检查的术语。您可以指定名称、备用名称(slug)或 ID。如果指定了 ID,则该值必须是“数字”类型,但不能是“字符串”类型的数字。例如
12
,不是'12'
。 - $分类法(字符串)该函数将使用的分类法的名称。当 $term 参数中传递 term ID 时,不需要指定它。默认: ”
- $parent (字符串|整数)应在其下搜索指定分类项的父术语的 ID。默认值:空
推荐:[最新版]Kadence Theme Pro插件下载多用途轻量级WordPress主题
term_exists()函数
WordPress 中的term_exists()函数函数常用于在插入/更新分类法项前检查其是否已存在,以避免创建重复的分类法项。也可以根据返回的ID来获取更多关于这个分类法项的信息。(源文件可参考这里)
function term_exists( $term, $taxonomy = '', $parent_term = null ) {
global $_wp_suspend_cache_invalidation;
if ( null === $term ) {
return null;
}
$defaults = array(
'get' => 'all',
'fields' => 'ids',
'number' => 1,
'update_term_meta_cache' => false,
'order' => 'ASC',
'orderby' => 'term_id',
'suppress_filter' => true,
);
// Ensure that while importing, queries are not cached.
if ( ! empty( $_wp_suspend_cache_invalidation ) ) {
$defaults['cache_results'] = false;
}
if ( ! empty( $taxonomy ) ) {
$defaults['taxonomy'] = $taxonomy;
$defaults['fields'] = 'all';
}
/**
* Filters default query arguments for checking if a term exists.
*
* @since 6.0.0
*
* @param array $defaults An array of arguments passed to get_terms().
* @param int|string $term The term to check. Accepts term ID, slug, or name.
* @param string $taxonomy The taxonomy name to use. An empty string indicates
* the search is against all taxonomies.
* @param int|null $parent_term ID of parent term under which to confine the exists search.
* Null indicates the search is unconfined.
*/
$defaults = apply_filters( 'term_exists_default_query_args', $defaults, $term, $taxonomy, $parent_term );
if ( is_int( $term ) ) {
if ( 0 === $term ) {
return 0;
}
$args = wp_parse_args( array( 'include' => array( $term ) ), $defaults );
$terms = get_terms( $args );
} else {
$term = trim( wp_unslash( $term ) );
if ( '' === $term ) {
return null;
}
if ( ! empty( $taxonomy ) && is_numeric( $parent_term ) ) {
$defaults['parent'] = (int) $parent_term;
}
$args = wp_parse_args( array( 'slug' => sanitize_title( $term ) ), $defaults );
$terms = get_terms( $args );
if ( empty( $terms ) || is_wp_error( $terms ) ) {
$args = wp_parse_args( array( 'name' => $term ), $defaults );
$terms = get_terms( $args );
}
}
if ( empty( $terms ) || is_wp_error( $terms ) ) {
return null;
}
$_term = array_shift( $terms );
if ( ! empty( $taxonomy ) ) {
return array(
'term_id' => (string) $_term->term_id,
'term_taxonomy_id' => (string) $_term->term_taxonomy_id,
);
}
return (string) $_term;
}
推荐:NEX-Forms插件下载WordPress表单生成器插件+ Addons
如何使用term_exists()
检查术语是否存在(在任何分类中)
$term = term_exists( 'miscellaneous' );
//returns the ID of the taxonomy element with the 'miscellaneous' slug
$term = term_exists( 'Men Clothes' );
//returns the ID of the taxonomy element named 'Men Clothes'
检查特定分类中是否存在术语,检查my_tax分类术语是否存在:
$term = term_exists( 'Men clothing', 'my_tax' );
//returns an array
// [term_id] => 80
// [term_taxonomy_id] => 84
// taxonomy element ID
echo $term['term_id'];
// taxonomy element ID in taxonomy structure
echo $term['term_taxonomy_id'];
检查Uncategorized类别是否存在:
$term = term_exists( 'Uncategorized', 'category' );
if ( $term !== 0 && $term !== null ) {
echo 'Uncategorized category exists!';
}
推荐:WordPress函数get_theme_support()获取注册支持时传递的主题参数