the_terms() WP 2.5.0
Выводит список ссылок на термины (элементы таксономии), относящиеся к указанному посту.
Работает на основе: get_the_term_list()
1 раз — 0.00357 сек (очень медленно) | 50000 раз — 5.11 сек (быстро) | PHP 7.1.2, WP 4.7.3
Хуки из функции
Возвращает
Null. Выводит на экран список ссылок на термины, к которым прикреплен объект (запись).
Использование
<?php the_terms( $id, $taxonomy, $before, $sep, $after ); ?>
- $id(число) (обязательный)
- ID записи, элементы таксономии которой нужно получить.
По умолчанию: нет - $taxonomy(строка) (обязательный)
- Название таксономии, элементы которой нужно получить.
По умолчанию: нет - $beforeстрока
- Текст, который будет показан перед списком.
По умолчанию: '' - $sepстрока
- Текст-разделитель, который будет показан между выводимыми элементами (тегами).
По умолчанию: ', ' - $afterстрока
- Замыкающий текст (текст в конце списка).
По умолчанию: ''
Примеры
#1. Выведем список элементов таксономии planets
Предположим у нас есть произвольная таксономия planets
и пост с ID 67, который относится к 2-м элементам этой таксономии: Земля, Марс. Тогда код:
<?php the_terms( 67, 'planets', 'В разделах: '); ?> // выведет на экран: // В разделах: <a href="#">Земля</a>, <a href="#">Марс</a>
Список изменений
С версии 2.5.0 | Введена. |
Код the_terms() the terms WP 5.6.2
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;
}
/**
* Filters the list of terms to display.
*
* @since 2.9.0
*
* @param string $term_list List of terms to display.
* @param string $taxonomy The taxonomy name.
* @param string $before String to use before the terms.
* @param string $sep String to use between the terms.
* @param string $after String to use after the terms.
*/
echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
}