Функция the_terms() в WordPress: использование и примеры

# Функция the_terms() в WordPress

Функция the_terms() отображает термины в виде списка. Это полезно, когда вы хотите показать пользователям категории или теги, к которым относится пост.

## Основная информация

- **Используется в:** get_the_term_list()
- **Скорость:** 1 раз — 0.00357 сек (медленно) | 50000 раз — 5.11 сек (быстро)
- **PHP версия:** 7.1.2, WP 4.7.3

## Хуки

Функция the_terms() использует хук the_terms, который позволяет модифицировать вывод перед его отображением.

## Возвращаемое значение

- **null|false:** Возвращает null или false в случае успешного выполнения, false — в случае ошибки.

## Использование

Функция the_terms() используется следующим образом:

```php
the_terms( $post_id, $taxonomy, $before, $sep, $after );

• $post_id (int, обязательный) — ID поста, для которого вы хотите получить термины.
• $taxonomy (string, обязательный) — имя таксономии (например, категории или теги).
• $before (string) — строка, которая будет добавлена перед терминами. По умолчанию: ''.
• $sep (string) — строка, которая будет использоваться между терминами. По умолчанию: ', '.
• $after (string) — строка, которая будет добавлена после терминов. По умолчанию: ''.

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

Пример 1: Отображение списка элементов таксономии "планеты"

Предположим, у нас есть пользовательская таксономия "планеты" и пост с ID 67, который относится к двум элементам этой таксономии: Земля и Марс. Код будет выглядеть так:

Результат будет таким:

В категориях: Земля, Марс

Добавьте свой пример

Вы можете добавить свои примеры использования функции здесь.

Изменения в коде

Функция the_terms() была представлена начиная с версии 2.5.0. Вот исходный код функции:

function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
$term_list = get_the_term_list( $post_id, $taxonomy, $before, $sep, $after );

if ( is_wp_error( $term_list ) ) {
    return false;
}

// Фильтруем список терминов перед его отображением.
echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );

}

Связанные функции

Вот некоторые связанные функции, которые могут быть полезны при работе с терминами и таксономиями:

• category_exists()
• get_term()
• get_term_by()
• get_terms()
• wp_delete_term()
• term_exists()

Таксономии: категории, теги и другие

Таксономии позволяют организовывать контент на вашем сайте. Вот несколько функций, связанных с таксономиями:

• register_taxonomy() — регистрирует новую таксономию.
• is_taxonomy_hierarchical() — проверяет, является ли таксономия иерархической.
• get_taxonomies() — получает все зарегистрированные таксономии.

Эти функции помогут вам более эффективно управлять терминами и таксономиями в вашем WordPress-сайте.