term_exists()

3.0.0 wp-includes / taxonomy.php / Кодекс WordPress

Проверяет, существует ли элемент таксономии с указанным ID, ярлыком или названием.

Обратите пожалуйста внимание, что функция не супер-быстрая, потому что работает напрямую с базой данных, поэтому возможно, что в вашей ситуации будет лучше использовать для этой цели get_term_by(), которая использует кэш, смотрите примеры.

Возвращает:

ID термина, если он существует, а проверку мы делали только по ID, ярлыку или названию, не указывая второй и третий параметры функции. Кстати, с кириллическими названиями на моём тестовом сайте оно не заработало, но детальнее разбираться не стал. Если делали проверку по имени, а термины с одним и тем же именем повторяются, например существуют в разных таксономиях, то функция вернёт первый найденный (с наименьшим ID).
Если передан второй параметр функции, то в случае, если термин существует, возвращает массив:
```
Array
	'term_id' => 25,
	'term_taxonomy_id' => 25
)
```
null – если элемента таксономии (термина) не существует.
0 – если в первом параметре был передан 0.

term_exists( $term, $taxonomy = '', $parent = null )

Параметры

$term: (целое|строка) ID, ярлык или название элемента таксономии.
$taxonomy: (строка) Название самой таксономии – бывает полезно, если вы осуществляете проверку по названию термина, а термины с таким же названием могут повторяться в разных таксономиях.
$parent: (целое) Вы также можете указать ID родительского элемента, чтобы сузить область поиска.

Примеры

Давайте для начала проверим, что термин с ярлыком travel существует. Причём сделаем это двумя способами – как функцией term_exists(), так и get_term_by().

$slug = 'travel';
 
// первый способ
if( term_exists( $slug ) ) {
	echo 'Йез, термин существует!';
}
 
// второй способ
// заметили разницу? 
// тут придётся указать и название таксономии, в первом случае оно не было обязательным
if( get_term_by( 'slug', $slug, 'post_tag' ) ) {
	echo 'Йез, термин существует!';
}

Кодекс WordPress: Таксономии: add_term_meta(), edit_term_link(), get_ancestors(), get_edit_term_link(), get_taxonomies(), get_taxonomy(), get_term(), get_term_by(), get_term_children(), get_term_field(), get_term_link(), get_term_meta(), get_term_parents_list(), get_terms(), get_the_term_list(), get_the_terms(), is_object_in_term(), is_tax(), is_taxonomy_hierarchical(), register_taxonomy(), register_taxonomy_for_object_type(), sanitize_term(), sanitize_term_field(), single_term_title(), taxonomy_exists(), term_description(), term_exists(), term_is_ancestor_of(), the_terms(), unregister_taxonomy(), unregister_taxonomy_for_object_type(), update_term_meta(), wp_count_terms(), wp_delete_term(), wp_get_object_terms(), wp_get_post_terms(), wp_get_term_taxonomy_parent_id(), wp_insert_term(), wp_set_object_terms(), wp_update_term()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Примеры