the_field()

Обзор

Выводит на экран значение конкретного поля.

Интуитивное и мощное (как и сам 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 );

Похожие