the_field() │ ACF 1.0.3

Виводить на екран значення вказаного поля (метаполя).

Ця потужна функція може бути використана для виведення значення будь-якого поля в будь-якому місці.

Це обгортка для функції 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

Приклади

2

#1 Виведення значення з поточного посту

Приклад показує як виїсти значення поля text_field з поточного посту.

<?php the_field( 'text_field' ); ?>
0

#2 Виведення значення з певного посту

Приклад показує, як виїсти значення поля “text_field” з поста ID = 123.

<?php the_field( 'text_field', 123); ?>
0

#3 Перевірка значення існування

Приклад показує попередню перевірку значення існування (установку) до виведення значення.

<?php if( get_field('text_field') ): ?>
	<h2><?php the_field('text_field'); ?></h2>
<?php endif; ?>
0

#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() ACF 5.10.2

acf/includes/api/api-template.php 
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;

}

ACF