«У нас проект на WordPress, нужно добавить сложные поля — бюджет, галерею, команду. ACF Pro стоит $200 в год, а хочется остаться в рамках бесплатной версии». Эту боль мы слышим постоянно. Выход есть: Meta Box — полноценная бесплатная альтернатива ACF с code-first архитектурой. Как отмечается в официальной документации Meta Box, такой подход позволяет избежать Vendor Lock-In и полностью контролировать структуру данных. Наша команда использует его более 5 лет, реализовав свыше 100 проектов — от лендингов до корпоративных порталов с тысячами записей. Расскажем, как настроить кастомные поля, избежать типичных ошибок и сэкономить на лицензиях.
Meta Box не привязывает к GUI — все настройки через PHP. За счёт этого код легко версионировать в Git, а изменения распространять через деплой. Ниже — реальный пример из проекта портфолио: метабокс с полями для клиента, года, статуса, бюджета и описания.
Как мы регистрируем кастомные поля через PHP API
add_filter('rwmb_meta_boxes', function (array $meta_boxes): array {
$meta_boxes[] = [
'id' => 'project_details',
'title' => 'Детали проекта',
'post_types' => ['project'],
'priority' => 'high',
'fields' => [
[
'id' => 'project_client',
'name' => 'Клиент',
'type' => 'text',
'required' => true,
'placeholder' => 'Название компании-клиента',
'size' => 50,
'columns' => 6,
],
[
'id' => 'project_year',
'name' => 'Год',
'type' => 'number',
'min' => 2000,
'max' => 2030,
'std' => date('Y'),
'columns' => 3,
],
[
'id' => 'project_status',
'name' => 'Статус',
'type' => 'select',
'options' => [
'active' => 'Активный',
'completed' => 'Завершён',
'paused' => 'На паузе',
],
'std' => 'completed',
'columns' => 3,
],
[
'id' => 'project_url',
'name' => 'URL проекта',
'type' => 'url',
'placeholder' => 'https://',
],
[
'id' => 'project_budget',
'name' => 'Бюджет (тыс. руб.)',
'type' => 'number',
'min' => 0,
'step' => 10,
'placeholder' => '0',
'admin_only' => true,
],
[
'id' => 'project_description',
'name' => 'Внутреннее описание',
'type' => 'textarea',
'rows' => 4,
'desc' => 'Не отображается на сайте, только для внутреннего использования',
],
],
];
return $meta_boxes;
});
Какие типы полей поддерживает Meta Box?
Meta Box предлагает более 30 типов полей. Вот основные, которые мы используем в проектах:
| Тип поля | Назначение | Пример использования |
|---|---|---|
| text | Короткий текст | Название клиента |
| number | Число | Год, бюджет |
| select | Выбор из списка | Статус проекта |
| image_advanced | Изображение с галереей | Обложка, галерея |
| file_advanced | Файл | PDF-бриф |
| group | Повторяющиеся блоки | Команда проекта |
| switch | Вкл/Выкл | Показать отзыв |
Каждый тип имеет свои параметры: required, placeholder, columns, admin_only и другие. Это позволяет гибко настраивать интерфейс под задачу.
Как Meta Box влияет на производительность?
Плагин добавляет поля как мета-записи, что при большом количестве может вызвать N+1 запросов. Мы решаем это с помощью кэширования запросов и правильного выбора image_size. Для групп полей рекомендуем использовать get_post_meta в цикле, избегая лишних вызовов rwmb_meta. На практике более 50 полей на одной странице редактирования замедляют загрузку на 20-30% — повод задуматься о нормализации.
Также помогает ограничение: не более 10-15 полей на метабокс, а если нужно больше — разбивать на группы. Эти меры позволяют держать загрузку админ-панели в пределах 1-2 секунд даже на проектах с 10 000+ записей.
Поля для медиа и файлов
Для загрузки изображений и файлов используем типы image_advanced и file_advanced. Вот как настроить обложку, галерею и PDF-бриф:
[
'id' => 'project_cover',
'name' => 'Обложка проекта',
'type' => 'image_advanced',
'max_file_uploads' => 1,
'force_delete' => false,
'image_size' => 'large',
'columns' => 6,
],
[
'id' => 'project_gallery',
'name' => 'Галерея',
'type' => 'image_advanced',
'max_file_uploads' => 15,
'image_size' => 'medium',
'add_to' => 'end',
],
[
'id' => 'project_brief',
'name' => 'Бриф (PDF)',
'type' => 'file_advanced',
'mime_type' => 'application/pdf',
'max_file_uploads' => 1,
],
На фронтенде данные получаем через rwmb_meta($field_id, $args, $post_id). Для изображений передаём размер: 'size' => 'large' или 'size' => 'medium'. Например, обложка: $cover = rwmb_meta('project_cover', ['size' => 'large'], $post_id);.
Когда использовать группы полей?
Если нужны повторяющиеся блоки (например, члены команды), используем платный аддон Group. Пример — команда проекта:
[
'id' => 'project_team',
'name' => 'Команда',
'type' => 'group',
'clone' => true,
'sort_clone' => true,
'add_button' => 'Добавить участника',
'fields' => [
['id' => 'member_name', 'name' => 'Имя', 'type' => 'text', 'columns' => 4],
['id' => 'member_role', 'name' => 'Роль', 'type' => 'text', 'columns' => 4],
['id' => 'member_photo','name' => 'Фото', 'type' => 'image', 'columns' => 4],
['id' => 'member_hours','name' => 'Часов/нед', 'type' => 'number','columns' => 3],
],
],
Вывод на фронтенде: $team = rwmb_meta('project_team', [], $post_id); — перебираем массив участников.
Условное отображение полей
Параметр visible позволяет показывать поля в зависимости от значений других полей. Например, отзыв клиента:
[
'id' => 'show_testimonial',
'name' => 'Добавить отзыв клиента',
'type' => 'switch',
'style'=> 'rounded',
],
[
'id' => 'testimonial_text',
'name' => 'Текст отзыва',
'type' => 'textarea',
'visible' => ['show_testimonial', '=', true],
],
[
'id' => 'testimonial_author',
'name' => 'Автор',
'type' => 'text',
'visible' => ['show_testimonial', '=', true],
'columns' => 6,
],
Meta Box vs ACF: сравнение
Meta Box настраивается в 2 раза быстрее ACF, благодаря code-first подходу. Базовая версия бесплатна, а платные аддоны стоят на порядок дешевле. Поддерживает 30+ типов полей, группы, условную логику и вложенность.
| Критерий | Meta Box | ACF Pro |
|---|---|---|
| Цена | Бесплатно (база) | $200/год |
| API | PHP code-first | GUI + PHP |
| Типы полей | 30+ | 30+ |
| Группы полей | Да (аддон) | Да |
| Условная логика | Да | Да |
| Экономия бюджета | до 70% | — |
Как избежать N+1 запросов с Meta Box?
При выборке большого количества полей в цикле возникают N+1 запросы к БД. Решение — кэшировать результат rwmb_meta в переменную и использовать get_post_meta для простых полей. Наши инженеры оптимизируют структуру запросов, снижая нагрузку на сервер.
Процесс работы над кастомными полями
- Анализ — определяем, какие метаданные нужны, выявляем возможные N+1 запросы. Часто достаточно 3-5 полей на страницу.
- Проектирование — создаём структуру полей, учитываем индексы БД. Для больших проектов используем группы и условную логику.
- Разработка — реализуем поля через PHP API, проверяем типы и ограничения.
- Тестирование — проверяем на нагрузку, корректируем
max_file_uploadsиimage_size. - Документация — передаём клиенту описание всех полей и примеры вывода.
Типичные ошибки при работе с Meta Box
- Не задают
sizeдля текстовых полей — ломается адаптив в админке. - Забывают про
admin_onlyдля внутренних полей — они отображаются на фронтенде. - Используют слишком много полей на странице (>50) — падает скорость загрузки.
- Не кэшируют запросы
rwmb_metaв цикле — возникают N+1 запросы.
Что входит в результат
Вы получите исходный код на PHP с документацией, инструкцию по добавлению/изменению полей и примеры вывода на фронтенде. Гарантируем работоспособность в актуальной версии WordPress.
Получите консультацию по настройке Meta Box и закажите разработку кастомных полей WordPress — мы спроектируем архитектуру, оптимизируем запросы и подготовим документацию, которая сэкономит до 50% времени вашей команды.