the_field()
Выводит на экран значение указанного поля (метаполя).
Эта мощная функция может использоваться для вывода значения любого поля в любом месте.
Это обёртка для функции get_field().
Работает на основе: get_field()
Хуков нет.
Возвращает
null. Выводит данные на экран.
Использование
the_field( $selector, $post_id, $format_value );
- $selector(string) (обязательный)
- Имя поля (параметр name) или ключ (id).
- $post_id(число/object)
- ID поста, в котором хранится значение.
По умолчанию: текущий пост - $format_value(true/false)
- Применять ли логику форматирования.
По умолчанию: true
Примеры
#1 Вывод значения из текущего поста
Пример показывает как выести значение поля “text_field” из текущего поста.
<?php the_field( 'text_field' ); ?>
#2 Вывод значения из определенного поста
Пример показывает как выести значение поля “text_field” из поста ID = 123.
<?php the_field( 'text_field', 123 ); ?>
#3 Проверка значения на существование
Пример показывает предварительную проверку значения на существование (установку) до выведения значения.
<?php if( get_field('text_field') ): ?>
<h2><?php the_field('text_field'); ?></h2>
<?php endif; ?> #4 Получение значений из различных объектов
В этом примере показано множество допустимых значений $post_id, указывающих, где сохранено значение.
$post_id = false; // current post $post_id = 123; // post ID = 123 $post_id = "user_123"; // user ID = 123 $post_id = "term_123"; // term ID = 123 $post_id = "category_123"; // same as above $post_id = "option"; // options page $post_id = "options"; // same as above the_field( 'my_field', $post_id );
Список изменений
| С версии 1.0.3 | Введена. |
Код the_field() the field ACF 6.0.4
function the_field( $selector, $post_id = false, $format_value = true ) {
$value = get_field( $selector, $post_id, $format_value );
if ( is_array( $value ) ) {
$value = implode( ', ', $value );
}
echo $value;
} 