WordPress как на ладони
wordpress jino

get_term_field() WP 2.3

Получает поле термина. Поле очищается функцией sanitize_term_field().

Поле проверяется на наличие перед получением. Функция создана для удобства использования в контексте.

Используется в: term_description().
Работает на основе: sanitize_term_field()

Хуков нет.

Возвращает

пустую строку, если $term не объект или если поле ($field) не найдено у термина ($term).

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

get_term_field( $field, $term, $taxonomy, $context );
$field(строка) (обязательный)
Поле термина, которое нужно получить.
По умолчанию: нет
$term(число/объект) (обязательный)
ID термина. С версии 4.4. можно передавать объект WP_Term.
По умолчанию: нет
$taxonomy(строка)
Название таксономии. С версии 4.4. параметр стал не обязательным.
По умолчанию: нет
$context(строка) (обязательный)

Тип фильтрации. Одно из значений:

  • raw - просто вернет значение
  • edit - фильтр esc_html() если это поле description, и фильтр esc_attr() если другое поле.
  • db
  • slug
  • rss
  • attribute - фильтр esc_attr()
  • js - фильтр esc_js()

По умолчанию: 'display'

Примеры

#1. Выведем описание рубрики 34 (устанавливается в админке при создании/изменении рубрики). Если описания нет, выведем надпись "описание термина не найдено".

$description = get_term_field( 'description', 34, 'category' );  
if( is_wp_error( $description ) )
	 echo 'описание термина не найдено';
else 
	 echo $description;

Код get term field: wp-includes/taxonomy.php VER 4.9.1

<?php
function get_term_field( $field, $term, $taxonomy = '', $context = 'display' ) {
	$term = get_term( $term, $taxonomy );
	if ( is_wp_error($term) )
		return $term;

	if ( !is_object($term) )
		return '';

	if ( !isset($term->$field) )
		return '';

	return sanitize_term_field( $field, $term->$field, $term->term_id, $term->taxonomy, $context );
}

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

Из метки: term (термины таксономий)

Еще из раздела: Любые таксономии

get_term_field Комментариев нет

Здравствуйте, !

Ваш комментарий