Описание
Возвращает значение указанного поля.
Интуитивная и мощная (как и сам ACF ?), эта функция позволяет загрузить значение любого поля из любого места. Обратите внимание: каждый тип поля возвращает данные в разном формате (строка, целое число, массив и т. д.).
Перед выводом любые возвращаемые значения следует экранировать с помощью . Параметры get_field($selector, [$post_id = false], [$format_value = true], [$escape_html = false]); $selector (string) (Обязательный) Имя или ключ поля. $post_id (mixed) (Необязательный) ID записи, в которой сохранено значение. По умолчанию false — используется текущая запись. $format_value (bool) (Необязательный) Применять ли логику форматирования. По умолчанию true. $escape_html (bool) (Необязательный) Начиная с версии 6.2.6 — возвращать экранированную и безопасную HTML-версию значения поля. Для этого параметр $format_value должен иметь значение true. По умолчанию false. Возвращаемое значение (mixed) Значение поля. Примеры Получение значения из текущей записи В этом примере показано, как загрузить значение поля ‘text_field’ из текущей записи. $value = get_field( "text_field" ); Получение значения из определённой записи В этом примере показано, как загрузить значение поля ‘text_field’ из записи с ID = 123. $value = get_field( "text_field", 123 ); Проверка существования значения В этом примере показано, как проверить, существует ли значение поля. $value = get_field( "text_field" ); if( $value ) { echo wp_kses_post( $value ); } else { echo 'пусто'; } Получение значения из разных объектов В этом примере показаны различные значения $post_id, которые используются для получения значения из записи, пользователя, термина и настройки. $post_id = false; // текущая запись $post_id = 1; // ID записи = 1 $post_id = "user_2"; // ID пользователя = 2 $post_id = "category_3"; // ID термина категории = 3 $post_id = "event_4"; // ID термина события (пользовательской таксономии) = 4 $post_id = "option"; // страница настроек $post_id = "options"; // то же, что выше $value = get_field( 'my_field', $post_id ); Получение значения без форматирования В этом примере поле “image” является полем изображения и обычно возвращает объект изображения. Однако при передаче false в качестве третьего параметра функции get_field значение не форматируется и возвращается в исходном виде из базы данных. Обратите внимание: второму параметру присвоено значение false, чтобы выбрать текущую запись. $image = get_field('image', false, false); Получение экранированного значения поля (безопасного для HTML) (начиная с ACF 6.2.6) В этом примере поле “wysiwyg” является полем WYSIWYG и возвращает строку, содержащую содержимое поля WYSIWYG. Однако при передаче true в качестве четвёртого параметра мы просим поле убедиться, что значение экранировано. В случае поля WYSIWYG экранирование выполняется до запуска фильтров поля, поэтому шорткоды продолжат работать, но сохранённые в поле