get_terms()

Вопросы и ответы

Как получить все термины в указанной таксономии?

Для получения всех терминов в указанной таксономии используется функция get_terms(). Она принимает массив или строку аргументов и возвращает массив терминов, количество терминов в виде числовой строки или WP_Error, если таксономии не существует.

Пример использования:

$terms = get_terms( 'taxonomy_name' );
if ( ! empty( $terms ) && ! is_wp_error( $terms ) ) {
    foreach ( $terms as $term ) {
        echo '<p>' . $term->name . '</p>';
    }
}

Как отсортировать термины по имени или другому полю?

Для сортировки терминов по имени или другому полю используется параметр orderby функции get_terms(). Значение этого параметра может быть одним из следующих: ‘name’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’, ‘parent’, ‘term_order’, ‘count’, ‘include’, ‘slug__in’, ‘meta_value’, ‘meta_value_num’, ‘none’.

Пример использования для сортировки по имени:

$terms = get_terms( array(
    'taxonomy' => 'taxonomy_name',
    'orderby'  => 'name',
) );

Как скрыть термины, которые не привязаны к постам?

Для скрытия терминов, которые не привязаны к постам, используется параметр hide_empty функции get_terms(). Значение этого параметра может быть 1 (true) или 0 (false).

Пример использования для скрытия пустых терминов:

$terms = get_terms( array(
    'taxonomy'   => 'taxonomy_name',
    'hide_empty' => true,
) );

Как получить только определенные термины по их ID или слагу?

Для получения только определенных терминов по их ID или слагу, необходимо использовать параметр include или slug в функции get_terms().

Пример использования параметра include:

 $args = array(
    'taxonomy' => 'category',
    'include' => array(1, 2, 3)
 );
$terms = get_terms( $args );

Пример использования параметра slug:

 $args = array(
    'taxonomy' => 'category',
    'slug' => array('term1', 'term2', 'term3')
 );
$terms = get_terms( $args );

Как исключить определенные термины из результатов запроса?

Для исключения определенных терминов из результатов запроса, необходимо использовать параметр exclude в функции get_terms().

Пример использования параметра exclude:

 $args = array(
    'taxonomy' => 'category',
    'exclude' => array(4, 5, 6)
 );
$terms = get_terms( $args );

Как получить только родительские термины или только дочерние термины?

Для получения только родительских терминов или только дочерних терминов, необходимо использовать параметры parent или child_of в функции get_terms().

Пример использования параметра parent для получения только родительских терминов:

 $args = array(
    'taxonomy' => 'category',
    'parent' => 0
 );
$terms = get_terms( $args );

Пример использования параметра child_of для получения только дочерних терминов:

 $args = array(
    'taxonomy' => 'category',
    'child_of' => 1
 );
$terms = get_terms( $args );

Как получить количество терминов в указанной таксономии?

Для получения количества терминов в указанной таксономии можно использовать функцию get_terms() с параметром count установленным в true. Возвращаемое значение будет числовой строкой, представляющей количество терминов.

$taxonomy = 'category';
$count = get_terms( array(
    'taxonomy' => $taxonomy,
    'count'    => true,
) );
echo 'Количество терминов в таксономии ' . $taxonomy . ': ' . $count;

Как выполнить поиск терминов по их имени или описанию?

Для выполнения поиска терминов по их имени или описанию можно использовать параметры name__like и description__like функции get_terms(). Параметры принимают строку, которая будет использоваться в SQL-запросе с подстановкой символов подстановки.

$search_term = 'apple';
$terms = get_terms( array(
    'taxonomy'        => 'fruits',
    'name__like'      => $search_term,
    'description__like' => $search_term,
) );
foreach ( $terms as $term ) {
    echo $term->name . '<br>';
}

Как получить термины, у которых нет дочерних терминов?

Для получения терминов, у которых нет дочерних терминов, можно использовать параметр childless функции get_terms(). Параметр принимает значение true для ограничения результатов только терминами без дочерних терминов.

$terms = get_terms( array(
    'taxonomy'  => 'fruits',
    'childless' => true,
) );
foreach ( $terms as $term ) {
    echo $term->name . '<br>';
}

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