# get_term_field()

URL: https://chugunov.pro/api-wordpress/functions/get_term_field/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 2.3.0.

## Сигнатура

```php
get_term_field( string $field, int|WP_Term $term, string $taxonomy = '', string $context = 'display' ): string|int|null|WP_Error
```

## Описание

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

## Параметры

- `$field` `string` — обязательный. Поле термина для получения.
- `$term` `int|WP_Term` — обязательный. ID или объект термина.
- `$taxonomy` `string` — необязательный, по умолчанию `''`. Имя таксономии.
- `$context` `string` — необязательный, по умолчанию `'display'`. Как очищать поля термина. Доступные варианты см. в sanitize_term_field().
  
  Значение по умолчанию 'display'.

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

`string|int|null|WP_Error`

## Исходный код

Файл: `wp-includes/taxonomy.php:1221`

```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 );
}
```

## История изменений

- 4.4.0 — The $taxonomy parameter was made optional. $term can also now accept a WP_Term object.
- 2.3.0 — Introduced.

## Связанные

Использует: [`sanitize_term_field`](https://chugunov.pro/api-wordpress/functions/sanitize_term_field/), [`get_term`](https://chugunov.pro/api-wordpress/functions/get_term/), [`is_wp_error`](https://chugunov.pro/api-wordpress/functions/is_wp_error/).
Используется в: `WP_REST_Menu_Items_Controller::prepare_links`, `WP_REST_Menu_Items_Controller::prepare_item_for_database`, `WP_Customize_Nav_Menu_Item_Setting::get_original_title`, [`term_description`](https://chugunov.pro/api-wordpress/functions/term_description/), [`wp_setup_nav_menu_item`](https://chugunov.pro/api-wordpress/functions/wp_setup_nav_menu_item/), [`wp_update_nav_menu_item`](https://chugunov.pro/api-wordpress/functions/wp_update_nav_menu_item/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_term_field/