Настройка кастомных полей 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 под ваш проект. Получить консультацию можно через форму на сайте или в мессенджере.







