Как настроить и использовать 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.
- Откройте официальный сайт ACF и нажмите «Download». Загрузка сохранит установочный пакет плагина на компьютере.
- Войдите в административную панель WordPress под учетной записью администратора.
- В адресе открытой панели замените часть после
/wp-admin/наplugin-install.php?tab=upload. Нажмите Enter и откройте экран загрузки плагина. - Выберите скачанный ZIP-файл. В форме появится имя архива.
- Запустите установку кнопкой рядом с выбранным файлом. WordPress покажет результат и ссылку активации.
- Активируйте Advanced Custom Fields. В боковом меню появится раздел ACF.
Прямой адрес сохраняет путь к вашему WordPress, включая подпапку сайта. Если экран запрещает установку, войдите под учетной записью с правом устанавливать плагины. В сети WordPress Multisite установкой управляет администратор сети.
Не устанавливайте ACF и SCF одновременно для одного набора полей. Перед заменой плагина сохраните резервную копию и работайте на тестовой копии сайта.
Возможности Advanced Custom Fields Pro
Free подходит для обычных полей и условной логики. Pro выбирайте для повторяющихся строк, гибких макетов, галерей и общих настроек сайта.
| Возможность | ACF Free | ACF Pro |
|---|---|---|
| Текст, числа, переключатели, дата и время | Есть | Есть |
| Группы полей и условная логика | Есть | Есть |
| Типы записей и таксономии | Есть с ACF 6.1 | Есть |
| Repeater – повторяющиеся строки | Нет | Есть |
| Flexible Content – наборы макетов | Нет | Есть |
| Gallery – галерея изображений | Нет | Есть |
| Clone – повторное использование настроек полей | Нет | Есть |
| ACF Blocks | Нет | Есть |
| Страницы опций | Нет | Есть |
Регистрация типов записей и таксономий доступна в бесплатной версии ACF начиная с 6.1.
Clone повторно использует определения полей, а страница опций хранит общие данные сайта.
Возможности ACF Pro описаны на официальной странице продукта.
Как установить ACF Pro и активировать лицензию
- Скачайте ZIP-архив ACF Pro из своего аккаунта на официальном сайте.
- Если бесплатный ACF уже активен, отключите его в списке установленных плагинов. Группы полей и значения удалять не нужно.
- Откройте экран загрузки плагина по адресу
plugin-install.php?tab=uploadпосле части/wp-admin/в адресе панели. - Выберите ZIP-архив ACF Pro и запустите установку. WordPress покажет сообщение о завершении.
- Активируйте ACF Pro.
- Раскройте раздел ACF в боковом меню административной панели. Перейдите к настройкам лицензии ACF Pro: нужный экран содержит поле лицензионного ключа и кнопку его активации.
- Вставьте ключ из аккаунта ACF и нажмите кнопку активации лицензии. После успешной активации страница покажет активный статус лицензии.
Откройте существующую группу полей. Среди доступных типов появится Repeater. Если Pro не активировался, отключите его и включите бесплатный ACF; поля Pro перестанут обслуживаться до повторной активации.
Как добавлять произвольные поля с помощью Advanced Custom Fields
Создайте группу «Информация о пробежке» для обычных записей блога. Переключатель скроет характеристики тренировки в записях о путешествиях. В группе будет 6 полей: переключатель и 5 характеристик.
1. Создание новой группы произвольных полей
Группа полей объединяет несколько полей и показывает их в одном месте редактора.
- Откройте «ACF» → «Группы полей» → «Добавить новую». Откроется экран создания группы.
- Введите название группы
Информация о пробежке. - В правилах расположения выберите тип записи, равный обычной записи блога:
Post.
После сохранения группа появится в редакторе обычных записей. Правило расположения определяет место формы в административной панели и не добавляет блок на публичную страницу.
2. Добавьте произвольные поля
Создавайте поля кнопкой внутри группы. Подпись видит редактор, а имя использует PHP-код. Задавайте имена латиницей, без пробелов: код должен точно совпадать с именами полей.
| Подпись | Имя | Тип | Настройки |
|---|---|---|---|
| Этот пост о беге? | is_running | True / False | По умолчанию выключено |
| Цель | purpose | Radio Button | Возвращать значение, а не массив |
| Расстояние | distance | Number | Минимум 0, шаг 0,1, дополнение «км» |
| Время начала | start_time | Date Time Picker | Возврат: d.m.Y H:i |
| Время окончания | finish_time | Date Time Picker | Возврат: d.m.Y H:i |
| Место | location | Text | Текстовая строка |
Для поля «Цель» введите варианты с новой строки:
speed : Скоростной бег
training : Тренировочный бегСлева от двоеточия стоит сохраняемое значение, справа – подпись редактору. Поля даты возвращают строку d.m.Y H:i, поэтому PHP получает предсказуемый формат.
3. Настройте параметры и опубликуйте
Сохраните группу и оставьте ее активной. Убедитесь, что правило относится к обычным записям. Если группа не появилась, откройте запись, а не страницу: правило Post не показывает форму в редакторе страниц.
4. Добавьте данные в редакторе WordPress
- Создайте обычную запись с названием
Утренняя пробежка. В редакторе появится группа «Информация о пробежке». - Включите переключатель «Этот пост о беге?».
- Заполните поля тренировки: для расстояния введите
5, для места –Городской парк. - Сохраните запись и откройте ее повторно. Введенные значения останутся в форме.
Значения ACF сохраняются вместе с метаданными записи в базе данных WordPress.
Обзор условной логики
Условная логика управляет видимостью полей внутри формы редактора. Для записи о путешествии выключите переключатель is_running.
- Откройте группу «Информация о пробежке» через «ACF» → «Группы полей».
- Откройте настройки поля
purposeи включите условную логику. - Задайте условие показа: поле «Этот пост о беге?» включено.
- Повторите условие для
distance,start_time,finish_timeиlocation. - Сохраните группу и снова откройте редактор записи. При включенном переключателе появятся 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 через динамические теги. Выберите этот способ, если шаблоны записей уже собираются в конструкторе.
- Откройте конструктор шаблонов темы Elementor Pro.
- Создайте шаблон отдельной записи типа «Single Post». Откроется редактор шаблона записи.
- Задайте запись «Утренняя пробежка» для предпросмотра. Конструктор получит ее заполненные поля.
- Добавьте виджеты заголовка и основного содержимого записи.
- Добавьте текстовый виджет и откройте список динамических тегов его текстового параметра.
- Выберите динамический тег для поля ACF и укажите
location. В виджете появится «Городской парк». - Опубликуйте шаблон и задайте условия показа для нужных записей.
Если конструктор шаблонов или тег ACF недоступен, используйте PHP-шаблон классической темы с get_field(). Для отдельной строки в тексте подойдет включенный шорткод [acf field="location"].
Подключайте расстояние и даты к подходящим параметрам виджетов. Единицы измерения задавайте отдельно от сохраняемого числа.
Условная логика ACF не скрывает контейнер Elementor автоматически. Если видимость зависит от is_running, используйте PHP-проверку или задайте условия показа шаблона по подходящей рубрике.
Как вывести Repeater в ACF Pro
Repeater хранит несколько строк с одинаковым набором вложенных полей. Например, одна тренировка может включать несколько отрезков разной длины.
- В группе тренировки создайте поле Repeater с именем
run_segments. - Внутри добавьте текстовое поле
segment_nameс подписью «Отрезок». - Добавьте числовое подполе
segment_distanceс подписью «Расстояние, км». - Сохраните группу и заполните строки повторителя в записи о пробежке. В записи появятся введенные строки.
Для вывода вставьте код в 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.
Совет от нашей редакции: проверьте шаблон на заполненной записи и на записи с выключенным «Этот пост о беге?». Так вы увидите и данные, и отсутствие пустого блока.
Популярное за неделю
- Как создать сайт самому в 2026: 4 способа + пошаговая инструкция 34 мин чтения
- Лучшие конструкторы для создания сайтов — плюсы, минусы и сравнения 22 мин чтения
- Как правильно редактировать шаблоны WordPress 4 мин чтения
- Как отредактировать главную страницу WordPress 11 мин чтения
- Как увеличить размер файла в WordPress 12 мин чтения
- Как настроить SMTP в WordPress: проверка и установка 2 мин чтения
Комментарии
не выводятся произвольные поля, если они в группе. Кто-то знает почему? Поля из группы как-то иначе нужно выводить?
Да, там простого the_field недостаточно, что-то вроде the_group или the_group_fields, как то так должно быть.