the_terms()

Отображает термины записи в виде списка
Функция 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_terms() используется для вывода списка терминов (категорий, меток и т. д.) для определенного поста.

Она отображает список терминов, связанных с указанным постом, в виде разделенных запятыми ссылок. Каждый термин представлен в виде ссылки, которая ведет на страницу архива данного термина.

Функция the_terms() является частью WordPress API и может быть использована в шаблонах WordPress для вывода списка терминов для постов.

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

the_terms( int $post_id, string $taxonomy, string $before = '', string $sep = ', ', string $after = '' ): void|false

Функция the_terms() принимает следующие параметры:

  • $post_id (обязательный) — идентификатор поста, для которого нужно вывести термины.
  • $taxonomy (обязательный) — название таксономии, для которой нужно вывести термины.
  • $before (необязательный) — строка, которая будет выведена перед терминами. По умолчанию пустая строка.
  • $sep (необязательный) — строка, которая будет использоваться для разделения терминов. По умолчанию запятая с пробелом.
  • $after (необязательный) — строка, которая будет выведена после терминов. По умолчанию пустая строка.

Функция the_terms() не возвращает никакого значения. Она просто выводит список терминов на экран.

<?php
$post_id = 123; // ID поста
$taxonomy = 'category'; // Название таксономии
$before = 'Categories: '; // Строка перед терминами
$sep = ', '; // Разделитель терминов
$after = ''; // Строка после терминов
the_terms( $post_id, $taxonomy, $before, $sep, $after );
?>

В этом примере мы используем функцию the_terms() для вывода списка категорий для поста с ID 123. Мы указываем, что перед терминами нужно вывести строку «Categories: «, разделитель терминов — запятая с пробелом, и после терминов ничего не нужно выводить.

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

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


/**
 * Отображает список терминов для поста.
 *
 * @param int    $post_id  Идентификатор поста.
 * @param string $taxonomy Название таксономии.
 * @param string $before   Строка, которая будет использована перед терминами. По умолчанию: ''.
 * @param string $sep      Строка, которая будет использована между терминами. По умолчанию: ', '.
 * @param string $after    Строка, которая будет использована после терминов. По умолчанию: ''.
 *
 * @return void|false Возвращает void в случае успеха, false в случае ошибки.
 */
function the_terms( $post_id, $taxonomy, $before = '', $sep = ', ', $after = '' ) {
    // Ваш код для отображения списка терминов
}

Создание списка терминов для поста


$post_id = 123; // Идентификатор поста
$taxonomy = 'category'; // Название таксономии
the_terms( $post_id, $taxonomy );

В этом примере функция the_terms() используется для отображения списка терминов категории для поста с идентификатором 123.

Форматирование списка терминов для поста


$post_id = 456; // Идентификатор поста
$taxonomy = 'post_tag'; // Название таксономии
$before = 'Теги: '; // Строка перед терминами
$sep = ' | '; // Разделитель между терминами
$after = '.'; // Строка после терминов
the_terms( $post_id, $taxonomy, $before, $sep, $after );

В этом примере функция the_terms() используется для отображения списка терминов метки для поста с идентификатором 456. Термины будут отформатированы в виде «Теги: термин1 | термин2 | термин3.»

Настройка отображения списка терминов для поста


$post_id = get_the_ID(); // Идентификатор текущего поста
$taxonomy = 'category'; // Название таксономии
the_terms( $post_id, $taxonomy, '<ul><li>', '</li><li>', '</li></ul>' );

В этом примере функция the_terms() используется для отображения списка терминов категории для текущего поста. Термины будут отображены в виде маркированного списка.

Изменение разделителя в списке терминов для поста


$post_id = 789; // Идентификатор поста
$taxonomy = 'post_tag'; // Название таксономии
$sep = ' / '; // Разделитель между терминами
the_terms( $post_id, $taxonomy, '', $sep );

В этом примере функция the_terms() используется для отображения списка терминов метки для поста с идентификатором 789. Термины будут отделены друг от друга символом «/».

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

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

Для вывода списка терминов для поста в WordPress используется функция the_terms(). Она принимает следующие параметры:

  • $post_id — обязательный параметр, указывающий ID поста;
  • $taxonomy — обязательный параметр, указывающий название таксономии;
  • $before — необязательный параметр, строка, которая будет выводиться перед терминами;
  • $sep — необязательный параметр, строка, которая будет выводиться между терминами;
  • $after — необязательный параметр, строка, которая будет выводиться после терминов.

Функция the_terms() возвращает void в случае успешного выполнения и false в случае ошибки.

Как изменить строку, которая будет выводиться перед терминами?

Для изменения строки, которая будет выводиться перед терминами, нужно передать соответствующую строку в параметр $before функции the_terms(). Например:


the_terms( $post_id, $taxonomy, 'Categories: ' );

В данном примере перед терминами будет выводиться строка «Categories: «.

Как изменить строку, которая будет выводиться между терминами?

Для изменения строки, которая будет выводиться между терминами, нужно передать соответствующую строку в параметр $sep функции the_terms(). Например:


the_terms( $post_id, $taxonomy, '', ', ' );

В данном примере между терминами будет выводиться запятая с пробелом.

Как изменить строку, которая будет выводиться после терминов?

Чтобы изменить строку, которая будет выводиться после терминов, нужно использовать параметр $after функции the_terms().


$after = ' - The End';
the_terms( $post_id, $taxonomy, '', ', ', $after );

Как изменить порядок вывода терминов?

Для изменения порядка вывода терминов нужно использовать параметр $sep функции the_terms().


$sep = ' | ';
the_terms( $post_id, $taxonomy, '', $sep );

Как изменить формат вывода терминов?

Для изменения формата вывода терминов можно использовать параметры $before и $sep функции the_terms().


$before = '<strong>';
$sep = '</strong> | <strong>';
the_terms( $post_id, $taxonomy, $before, $sep );

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

Для вывода только определенных терминов воспользуйтесь параметром $include. В этом параметре укажите массив идентификаторов терминов, которые нужно вывести.

// Вывести только термины с идентификаторами 1, 2 и 3
the_terms( $post_id, $taxonomy, '', ', ', '', array( 1, 2, 3 ) );

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

Для вывода списка терминов без ссылок установите параметр $link в значение false.

// Вывести список терминов без ссылок
the_terms( $post_id, $taxonomy, '', ', ', '', false );

Как вывести список терминов с ссылками на архивы терминов?

Для вывода списка терминов с ссылками на архивы терминов установите параметр $link в значение true.

// Вывести список терминов с ссылками на архивы терминов
the_terms( $post_id, $taxonomy, '', ', ', '', true );

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

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

  • Функция get_the_terms(): Возвращает массив терминов, связанных с определенным постом.
  • Функция get_the_term_list(): Возвращает список терминов, связанных с определенным постом в виде строки.
  • Функция get_the_term_list(): Возвращает список терминов, связанных с определенным постом в виде массива.
  • Хук the_terms: Позволяет изменить вывод терминов, связанных с постом.
  • Хук get_the_terms: Позволяет изменить список терминов, связанных с постом, перед его выводом.
  • Класс WP_Term_Query: Используется для выполнения запросов к терминам таксономий.
  • Класс WP_Term: Представляет отдельный термин таксономии.
Термины
Обсуждение

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