the_terms()
Виводить список посилань на терміни (елементи таксономії), що належать до зазначеної посади.
Працює на основі:
get_the_term_list()
get_the_term_list()
1 раз – 0.00357 сек
(дуже повільно) | 50000 разів – 5.11 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
(дуже повільно) | 50000 разів – 5.11 сек
(швидко) |
PHP 7.1.2, WP 4.7.3
Хуки з функції
Повертає
null|false. Виводить на екран перелік посилань на терміни, до яких прикріплений об’єкт (запис).
Використання
<?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 6.0.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 для використання між термінами.
* @param string $after String для використання після термінів.
*/
echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );
}