Плагин ACF позволяет значительно расширить возможности стандартных полей в WordPress. С его помощью вы сможете создавать группы полей, добавлять текстовые, медиа-, повторяющиеся и другие типы полей, а затем отображать введённые данные на фронтенде сайта. ACF особенно полезен, когда тема или сайт требуют специфичной структуры контента.
В этой статье мы пошагово рассмотрим, как установить плагин, создать группу полей, прикрепить её к нужному месту, вывести данные в шаблоне и применить продвинутые функции.
Установка и настройка
-
В административной панели WordPress перейдите в Плагины → Добавить новый и найдите «Advanced Custom Fields».
-
Установите и активируйте плагин. После активации в меню появится пункт Custom Fields или ACF.
-
(Опционально) Если вам нужны более продвинутые функции — такие как Repeater-поля, Flexible Content, Options Page — рассмотрите возможность перехода на ACF Pro.
С установкой покончено — теперь можно двигаться дальше и создавать свои первые группы полей.
Создание группы полей
-
В меню плагина нажмите «Добавить новую» (Add New) – создаётся новая группа полей.
-
Дайте название группе — например «Дополнительные данные статьи».
-
В блоке Местоположение (Location) задайте правила, где именно будет отображаться эта группа: например, «Тип записи — Страница» или «Категория — Новости». Это определяет, на каких страницах/типах записей редактор увидит эти поля.
-
Внутри группы добавьте нужное количество полей, нажав «Добавить поле» (Add Field). Для каждого поля нужно указать:
-
Метка поля (Field Label) — как его будут видеть редакторы.
-
Имя поля (Field Name) — автоматически генерируется, будет использоваться в шаблоне.
-
Тип поля (Field Type) — например, Text, Image, Repeater, Select, и др.
-
Дополнительные настройки: значение по умолчанию, необязательность, условия отображения и др.
-
Сохраните группу. Теперь на страницах, отвечающих правилам местоположения, появится набор дополнительных полей.
-
Присвоение полей записи и заполнение
Теперь, когда группа полей связана с нужными страницами/записями, при редактировании этих элементов вы увидите новые поля.
Редактор просто заполняет их как обычные поля: вводит текст, выбирает изображение, добавляет строки в повторяющемся поле и т.д.
Важно: если настроено условие отображения (Conditional Logic), некоторые поля могут отображаться только при выполнении определённых условий — это позволяет сделать интерфейс максимально удобным для пользователя.
Данные сохраняются вместе с записью и доступны через API вашего шаблона.
Вывод данных на фронтенде
Чтобы вывести значения, нужно немного PHP-кода в шаблоне темы. Пример простого вывода:
<?php
if( function_exists(‘get_field’) ) {
$my_value = get_field(‘имя_поля’);
if( $my_value ) {
echo esc_html($my_value);
}
}
?>
Если поле — изображение или массив, можно работать с get_field() и the_field().
Для изображений:
<?php
$image = get_field(‘banner_image’);
if( $image ) {
echo ‘<img src=»‘. esc_url($image[‘url’]) .'» alt=»‘. esc_attr($image[‘alt’]) .'» />’;
}
?>
Для повторяющихся полей:
<?php if( have_rows(‘repeater_field_name’) ): ?>
<ul>
<?php while( have_rows(‘repeater_field_name’) ): the_row();
$sub = get_sub_field(‘sub_field_name’);
?>
<li><?php echo esc_html($sub); ?></li>
<?php endwhile; ?>
</ul>
<?php endif; ?>
Такой подход позволяет интегрировать кастомные поля в шаблон любой темы и вывести данные гибко.
Практические сценарии применения
-
Дополнительные данные записей: рейтинги, авторы, даты, изображения, галереи — всё это можно вынести в отдельные поля.
-
Страницы-лендинги: создайте группу полей для конкретной страницы (например «Главная») с набором блоков: заголовок, подзаголовок, фон, призыв к действию — и редактор может заполнять без правки шаблона.
-
Кастомные типы записей (CPT): если сайт имеет типы «Отзывы», «Экскурсии», «Сотрудники» и др., можно добавлять поля, специфичные именно для них.
-
Фронтенд-редактирование: с дополнениями можно позволять пользователям добавлять или редактировать записи через форму на фронтенде, используя ACF и сопутствующие плагины.
Продвинутые возможности
-
Flexible Content: позволяет создавать составные блоки — например, секция с изображением-ссылкой, блок цитаты, список услуг.
-
Options Page: добавляет страницу в админ-панели, где можно задать глобальные настройки сайта: логотип, контактные данные, соцсети.
-
ACF Blocks: если тема поддерживает Гутенберг-блоки, можно регистрировать блоки через ACF и при редактировании страницы использовать эти блоки как обычные. Это мощно для сайтов с кастомной структурой.
-
Условная логика (Conditional Logic): позволяет показывать/скрывать поля в зависимости от выбора.
-
Повторяющиеся поля (Repeater) и Галерея (Gallery): дают возможность создавать массивы данных без необходимости вручную прописывать шаблон.
Используя эти функции, вы делаете систему редактирования контента более гибкой и готовой к потребностям клиента.
Лучшие практики и советы
-
Названия полей лучше делать англоязычными и без пробелов — это упрощает использование в коде.
-
Не забывайте об экранировании вывода (например
esc_html,esc_url,wp_kses) — это важно для безопасности. -
Если тема уже имеет собственную реализацию полей или использует ACF для внутренних элементов, проконсультируйтесь, не нарушите ли вы логику.
-
Для массовых изменений полей на продакшене используйте миграции или экспорты/импорты групп полей.
-
Комбинируйте ACF с настройками шаблона и page-builder-инструментами: таким образом клиент получает редакторский интерфейс без необходимости лезть в код.
Заключение
Плагин ACF — незаменимый инструмент для выстраивания гибкой структуры контента в WordPress. Он помогает структурировать данные, упростить интерфейс для редактора, вывести динамический контент и сократить вмешательство в шаблон. Даже простая версия Free даёт мощный функционал, а Pro-версия раскрывает всё богатство возможностей.
Если вы создаёте сайт с уникальными требованиями к структуре или клиенту хочется простого интерфейса — ACF станет отличным выбором.
