Как настроить и использовать Advanced Custom Fields

Advanced Custom Fields добавляет удобные формы для произвольных полей WordPress. На примере блога о беге вы создадите группу из 6 полей, настроите условную логику и выведете данные через PHP, шорткод и Elementor Pro. Запросы «произвольные поля в WordPress» и «custom fields в WordPress» здесь означают одну задачу: хранить структурированные данные записи отдельно от основного текста.

Что такое произвольные поля в WordPress?

Произвольные поля WordPress хранят дополнительную информацию отдельно от текста записи. Английское название таких данных – custom fields в WordPress.

Каждое поле связывает имя со значением. Поле distance хранит число 5, а шаблон добавляет к нему подпись «Расстояние» и единицу измерения «км».

Когда использовать произвольные поля?

Используйте поля, когда записи повторяют одну структуру. Редактору удобнее заполнить отдельные строки, чем каждый раз собирать одинаковый блок вручную.

  • Для мероприятия создайте поля места, даты и стоимости билета.
  • Для карточки сотрудника храните должность и контакты отдельно.
  • Для отчета о пробежке добавьте расстояние и время тренировки.

Шаблон задает единое оформление для всех заполненных записей.

Изменение шаблона обновит их представление без ручной правки каждого текста.

Встроенные произвольные поля WordPress

WordPress умеет сохранять метаданные без ACF. В блочном редакторе откройте «Параметры» (⋮) → «Настройки» → «Панели» → «Произвольные поля». Включите панель и перезагрузите редактор, если он предложит это сделать.

Для этой инструкции встроенная панель не нужна.

ACF добавляет формы с числами, переключателями и календарями. Поля из примера вы заполните именно в такой форме.

Advanced Custom Fields упрощает дело

ACF связывает форму ввода с правилами ее расположения. Вы выбираете тип поля, задаете ограничения и определяете подходящие записи. Бесплатного ACF хватит для переключателя и 5 полей тренировки, а повторитель потребует Pro.

Как установить оригинальный ACF

Скачайте оригинальный ACF с официального сайта плагина. Secure Custom Fields, или SCF, – отдельный плагин-форк в каталоге WordPress. Для этой инструкции используйте Advanced Custom Fields.

  1. Откройте официальный сайт ACF и нажмите «Download». Загрузка сохранит установочный пакет плагина на компьютере.
  2. Войдите в административную панель WordPress под учетной записью администратора.
  3. В адресе открытой панели замените часть после /wp-admin/ на plugin-install.php?tab=upload. Нажмите Enter и откройте экран загрузки плагина.
  4. Выберите скачанный ZIP-файл. В форме появится имя архива.
  5. Запустите установку кнопкой рядом с выбранным файлом. WordPress покажет результат и ссылку активации.
  6. Активируйте Advanced Custom Fields. В боковом меню появится раздел ACF.

Прямой адрес сохраняет путь к вашему WordPress, включая подпапку сайта. Если экран запрещает установку, войдите под учетной записью с правом устанавливать плагины. В сети WordPress Multisite установкой управляет администратор сети.

Не устанавливайте ACF и SCF одновременно для одного набора полей. Перед заменой плагина сохраните резервную копию и работайте на тестовой копии сайта.

Возможности Advanced Custom Fields Pro

Free подходит для обычных полей и условной логики. Pro выбирайте для повторяющихся строк, гибких макетов, галерей и общих настроек сайта.

ВозможностьACF FreeACF Pro
Текст, числа, переключатели, дата и времяЕстьЕсть
Группы полей и условная логикаЕстьЕсть
Типы записей и таксономииЕсть с ACF 6.1Есть
Repeater – повторяющиеся строкиНетЕсть
Flexible Content – наборы макетовНетЕсть
Gallery – галерея изображенийНетЕсть
Clone – повторное использование настроек полейНетЕсть
ACF BlocksНетЕсть
Страницы опцийНетЕсть

Регистрация типов записей и таксономий доступна в бесплатной версии ACF начиная с 6.1.

Clone повторно использует определения полей, а страница опций хранит общие данные сайта.

Возможности ACF Pro описаны на официальной странице продукта.

Как установить ACF Pro и активировать лицензию

  1. Скачайте ZIP-архив ACF Pro из своего аккаунта на официальном сайте.
  2. Если бесплатный ACF уже активен, отключите его в списке установленных плагинов. Группы полей и значения удалять не нужно.
  3. Откройте экран загрузки плагина по адресу plugin-install.php?tab=upload после части /wp-admin/ в адресе панели.
  4. Выберите ZIP-архив ACF Pro и запустите установку. WordPress покажет сообщение о завершении.
  5. Активируйте ACF Pro.
  6. Раскройте раздел ACF в боковом меню административной панели. Перейдите к настройкам лицензии ACF Pro: нужный экран содержит поле лицензионного ключа и кнопку его активации.
  7. Вставьте ключ из аккаунта ACF и нажмите кнопку активации лицензии. После успешной активации страница покажет активный статус лицензии.

Откройте существующую группу полей. Среди доступных типов появится Repeater. Если Pro не активировался, отключите его и включите бесплатный ACF; поля Pro перестанут обслуживаться до повторной активации.

Как добавлять произвольные поля с помощью Advanced Custom Fields

Создайте группу «Информация о пробежке» для обычных записей блога. Переключатель скроет характеристики тренировки в записях о путешествиях. В группе будет 6 полей: переключатель и 5 характеристик.

1. Создание новой группы произвольных полей

Группа полей объединяет несколько полей и показывает их в одном месте редактора.

  1. Откройте «ACF» → «Группы полей» → «Добавить новую». Откроется экран создания группы.
  2. Введите название группы Информация о пробежке.
  3. В правилах расположения выберите тип записи, равный обычной записи блога: Post.

После сохранения группа появится в редакторе обычных записей. Правило расположения определяет место формы в административной панели и не добавляет блок на публичную страницу.

2. Добавьте произвольные поля

Создавайте поля кнопкой внутри группы. Подпись видит редактор, а имя использует PHP-код. Задавайте имена латиницей, без пробелов: код должен точно совпадать с именами полей.

ПодписьИмяТипНастройки
Этот пост о беге?is_runningTrue / FalseПо умолчанию выключено
ЦельpurposeRadio ButtonВозвращать значение, а не массив
РасстояниеdistanceNumberМинимум 0, шаг 0,1, дополнение «км»
Время началаstart_timeDate Time PickerВозврат: d.m.Y H:i
Время окончанияfinish_timeDate Time PickerВозврат: d.m.Y H:i
МестоlocationTextТекстовая строка

Для поля «Цель» введите варианты с новой строки:

speed : Скоростной бег
training : Тренировочный бег

Слева от двоеточия стоит сохраняемое значение, справа – подпись редактору. Поля даты возвращают строку d.m.Y H:i, поэтому PHP получает предсказуемый формат.

3. Настройте параметры и опубликуйте

Сохраните группу и оставьте ее активной. Убедитесь, что правило относится к обычным записям. Если группа не появилась, откройте запись, а не страницу: правило Post не показывает форму в редакторе страниц.

4. Добавьте данные в редакторе WordPress

  1. Создайте обычную запись с названием Утренняя пробежка. В редакторе появится группа «Информация о пробежке».
  2. Включите переключатель «Этот пост о беге?».
  3. Заполните поля тренировки: для расстояния введите 5, для места – Городской парк.
  4. Сохраните запись и откройте ее повторно. Введенные значения останутся в форме.

Значения ACF сохраняются вместе с метаданными записи в базе данных WordPress.

Обзор условной логики

Условная логика управляет видимостью полей внутри формы редактора. Для записи о путешествии выключите переключатель is_running.

  1. Откройте группу «Информация о пробежке» через «ACF» → «Группы полей».
  2. Откройте настройки поля purpose и включите условную логику.
  3. Задайте условие показа: поле «Этот пост о беге?» включено.
  4. Повторите условие для distance, start_time, finish_time и location.
  5. Сохраните группу и снова откройте редактор записи. При включенном переключателе появятся 5 полей.

Скрытие поля не заменяет проверку при публичном выводе.

Старые значения могут остаться в базе, поэтому PHP-шаблон тоже проверяет is_running.

Как отображать произвольные поля на сайте

ACF сохраняет значения, но место публичного вывода выбираете вы. PHP подходит для общего блока, шорткод – для простого значения внутри текста, а Elementor Pro – для визуального шаблона записи.

СпособКогда подходитОграничение
PHP в темеЕдиный блок во всех подходящих записяхНужно редактировать код темы
Шорткод ACFОтдельное простое значение в текстеНужно включить; сложные структуры не выводятся
Elementor ProВизуальный шаблон записиНужна платная версия конструктора

Как добавить произвольные поля в файлы шаблона темы

Этот пример подходит для классической PHP-темы. HTML-шаблон блочной темы не выполняет вставленный PHP-код.

Перед изменениями сохраните копию файла. Используйте дочернюю тему, чтобы обновление родительской темы не стерло правки. Откройте шаблон отдельной записи, обычно single.php, и найдите вывод the_content() внутри цикла WordPress.

Вставьте код перед the_content(), если блок нужен над текстом:

<?php
if ( function_exists('get_field') && get_field('is_running') ) {
    $purpose_labels = array(
        'speed'    => 'Скоростной бег',
        'training' => 'Тренировочный бег',
    );
    $purpose = get_field('purpose');
    $rows = array(
        'Цель'             => $purpose_labels[$purpose] ?? '',
        'Расстояние, км'   => get_field('distance'),
        'Время начала'     => get_field('start_time'),
        'Время окончания'  => get_field('finish_time'),
        'Место'            => get_field('location'),
    );
    $filled_rows = array_filter($rows, static function ($value) {
        return is_scalar($value)
            && $value !== false
            && (string) $value !== '';
    });

    if ($filled_rows) {
        echo '<div class="run-information"><ul>';
        foreach ($filled_rows as $label => $value) {
            echo '<li><strong>' . esc_html($label) . ':</strong> ';
            echo esc_html((string) $value) . '</li>';
        }
        echo '</ul></div>';
    }
}
?>

Внешняя проверка is_running скрывает весь блок в записи о путешествии. Проверка заполненности сохраняет числовой ноль и убирает пустые строки.

Функция get_field() получает значение для дальнейшей обработки. Функция the_field() сразу печатает результат.

Для условий, преобразований и проверки пустого значения используйте get_field().

Экранируйте результат с учетом места вставки: для текста используйте esc_html(), для атрибута – esc_attr(), для URL – esc_url(). Разрешенную HTML-разметку обрабатывайте через wp_kses_post().

Тип и формат возврата определяют дальнейшую обработку. Для изображения выберите возврат ID и передайте его в wp_get_attachment_image(); массив изображения нельзя печатать как текст.

Как отображать данные произвольных полей с помощью шорткода

В новых установках ACF начиная с 6.3 шорткод [acf] выключен по умолчанию. Чтобы включить его, добавьте код в functions.php дочерней темы:

add_action('acf/init', function () {
    acf_update_setting('enable_shortcode', true);
});

Вставляйте сниппет внутри PHP-блока файла, без повторного открывающего тега.

После сохранения файла вставьте в текст записи:

Место тренировки: [acf field="location"]

На публичной странице появится значение «Городской парк». Шорткод подходит для простых текстовых и числовых полей. Он не выводит Repeater, Flexible Content и другие сложные структуры.

Страница записи с полями, выведенными шорткодами: цель, расстояние, время и место пробежки

Условная логика редактора не управляет публичным выводом шорткода. Для блока, который должен исчезать при выключенном is_running, используйте PHP-проверку.

Подробности синтаксиса описывает документация шорткода ACF.

Чтобы отключить шорткод, удалите добавленный обработчик из functions.php и сами шорткоды из текста записей.

Как отображать произвольные поля с помощью Elementor Pro

Elementor Pro вставляет значения ACF через динамические теги. Выберите этот способ, если шаблоны записей уже собираются в конструкторе.

  1. Откройте конструктор шаблонов темы Elementor Pro.
  2. Создайте шаблон отдельной записи типа «Single Post». Откроется редактор шаблона записи.
  3. Задайте запись «Утренняя пробежка» для предпросмотра. Конструктор получит ее заполненные поля.
  4. Добавьте виджеты заголовка и основного содержимого записи.
  5. Добавьте текстовый виджет и откройте список динамических тегов его текстового параметра.
  6. Выберите динамический тег для поля ACF и укажите location. В виджете появится «Городской парк».
  7. Опубликуйте шаблон и задайте условия показа для нужных записей.

Если конструктор шаблонов или тег ACF недоступен, используйте PHP-шаблон классической темы с get_field(). Для отдельной строки в тексте подойдет включенный шорткод [acf field="location"].

Подключайте расстояние и даты к подходящим параметрам виджетов. Единицы измерения задавайте отдельно от сохраняемого числа.

Условная логика ACF не скрывает контейнер Elementor автоматически. Если видимость зависит от is_running, используйте PHP-проверку или задайте условия показа шаблона по подходящей рубрике.

Как вывести Repeater в ACF Pro

Repeater хранит несколько строк с одинаковым набором вложенных полей. Например, одна тренировка может включать несколько отрезков разной длины.

  1. В группе тренировки создайте поле Repeater с именем run_segments.
  2. Внутри добавьте текстовое поле segment_name с подписью «Отрезок».
  3. Добавьте числовое подполе segment_distance с подписью «Расстояние, км».
  4. Сохраните группу и заполните строки повторителя в записи о пробежке. В записи появятся введенные строки.

Для вывода вставьте код в PHP-шаблон внутри цикла WordPress:

<?php if (
    function_exists('have_rows')
    && get_field('is_running')
    && have_rows('run_segments')
) : ?>
    <ul class="run-segments">
        <?php while (have_rows('run_segments')) : the_row();
            $name = get_sub_field('segment_name');
            $distance = get_sub_field('segment_distance');
            $has_name = is_string($name) && $name !== '';
            $has_distance = is_numeric($distance);
            if (!$has_name && !$has_distance) {
                continue;
            }
        ?>
            <li>
                <?php
                if ($has_name) {
                    echo esc_html($name);
                }
                if ($has_name && $has_distance) {
                    echo ': ';
                }
                if ($has_distance) {
                    echo esc_html((string) $distance) . ' км';
                }
                ?>
            </li>
        <?php endwhile; ?>
    </ul>
<?php endif; ?>

have_rows() проверяет наличие строки. the_row() переключает текущую строку, а get_sub_field() получает значение вложенного поля. Документация описывает вывод поля Repeater.

Какой способ вывода полей выбрать

Для общего блока характеристик используйте PHP с get_field(). Этот способ проверяет переключатель, убирает пустые подписи и обрабатывает значения.

Для одной строки внутри текста подойдет включенный шорткод. Если сайт уже использует Elementor Pro, подключайте поля динамическими тегами. Повторяющиеся структуры выводите циклом Repeater в PHP.

Совет от нашей редакции: проверьте шаблон на заполненной записи и на записи с выключенным «Этот пост о беге?». Так вы увидите и данные, и отсутствие пустого блока.

Комментарии

Оставьте свой комментарий
Е
Елена

не выводятся произвольные поля, если они в группе. Кто-то знает почему? Поля из группы как-то иначе нужно выводить?

Андрей М.

Да, там простого the_field недостаточно, что-то вроде the_group или the_group_fields, как то так должно быть.