Групове поле об’єднує кілька пов’язаних полів в один організований блок. Хоча повторювач дозволяє редакторам додавати кілька рядків даних, група завжди містить точно один набір підполів. Це правильний вибір, коли у вас є поля, які природно належать разом і з’являються лише один раз — як блок адреси, секція заклику до дії або картка контактної інформації.
Групи виконують дві функції. По-перше, вони організовують процес редагування, візуально групуючи пов’язані поля всередині обмеженого контейнера. По-друге, вони організовують вашу структуру даних — груповані поля зберігаються разом, що робить їх більш зручними для роботи розробника в шаблонах тем.
Коли використовувати групу замість окремих полів
Ви можете запитати, навіщо вам взагалі потрібні групи. Адже ви могли б просто додати Вулицю, Місто, Штат і Поштовий індекс як чотири окремі поля у вашій групі полів. Ось чому групи кращі:
| Без групи | З групою |
|---|---|
| Вулиця, Місто, Штат, Поштовий індекс з’являються як чотири окремі поля, змішані з іншими полями | Вулиця, Місто, Штат, Поштовий індекс з’являються всередині обмеженого контейнера “Адреса”, візуально відокремлені від інших полів |
Ваш розробник посилається на кожне поле окремо: get_field('street'), get_field('city') | Ваш розробник посилається на групу: get_field('address') і отримує всі чотири значення як структурований масив |
Якщо у вас є адреса І платіжна адреса, назви полів стають заплутаними: street, billing_street | Чисте вкладення: address.street і billing_address.street |
| Додавання нового поля, пов’язаного з адресою, означає пошук правильного місця серед усіх полів | Додавання нового поля всередині групи адреси зберігає все разом |
Покроково: Створення групи контактної інформації
Сценарій: Ви керуєте бізнесом з кількома локаціями. Кожна локація є власним типом запису, і кожна локація потребує контактної інформації: номер телефону, електронна адреса, години роботи та URL для вбудовування Google Maps. Ці чотири елементи даних логічно належать разом як “Контактна інформація”.- Перейдіть до Field Forge > Нова група полів
- Введіть заголовок: Деталі локації
- Натисніть Додати поле і виберіть Група з сітки типів полів (під “Складні поля”, значок PRO)
- Налаштуйте групу:
– Ім’я: contact_information
– Інструкції: Введіть контактні дані для цієї локації. Усі поля відображаються в бічній панелі та нижньому колонтитулі локації.
– Макет: Блок (показує групу як обмежену картку з підполями всередині)
- Додайте підполя всередині групи:
– Мітка: Номер телефону
– Ім’я: phone_number
– Обов’язкове: Так
– Заповнювач: “(555) 123-4567”
– Ширина обгортки: 50%
– Натисніть Додати підполе, виберіть Електронна пошта:
– Мітка: Електронна адреса
– Ім’я: email_address
– Обов’язкове: Так
– Заповнювач: “[email protected]”
– Ширина обгортки: 50%
– Натисніть Додати підполе, виберіть Текстова область:
– Мітка: Години роботи
– Ім’я: office_hours
– Інструкції: Введіть години в читабельному форматі, наприклад, “Пн-Пт: 9:00-17:00, Сб: 10:00-14:00, Нд: Закрито”
– Рядки: 3
– Ширина обгортки: 100%
– Натисніть Додати підполе, виберіть URL:
– Мітка: Посилання на Google Maps
– Ім’я: google_maps_link
– Інструкції: Вставте URL Google Maps для цієї локації. Перейдіть до Google Maps, знайдіть локацію, натисніть Поділитися та скопіюйте посилання.
– Ширина обгортки: 100%
- Тепер додайте друге групове поле в ту ж групу полів для адреси:
– Мітка: Фізична адреса
– Ім’я: physical_address
– Додайте підполя: Вулиця (текст, 100%), Місто (текст, 40%), Штат (вибір, 30%), Поштовий індекс (текст, 30%)
- Встановіть правило локації: Тип запису дорівнює Локація
- Натисніть Зберегти групу полів
![Скриншот: редактор групи полів Деталі локації, що показує дві групи — “Контактна інформація” з підполями телефону, електронної пошти, годин і посилання на карти, та “Фізична адреса” з підполями вулиці, міста, штату та поштового індексу, розташованими в багатостовпцевому макеті]
Як редактори використовують групу
Коли менеджер контенту відкриває запис локації, він бачить метабокс “Деталі локації”, що містить два обмежених секції: “Контактна інформація” та “Фізична адреса”. Кожна секція чітко позначена і містить свій набір полів. Редактор заповнює кожне поле так само, як і будь-яке інше поле — немає кнопки “Додати рядок”, оскільки група завжди містить точно один набір даних.
Ключова різниця від звичайних полів полягає у візуальному сприйнятті: обмежений контейнер одразу дає зрозуміти, які поля стосуються контактної інформації, а які — адреси. Без груп усі вісім полів з’явилися б як плоский список, і не було б очевидно, що Телефон і Електронна пошта належать разом, тоді як Вулиця і Місто належать разом.
Групи проти повторювачів — Посібник з прийняття рішень
Це найпоширеніше питання від людей, які налаштовують групи полів. Ось чітка структура прийняття рішень:
| Запитайте себе | Якщо відповідь… | Використовуйте |
|---|---|---|
| Скільки наборів цих даних буде? | Завжди точно один (одна адреса, один CTA) | Група |
| Скільки наборів цих даних буде? | Це змінюється — може бути 1, 5 або 50 (члени команди, Питання та відповіді) | Повторювач |
| Чи можуть редактори додати більше з цих? | Ні — завжди є один блок контактної інформації на локацію | Група |
| Чи можуть редактори додати більше з цих? | Так — вони можуть додати більше членів команди, коли компанія зростає | Повторювач |
| Чи представляють ці дані “секцію” чи “список”? | Секція (один Герой, один CTA) | Група |
| Чи представляють ці дані “секцію” чи “список”? | Список (багато Питань та відповідей, багато відгуків) | Повторювач |
Вкладення груп і повторювачів разом
Групи та повторювачі прекрасно працюють разом. Ось два поширені шаблони:
Шаблон 1: Повторювач, де кожен рядок містить групуСторінка “Послуги”, де кожна послуга має свій блок ціноутворення:
- Послуги (Повторювач — кілька послуг)
– Опис послуги (текстова область)
– Ціноутворення (Група — один блок ціноутворення на послугу)
– Щомісячна ціна (число)
– Річна ціна (число)
– Валюта (вибір)
– Включає безкоштовний пробний період (так/ні)
Шаблон 2: Група, яка містить повторювачРозділ “Огляд компанії” з фіксованим заголовком і змінним списком досягнень:
- Огляд компанії (Група — один огляд на сторінку)
– Опис (wysiwyg)
– Фонове зображення (зображення)
– Ключові досягнення (Повторювач — кілька досягнень)
– Рік (текст)
– Назва досягнення (текст)
– Опис (текстова область)
Поради щодо ширини обгортки для груп
Використовуйте ширини обгортки на підполях всередині групи, щоб створити акуратні, схожі на форми макети:
| Мета макету | Ширини підполів |
|---|---|
| Два поля поруч | 50% + 50% |
| Три поля в ряд | 33% + 33% + 34% |
| Одне велике, одне маленьке | 70% + 30% |
| Повна ширина під рядком маленьких полів | Перший рядок: 33% + 33% + 34%, наступне поле: 100% |
> Що відбувається без PRO: Групові поля вимагають плану PRO. Без них ви додаєте пов’язані поля як окремі поля верхнього рівня в групі полів. Вони все ще працюють функціонально, але ви втрачаєте візуальне групування (обмежений контейнер) і організацію структурованих даних. Для простих випадків з 2-3 пов’язаними полями це нормально. Для складних моделей даних з кількома групами пов’язаних полів групи роблять процес редагування значно чистішим.
> Порада: Чітко називайте свої групи. Замість “Група 1” або “Деталі” використовуйте конкретні назви, такі як “Контактна інформація”, “Фізична адреса” або “Налаштування заклику до дії”. Мітка групи з’являється як заголовок секції в редакторі, і чіткі назви допомагають редакторам одразу зрозуміти, для чого призначена кожна секція.
> Поширена помилка: Використання групи, коли потрібен повторювач (або навпаки). Якщо ви створюєте групу для “Членів команди”, але потім усвідомлюєте, що кожна сторінка потребує кількох членів команди, вам доведеться видалити групу і створити її знову як повторювач. Подумайте про те, чи дані повторюються, перш ніж вибрати.