Функция the_taxonomies() │ WP 2.5.0

Функция the_taxonomies() выводит ссылки на термины таксономии текущей записи. Обычно используется внутри цикла WordPress.

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

Время работы:

• 1 раз — 0.009228 сек (очень медленно)
• 50000 раз — 51.10 сек (очень медленно)

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

null. Выводит список ссылок на элементы таксономии (термины) текущей записи.

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

Параметры $args (массив)

$args — это параметры, которые определяют, какую запись использовать и как форматировать вывод. Все параметры, поддерживаемые функцией get_the_taxonomies(), могут быть использованы здесь, а также добавлены следующие:

• post (int|WP_Post): ID записи или объект WP_Post, для которого будут получены таксономии. По умолчанию используется текущая запись.
• before (string): текст, который выводится перед таксономиями. По умолчанию — пустая строка.
• after (string): текст, который выводится после таксономий. По умолчанию — пустая строка.
• sep (string): разделитель между каждой таксономией. По умолчанию — пробел.
• template (string): шаблон для вывода списка. %s — название таксономии, %l — список элементов в формате, заданном в параметре $term_template. По умолчанию: '%s: %l.'
• term_template (string): формат вывода для каждого элемента таксономии. По умолчанию: '<a href="%1$s">%2$s</a>'

Примеры

Пример 1: Вывод обычных постов

Вывод:

Темы: Code. Теги: Hacks и Hooks.

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

Вывод:

Таксономия: Code. Другая таксономия: Haki и Huki.

Пример 3: Обернуть список в тег <div>

 119,
    'before' => '
',
    'after'  => '
'
) );
?>

Вывод:

    Темы: code. Теги: loop и Beginners.

Изменения

С версии 2.5.0 — функция была добавлена.

Код функции

function the_taxonomies( $args = array() ) {
    $defaults = array(
        'post'   => 0,
        'before' => '',
        'sep'    => ' ',
        'after'  => '',
    );

    $parsed_args = wp_parse_args( $args, $defaults );

    echo $parsed_args['before'] . implode( $parsed_args['sep'], get_the_taxonomies( $parsed_args['post'], $parsed_args ) ) . $parsed_args['after'];
}

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

Для работы с таксономиями в записях:

• get_object_taxonomies()
• get_objects_in_term()
• get_the_category()
• get_the_category_list()
• get_the_tag_list()
• get_the_tags()
• get_the_taxonomies()
• get_the_term_list()
• get_the_terms()
• has_category()
• has_tag()
• has_term()
• is_object_in_taxonomy()
• is_object_in_term()
• the_category()
• the_tags()
• wp_delete_object_term_relationships()
• wp_get_object_terms()
• wp_get_post_categories()
• wp_get_post_tags()
• wp_get_post_terms()
• wp_remove_object_terms()
• wp_set_object_terms()
• wp_set_post_categories()
• wp_set_post_tags()
• wp_set_post_terms()

Для категорий и тегов:

• category_description()
• in_category()
• single_cat_title()
• single_tag_title()
• single_term_title()
• tag_description()
• term_description()
• the_terms()
• wp_dropdown_categories()
• wp_generate_tag_cloud()
• wp_list_categories()
• wp_tag_cloud()