Кастомні поля WordPress через Meta Box: PHP API та оптимізація

«У нас проєкт на 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 типів полів. Ось основні, які ми використовуємо в проєктах:

Кожен тип має свої параметри: 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+ типів полів, групи, умовну логіку та вкладеність.

Як уникнути N+1 запитів з Meta Box?

При вибірці великої кількості полів у циклі виникають N+1 запити до БД. Рішення — кешувати результат rwmb_meta в змінну та використовувати get_post_meta для простих полів. Наші інженери оптимізують структуру запитів, знижуючи навантаження на сервер.

Процес роботи над кастомними полями

1. Аналіз — визначаємо, які метадані потрібні, виявляємо можливі N+1 запити. Часто достатньо 3-5 полів на сторінку.
2. Проектування — створюємо структуру полів, враховуємо індекси БД. Для великих проєктів використовуємо групи та умовну логіку.
3. Розробка — реалізуємо поля через PHP API, перевіряємо типи та обмеження.
4. Тестування — перевіряємо на навантаження, коригуємо max_file_uploads та image_size.
5. Документація — передаємо клієнту опис всіх полів та приклади виведення.

Типові помилки при роботі з Meta Box

• Не задають size для текстових полів — ламається адаптив в адмінці.
• Забувають про admin_only для внутрішніх полів — вони відображаються на фронтенді.
• Використовують забагато полів на сторінці (>50) — падає швидкість завантаження.
• Не кешують запити rwmb_meta в циклі — виникають N+1 запити.

Що входить в результат

Ви отримаєте вихідний код на PHP з документацією, інструкцію з додавання/зміни полів та приклади виведення на фронтенді. Гарантуємо працездатність в актуальній версії WordPress.

Отримайте консультацію з налаштування Meta Box та замовте розробку кастомних полів WordPress — ми спроектуємо архітектуру, оптимізуємо запити та підготуємо документацію, яка зекономить до 50% часу вашої команди.