the_taxonomies()

Отображает таксономии записи с доступными параметрами
Функция WordPress
INT 2.5.0
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Отображение всех таксономий поста
  4. Форматирование вывода таксономий
  5. Использование пользовательских шаблонов для таксономий
  6. Отображение таксономий с разделителями
  7. Изменение порядка отображения таксономий
  8. Вопросы и ответы
  9. Как вывести список таксономий для определенного поста?
  10. Как изменить разделитель между таксономиями?
  11. Как добавить текст перед и после списка таксономий?
  12. Как изменить шаблон отображения метки таксономии и списка терминов?
  13. Как изменить шаблон отображения отдельного термина в списке?
  14. Как вывести список таксономий без меток?
  15. Как изменить порядок отображения таксономий?
  16. Как изменить шаблон отображения списка таксономий?
  17. Как вывести список таксономий для нескольких постов?
  18. Связанные элементы

Описание функции

Функция the_taxonomies() отображает таксономии записи с доступными опциями. Она использует функцию get_the_taxonomies() для получения списка таксономий записи и форматирует его для вывода на экран. Функция позволяет настроить формат вывода таксономий и их терминов с помощью опциональных аргументов.

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

the_taxonomies( array $args = array() )

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

  • post — int|WP_Post: ID или объект записи, для которой нужно получить таксономии. По умолчанию — текущая запись.
  • before — string: текст, отображаемый перед таксономиями. По умолчанию — пустая строка.
  • sep — string: разделитель между таксономиями. По умолчанию — пробел.
  • after — string: текст, отображаемый после таксономий. По умолчанию — пустая строка.
  • template — string: шаблон для отображения метки таксономии и списка терминов. По умолчанию — «Метка: Термины».
  • term_template — string: шаблон для отображения отдельного термина в списке. По умолчанию — имя термина со ссылкой на его архив.
<?php
  // Получаем таксономии текущей записи и выводим их с настройками по умолчанию
  the_taxonomies();
  // Получаем таксономии записи с ID 42 и выводим их с настройками по умолчанию
  the_taxonomies( array( 'post' => 42 ) );
  // Получаем таксономии текущей записи и выводим их с кастомными настройками
  the_taxonomies( array(
    'before' => 'Таксономии: ',
    'sep' => ', ',
    'after' => '.',
    'template' => 'Метка: Термины',
    'term_template' => '<a href="%term_link%">%term_name%</a>'
  ) );
?>

В этом примере мы используем функцию the_taxonomies() для вывода таксономий записи. В первом вызове функции используются настройки по умолчанию, во втором вызове указывается ID записи, для которой нужно получить таксономии. В третьем вызове функции мы указываем кастомные настройки для форматирования вывода таксономий и их терминов.

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

Отображение всех таксономий поста


// Отображение всех таксономий текущего поста
the_taxonomies();

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

Форматирование вывода таксономий


// Отображение всех таксономий текущего поста с заданным форматированием
$args = array(
    'before' => 'Таксономии: ',
    'sep' => ', ',
    'after' => '.'
);
the_taxonomies($args);

Функция the_taxonomies() принимает массив параметров $args, который позволяет задать форматирование вывода таксономий. В данном примере перед каждым списком таксономий будет добавлен текст «Таксономии: «, таксономии будут разделены запятой, а после списка таксономий будет добавлен символ точки.

Использование пользовательских шаблонов для таксономий


// Использование пользовательского шаблона для отображения таксономий
$args = array(
    'template' => 'Таксономия: %l - %t'
);
the_taxonomies($args);

Функция the_taxonomies() позволяет использовать пользовательские шаблоны для отображения таксономий. В данном примере используется шаблон «Таксономия: %l — %t», где %l будет заменено на название таксономии, а %t — на список терминов этой таксономии.

Отображение таксономий с разделителями


// Отображение таксономий текущего поста с заданным разделителем
$args = array(
    'sep' => ' | '
);
the_taxonomies($args);

Функция the_taxonomies() позволяет задать разделитель между таксономиями. В данном примере разделитель задан как » | «.

Изменение порядка отображения таксономий


// Отображение таксономий текущего поста с измененным порядком
$args = array(
    'template' => 'Таксономия: %l - %t',
    'term_template' => '%n (%c)'
);
the_taxonomies($args);

Функция the_taxonomies() позволяет изменить порядок отображения таксономий и терминов. В данном примере используется пользовательский шаблон для отображения таксономий и шаблон для отображения терминов, где %n будет заменено на название термина, а %c — на количество постов, связанных с этим термином.

Вопросы и ответы

Как вывести список таксономий для определенного поста?

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

Для вывода списка таксономий для определенного поста необходимо передать его ID или объект в параметр post функции. По умолчанию используется текущий пост.

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


$post_id = 123; // ID поста
the_taxonomies( array( 'post' => $post_id ) );

Как изменить разделитель между таксономиями?

По умолчанию разделителем между таксономиями является пробел. Чтобы изменить разделитель, необходимо использовать параметр sep.

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


the_taxonomies( array( 'sep' => ', ' ) );

Как добавить текст перед и после списка таксономий?

Для добавления текста перед и после списка таксономий используются параметры before и after.

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


the_taxonomies( array( 'before' => 'Taxonomies: ', 'after' => ' - End of taxonomies' ) );

Как изменить шаблон отображения метки таксономии и списка терминов?

Для изменения шаблона отображения метки таксономии и списка терминов можно использовать параметр template в функции the_taxonomies(). По умолчанию шаблон выглядит так: «Label: Terms.». Чтобы изменить его, нужно передать новый шаблон в виде строки.


$args = array(
    'template' => 'Custom Label: Custom Terms.'
);
the_taxonomies($args);

Как изменить шаблон отображения отдельного термина в списке?

Для изменения шаблона отображения отдельного термина в списке можно использовать параметр term_template в функции the_taxonomies(). По умолчанию шаблон выглядит так: термин, связанный с его архивом. Чтобы изменить его, нужно передать новый шаблон в виде строки.


$args = array(
    'term_template' => 'Custom Term'
);
the_taxonomies($args);

Как вывести список таксономий без меток?

Для вывода списка таксономий без меток можно использовать параметр template в функции the_taxonomies(). Чтобы убрать метки, нужно передать пустую строку в качестве шаблона.


$args = array(
    'template' => ''
);
the_taxonomies($args);

Как изменить порядок отображения таксономий?

Для изменения порядка отображения таксономий в функции the_taxonomies() можно использовать аргументы ‘before’, ‘sep’ и ‘after’.

Аргумент ‘before’ позволяет задать текст, который будет отображаться перед списком таксономий. По умолчанию значение этого аргумента равно пустой строке.

Аргумент ‘sep’ позволяет задать разделитель между каждой таксономией. По умолчанию разделителем является пробел.

Аргумент ‘after’ позволяет задать текст, который будет отображаться после списка таксономий. По умолчанию значение этого аргумента равно пустой строке.

Как изменить шаблон отображения списка таксономий?

Для изменения шаблона отображения списка таксономий в функции the_taxonomies() можно использовать аргументы ‘template’ и ‘term_template’.

Аргумент ‘template’ позволяет задать шаблон для отображения метки таксономии и списка терминов. По умолчанию шаблон выглядит так: «Label: Terms.»

Аргумент ‘term_template’ позволяет задать шаблон для отображения отдельного термина в списке. По умолчанию термин отображается в виде ссылки на его архив.

Как вывести список таксономий для нескольких постов?

Для вывода списка таксономий для нескольких постов в функции the_taxonomies() можно использовать аргумент ‘post’.

Аргумент ‘post’ позволяет указать ID или объект поста, для которого нужно получить таксономии. По умолчанию используется текущий пост.

Функция the_taxonomies() в WordPress позволяет выводить список таксономий для поста с различными настройками. С помощью аргументов можно изменить порядок отображения таксономий, задать шаблон отображения списка и указать пост, для которого нужно получить таксономии. Это удобный инструмент для разработчиков WordPress, позволяющий гибко настраивать вывод таксономий на сайте.

Связанные элементы

  • Функция get_the_taxonomies(): Возвращает массив всех зарегистрированных таксономий для указанного поста.
  • Функция get_taxonomies(): Возвращает массив всех зарегистрированных таксономий в WordPress.
  • Функция get_term_link(): Возвращает URL-адрес для указанного термина таксономии.
  • Хук registered_taxonomy: Вызывается после успешной регистрации новой таксономии.
  • Хук pre_get_terms: Позволяет изменить аргументы запроса для получения терминов таксономии.
  • Хук term_link: Позволяет изменить URL-адрес для указанного термина таксономии.
  • Класс WP_Taxonomy: Представляет собой таксономию, такую как категория или метка, и содержит методы для работы с таксономией.
  • Класс WP_Tax_Query: Позволяет выполнить запрос к постам на основе таксономий.
Таксономии
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.