Настройка кастомных полей ACF: от прототипа до продакшена
Представьте: редактору нужно заполнить карточку товара с 50 параметрами. Стандартные метабоксы заставляют его скроллить бесконечный список текстовых полей. Ошибки неизбежны: кривые даты, битые ссылки, перепутанные числа. Мы внедрили Advanced Custom Fields с группами полей и вложенными repeater — скорость ввода выросла в 3 раза, количество ошибок упало до нуля. Редактор получает понятные формы, а код остаётся чистым и поддерживаемым. Типовой проект с 10 группами полей требует 4-6 часов работы вместо 10-15 при ручной реализации — разница в 2-3 раза. Закажите настройку ACF под ключ и ускорьте ввод контента.
Неудобный ввод данных — классическая боль. Стандартные мета-боксы WordPress — это текстовые поля без подсказок. Редактор ошибается в формате дат, URL, чисел. ACF даёт календарь, ползунки, выпадающие списки. Сложность поддержки тоже решается: когда полей много, код на add_meta_box и update_post_meta превращается в кашу. ACF группирует поля, поддерживает условное отображение и синхронизацию через JSON. Flexible Content позволяет редактору самому собирать страницу из блоков (герой, текст, галерея). Настраиваем логику один раз — редактор использует её годами.
Какие проблемы решаем с помощью ACF
- Неудобный ввод данных. ACF заменяет текстовые поля на календарь, ползунки, выпадающие списки. Редактор не ошибается в форматах.
- Сложность поддержки. Группировка полей, условное отображение и JSON-синхронизация упрощают поддержку кода.
- Гибкость без программирования. Flexible Content даёт редактору возможность собирать страницу из предопределённых блоков без знаний PHP.
| Критерий | ACF | Ручные мета-боксы |
|---|---|---|
| Время настройки 10 полей | 2–4 часа | 6–8 часов |
| Удобство редактора | Высокое (UI типов полей) | Низкое (только текст) |
| Скорость выполнения запросов | Средняя (100+ полей — тормозит) | Зависит от реализации |
| Скорость разработки | В 2-3 раза быстрее | Медленнее |
Как ACF упрощает работу редактора?
Мы регистрируем группы полей программно — это стандарт для production. Код хранится в теме и версионируется в Git. Пример группы «Детали проекта»:
add_action('acf/init', function () {
acf_add_local_field_group([
'key' => 'group_project_details',
'title' => 'Детали проекта',
'fields' => [
[
'key' => 'field_project_client',
'label' => 'Клиент',
'name' => 'project_client',
'type' => 'text',
'required' => 1,
'placeholder' => 'Название компании',
],
[
'key' => 'field_project_year',
'label' => 'Год реализации',
'name' => 'project_year',
'type' => 'number',
'min' => 2000,
'max' => 2030,
'default_value' => date('Y'),
],
[
'key' => 'field_project_url',
'label' => 'URL проекта',
'name' => 'project_url',
'type' => 'url',
],
[
'key' => 'field_project_tech_stack',
'label' => 'Технологии',
'name' => 'project_tech_stack',
'type' => 'checkbox',
'choices' => [
'react' => 'React',
'vue' => 'Vue.js',
'laravel' => 'Laravel',
'wordpress' => 'WordPress',
'nextjs' => 'Next.js',
],
'layout' => 'horizontal',
],
[
'key' => 'field_project_gallery',
'label' => 'Галерея скриншотов',
'name' => 'project_gallery',
'type' => 'gallery',
'min' => 0,
'max' => 20,
'mime_types' => 'jpg,jpeg,png,webp',
'return_format' => 'array',
],
],
'location' => [
[
['param' => 'post_type', 'operator' => '==', 'value' => 'project']
],
],
'menu_order' => 0,
'position' => 'normal',
'style' => 'seamless',
'label_placement' => 'top',
]);
});Почему стоит регистрировать поля через код, а не через админку?
Админка ACF удобна для быстрых прототипов, но в эксплуатации ведёт к проблемам: конфигурация хранится в БД, её сложно версионировать, при переносе на новый сервер поля пропадают. Код — единственный надёжный способ. Документация ACF рекомендует именно этот подход для production.
Repeater — повторяющиеся блоки данных
[ 'key' => 'field_project_results', 'label' => 'Результаты проекта', 'name' => 'project_results', 'type' => 'repeater', 'min' => 1, 'max' => 10, 'layout' => 'table', 'button_label' => 'Добавить результат', 'sub_fields' => [ ['key' => 'field_result_metric', 'label' => 'Метрика', 'name' => 'metric', 'type' => 'text', 'placeholder' => 'Конверсия'], ['key' => 'field_result_before', 'label' => 'До', 'name' => 'before', 'type' => 'text', 'placeholder' => '1.2%'], ['key' => 'field_result_after', 'label' => 'После', 'name' => 'after', 'type' => 'text', 'placeholder' => '3.8%'], ], ], Выводим данные на фронте: get_sub_field в цикле have_rows. Код ниже используем в шаблонах проекта.
if (have_rows('project_results')) {
echo '<table class="results-table">';
echo '<thead><tr><th>Метрика</th><th>До</th><th>После</th></tr></thead><tbody>';
while (have_rows('project_results')) {
the_row();
printf('<tr><td>%s</td><td>%s</td><td>%s</td></tr>', esc_html(get_sub_field('metric')), esc_html(get_sub_field('before')), esc_html(get_sub_field('after')) );
}
echo '</tbody></table>';
}Flexible Content — конструктор страниц
Позволяет редактору собирать страницу из блоков разного типа: hero, текст, колонки. Мы подготавливаем layout, а редактор наполняет их контентом.
[ 'key' => 'field_page_sections', 'label' => 'Секции страницы', 'name' => 'page_sections', 'type' => 'flexible_content', 'button_label' => 'Добавить секцию', 'layouts' => [
'hero' => [
'key' => 'layout_hero',
'name' => 'hero',
'label' => 'Hero-баннер',
'sub_fields' => [
['key' => 'field_hero_title', 'label' => 'Заголовок', 'name' => 'title', 'type' => 'text'],
['key' => 'field_hero_bg', 'label' => 'Фон', 'name' => 'bg', 'type' => 'image', 'return_format' => 'array'],
['key' => 'field_hero_button', 'label' => 'Кнопка', 'name' => 'button', 'type' => 'link'],
],
],
'text_columns' => [
'key' => 'layout_text_columns',
'name' => 'text_columns',
'label' => 'Текст в колонках',
'sub_fields' => [
['key' => 'field_tc_cols', 'label' => 'Колонки', 'name' => 'columns', 'type' => 'repeater', 'sub_fields' => [
['key' => 'field_tc_text', 'name' => 'text', 'label' => 'Текст', 'type' => 'wysiwyg'],
]],
],
],
],
]Условное отображение полей
ACF позволяет показывать поле только при определённом значении другого. Например, показывать текст кнопки CTA только если переключатель включён.
[ 'key' => 'field_show_cta', 'label' => 'Показать CTA', 'name' => 'show_cta', 'type' => 'true_false', 'ui' => 1, ],
[ 'key' => 'field_cta_text', 'label' => 'Текст кнопки', 'name' => 'cta_text', 'type' => 'text', 'conditional_logic' => [ [['field' => 'field_show_cta', 'operator' => '==', 'value' => '1']], ], ],Синхронизация через JSON
ACF PRO автоматически сохраняет группы полей в файлы /acf-json/*.json при изменении через админку. Мы коммитим эти файлы в Git, а на другом окружении нажимаем Sync. Для автоматизации используем acf_sync_field_groups() в муст-плагине.
Типичные ошибки и как их избежать
- Пустые поля после сохранения — часто из-за отсутствия проверки
get_field(): всегда используйтеget_field('name', $post_id) ?: 'default'. - Забытые поля в шаблоне — проверяйте через
have_rows()илиget_field()с fallback. - Некорректный тип данных — ACF не валидирует автоматически, используйте
esc_*функции.
| Тип поля | Среднее время загрузки на странице (10 полей) | Рекомендации |
|---|---|---|
| Text | 2ms | Без ограничений |
| Image | 50ms (с 5 картинками) | Используйте return_format => 'id' и ленивую загрузку |
| Gallery | 100ms (10 картинок) | Кэшируйте или выводите через AJAX |
| Repeater (10 строк) | 20ms | Используйте get_field() вместо have_rows() для больших наборов |
| Flexible Content (5 блоков) | 40ms | Группируйте layout и кэшируйте результаты |
Что входит в работу под ключ
- Аудит текущих мета-полей и типов записей.
- Проектирование структуры ACF-полей под ваши задачи.
- Программная регистрация всех групп полей в functions.php или отдельном плагине.
- Настройка repeater, flexible content, условной логики, опций-страниц.
- Создание шаблонов вывода для фронтенда.
- Экспорт конфигурации в JSON и настройка синхронизации.
- Документация по полям и их использованию.
- Тестирование производительности и оптимизация запросов при необходимости.
- Обучение редакторов (базовое).
Процесс работы
- Анализ. Изучаем типы контента, текущие мета-поля и потребности редактора.
- Проектирование. Создаём макет групп полей: типы, связи, условные отображения.
- Реализация. Кодим регистрацию полей и вывод. Используем PHP 8.x, Composer, современные практики.
- Тестирование. Проверяем все сценарии: создание, редактирование, вывод, кэширование.
- Деплой. Синхронизируем через JSON, передаём документацию.
Сроки: от 3 до 10 рабочих дней в зависимости от сложности (количество полей, вложенность, количество типов записей). Стоимость рассчитывается индивидуально. Готовы решить вашу задачу? Свяжитесь с нами для расчёта.
Почему выбирают нас
Более 5 лет на рынке веб-разработки. Реализовали свыше 50 проектов на WordPress с ACF. Гарантируем стабильную работу полей и своевременное исправление багов после сдачи. Поддерживаем код в порядке — никаких лишних плагинов. Готовы навести порядок в админке? Свяжитесь с нами — подберём оптимальную структуру ACF под ваш проект. Получить консультацию можно через форму на сайте или в мессенджере.
