Описание
Возвращает настройки определённого поля.
Каждое поле содержит множество настроек, таких как метка, имя и тип. Эта функция позволяет загрузить эти настройки в виде массива вместе со значением поля.
Параметры
get_field_object($selector, [$post_id = false], [$format_value = true], [$load_value = true], [$escape_html = false]);
$selector(string) (Обязательный) Имя или ключ поля.$post_id(mixed) (Необязательный) ID записи, в которой сохранено значение. По умолчанию — false, используется текущая запись.$format_value(bool) (Необязательный) Применять ли логику форматирования. По умолчанию — true.$load_value(bool) (Необязательный) Загружать ли значение поля. По умолчанию — true.$escape_html(bool) (Необязательный) Начиная с версии 6.2.6 — возвращать экранированную и безопасную HTML-версию значения поля. Требует, чтобы $format_value имел значение true. По умолчанию — false.
Возвращаемое значение
(array) Эта функция возвращает массив примерно следующего вида. Обратите внимание, что каждое поле содержит уникальные настройки.
array(
'ID' => 0,
'key' => '',
'label' => '',
'name' => '',
'prefix' => '',
'type' => 'text',
'value' => null,
'menu_order' => 0,
'instructions' => '',
'required' => 0,
'id' => '',
'class' => '',
'conditional_logic' => 0,
'parent' => 0,
'wrapper' => array(
'width' => '',
'class' => '',
'id' => ''
)
);
Примеры
Вывод метки и значения поля
В этом примере показано, как загрузить поле и вывести его метку и значение.
<?php
$field = get_field_object('my_field');
?>
<p><?php echo $field['label']; ?>: <?php echo $field['value']; ?></p>
Вывод метки и значения поля из определённой записи
В этом примере показано, как загрузить поле и вывести его метку и значение из записи с ID = 123.
<?php
$field = get_field_object('my_field', 123);
?>
<p><?php echo $field['label']; ?>: <?php echo $field['value']; ?></p>
Получение поля с использованием его ключа
В некоторых случаях может потребоваться загрузить поле по его ключу, например если значение ещё не было сохранено. В этом примере показано, как загрузить поле с использованием его ключа.
<?php
$field = get_field_object('field_123456');
?>
Вывод данных, специфичных для типа поля
Некоторые типы полей хранят дополнительные данные, например поле Select. В этом примере показано, как перебрать варианты поля Select и вывести их в виде списка.
<?php
$field = get_field_object('my_select');
if( $field['choices'] ): ?>
<ul>
<?php foreach( $field['choices'] as $value => $label ): ?>
<li><?php echo $label; ?></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
Обновлено: 30.09.2026