the_field()

the_field($selector, $post_id, $format_value);
the_field(); // Для тих, хто любить копіювати в такому форматі

Опис

Виводить значення певного ACF поля на екран. Щоб функція працювала потрібен плагін ACF.

Функція ідентична до echo get_field();.

Parameters

• $selector: (string) Required
  Назва або ключ поля
• $post_id: (int | wp_post) Optional
  ID поста, в якому збережені дані
  Default Value: Поточний пост
• $format_value: (bool) Optional
  Форматувати чи не форматувати дані
  Default Value: true

Приклади

Вивести дані з поточного поста

Цей приклад показує як вивести значення поля “text_field”, на сторінці поста, де ці дані збережені.

<h2><?php the_field('text_field'); ?></h2>

Вивести дані з певного поста

Цей приклад показує як вивести значення поля “text_field”, яке збережене в пості з ID 55. Якщо вивести в загальному шаблоні, то на кожній сторінці де такий шаблон використовується буде одне й те ж саме значення

<h2><?php the_field('text_field','55'); ?></h2>

Перевірити чи дані існують

Перш ніж показувати дані, краще перевірити чи вони існують щоб не було помилок або пустих місць чи інших проблем. Це той спосіб, який я рекомендую використовувати завжди, якщо поле не обовʼязкове

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

Що може бути $post_id

Цей приклад показує скільки всього різного може бути коректним аргументом $post_id для цієї функції

<?php

$post_id = false;           // поточний пост
$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 );

Нотатки

До ACF 5.11 можна було використовувати the_field() для відображення значень параметрів або мета для елементів, не пов’язаних із полями ACF. Це мало наслідки для безпеки, оскільки параметри сайту могли бути розкриті. the_field() також може відображати значення полів, які більше не зареєстровані в ACF.

Це було оновлено в ACF 5.11, див. Оновлення функцій поля ACF у ресурсі 5.11 для отримання додаткової інформації.