Обзор
Выводит на экран значение конкретного поля.
Интуитивное и мощное (как и сам ACF), это поле позволяет получить значение любого поля в любом месте вашего шаблона. Эта функция ни что иное как echo get_field( … );
Параметры
the_field($selector, [$post_id], [$format_value]);
- $selector (строка) (обязательное) Имя поля или ключ поля
- $post_id (смешанный) (необязательное) ID поста для которого сохранено поле. По умолчанию текущий пост
- $format_value (логический) (необязательное) Следует ли применять логику форматирования. По умолчанию true.
Использование
Вывод значения текущего поста
Пример показывает, как вывести значение «текстового» поля из текущего поста.
<h2><?php the_field('text_field'); ?></h2>
Вывод значения из конкретного поста
Пример показывает, как вывести значение «текстового» поля из поста с ID = 123.
<h2><?php the_field('text_field', 123); ?></h2>
Проверка на существование значения
Пример показывает, как проверить существование значения до его вывода на экран.
<?php if( get_field('text_field') ): ?>
<h2><?php the_field('text_field'); ?></h2>
<?php endif; ?>
Получение значения из различных объектов
$post_id = false; // текущий пост
$post_id = 1; // пост с ID = 1
$post_id = "option"; // страница с опциями
$post_id = "options"; // тоже, что и выше
$post_id = "category_2"; // рубрика с ID = 2
$post_id = "event_3"; // event (произвольная таксономия) с ID = 3
$post_id = "user_1"; // пользователь с ID = 1
the_field( "text_field", $post_id );
Похожие
- Функции: get_field()