the_terms()

2.5.0 wp-includes / category-template.php / Кодекс WordPress

Выводит ссылки на элементы таксономий поста, разделённые запятыми (меняется в параметрах).

Воспользуйтесь функцией get_the_terms(), если хотите получить термины поста в виде массива объектов.

the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' )

Параметры

$post_id: (целое) ID поста, термины которого нужно вывести.

Если хотите вывести термины текущего поста в цикле, передайте в этот параметр функцию get_the_ID().
$taxonomy: (строка) Название таксономии.
$before: (строка) Текст или HTML, который добавляем перед терминами.
$sep: (строка) Чем разделить ссылки, по умолчанию разделяются запятой.
$after: (строка) Текст или HTML, который добавляем после списка терминов.

Пример

// выводим ссылки на категории (рубрики) текущего поста, разделённые слешами
the_terms( get_the_ID(), 'category', 'Рубрики: ', ' / ' );
// Рубрики: <a href="http://.../category/cat-1">Рубрика 1</a> / <a href="http://.../category/cat-2">Рубрика 2</a>

Хуки

the_terms

Позволяет изменить финальный HTML выводимых терминов.

С версии 2.9.0

echo apply_filters( 'the_terms', $term_list, $taxonomy, $before, $sep, $after );

Ну к примеру, при помощи этого хука можно даже попробовать заменить запятые на… тег <br> к примеру. Хотя у меня есть сомнения, что это хорошая идея так делать, но для примера сойдёт.

add_filter( 'the_terms', 'true_change_the_terms_html', 25, 5  );
 
function true_change_the_terms_html( $term_list, $taxonomy, $before, $sep, $after ) {
 
	return str_replace( ', ', '<br>', $term_list );
 
}

Не знаете, как работать с фильтрами?

Кодекс 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. Преподаватель в школе Нетология.

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

Параметры
Пример
Хуки
1. the_terms