Описание функции get_term_field()
Функция get_term_field() используется для получения значения определенного поля термина в таксономии WordPress. Это может быть полезно для извлечения метаданных, таких как название, описание и другие пользовательские поля термина. Функция особенно актуальна при работе с терминами в кастомных таксономиях.
Возвращаемое значение зависит от успешности запроса и может быть строкой, массивом или false, если термина не существует.
Параметры
$field
Тип: string
Обязательный: Да
Описание: Имя поля, которое необходимо получить (например, ‘name’, ‘description’)
Возможные значения:
0: name
1: slug
2: term_taxonomy_id
3: description
4: parent
5: count
6: term_group
$term_id
Тип: int
Обязательный: Да
Описание: ID термина, для которого нужно получить значение поля
Возможные значения:
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, к которой принадлежит термин
Возможные значения:
Возвращаемое значение
Тип: mixed
Описание: Возвращает значение указанного поля термина или false, если термин не найден
Возможные значения:
• Строка с значением поля при успешном выполнении
• false, если термин не найден
Примеры использования
Базовый пример получения имени термина с ID 123 в таксономии ‘category’
$term_name = get_term_field('name', 123, 'category');
// Вывод имени термина
echo $term_name;
Имя термина будет выведено
Получение описания термина с ID 456 в таксономии ‘post_tag’
$term_description = get_term_field('description', 456, 'post_tag');
// Вывод описания термина
echo $term_description;
Описание термина будет выведено
Безопасность
Валидация входных данных: Функция проверяет существование термина и валидность параметров
Санитизация: Входные параметры очищаются и проверяются WordPress
Рекомендации: При выводе данных используйте esc_html() для значений полей термина
— Связанные функции
Получает объект термина по ID
Получает массив терминов по заданным параметрам
— Хуки
Фильтрует значение поля термина перед его возвращением
— Примечания
– Ограничения
Функция работает только с существующими терминами
– Частые проблемы
- Возвращает false, если термин не найден или поле не существует
