Описание
Возвращает массив значений полей (имя => значение) для конкретной записи.
Параметры
get_fields([$post_id = false], [$format_value = true], [$escape_html = false]);
$post_id(mixed) (необязательно) ID записи, в которой сохранено значение. По умолчанию используется значение false, то есть текущая запись.$format_value(bool) (необязательно) Применять ли форматирование. По умолчанию — true.$escape_html(bool) (необязательно) Начиная с версии 6.2.6 — возвращать экранированную HTML-безопасную версию значения поля. Для этого параметр $format_value должен иметь значение true. По умолчанию — false.
Возвращаемое значение
(array|false) Массив значений или false, если поля не найдены.
Примеры
Получение значений из текущей записи
В этом примере показано, как вывести все поля (имя и значение) текущей записи в виде списка.
<?php
$fields = get_fields();
if( $fields ): ?>
<ul>
<?php foreach( $fields as $name => $value ): ?>
<li><b><?php echo $name; ?></b> <?php echo $value; ?></li>
<?php endforeach; ?>
</ul>
<?php endif; ?>
Получение значений из конкретной записи
В этом примере показано, как загрузить все поля (имя и значение) из разных объектов данных.
// Получить значения из текущей записи.
$fields = get_fields();
// Получить значения из записи с ID = 1.
$post_fields = get_fields( 1 );
// Получить значения из пользователя с ID = 2.
$user_fields = get_fields( 'user_2' );
// Получить значения из категории с ID = 3.
$term_fields = get_fields( 'term_3' );
// ... или используя имя таксономии.
$term_fields = get_fields( 'category_3' );
// Получить значения из комментария с ID = 4.
$comment_fields = get_fields( 'comment_4' );
// Получить значения со страницы опций ACF.
$option_fields = get_fields( 'options' );
// ... или используя 'option'.
$option_fields = get_fields( 'option' );
Получение значений без форматирования
В этом примере показано, как загрузить все поля (имя и значение) без применения форматирования.
Форматирование определяет, как изменяются значения после загрузки из базы данных. Например, значение поля изображения сохраняется в базе данных только как ID вложения, но может возвращаться в виде URL в зависимости от настроек поля.
В некоторых случаях может потребоваться убедиться, что возвращается только исходное значение независимо от настроек поля. Для этого используется параметр $format_value.
$fields = get_fields( 123, false );
Обновлено: 30.09.2026