Якщо ваш сайт наразі використовує ACF Pro (Advanced Custom Fields), Field Forge може імпортувати всі ваші групи полів, налаштування, умовну логіку та дані полів. Міграція розроблена так, щоб бути безшовною — ваша тема продовжує працювати без будь-яких змін коду, оскільки Field Forge надає ті ж шаблонні функції, що й ACF (get_field(), the_field(), have_rows() та всі інші).
Цей розділ надає детальний, покроковий процес міграції з перевіркою на кожному етапі та повним планом відкату. Міграція визначень полів між плагінами є значною зміною, і варто бути ретельним.
Перед тим, як щось чіпати: Контрольний список перед міграцією
Завершіть кожен пункт цього контрольного списку перед початком міграції:
| Крок | Дія | Як перевірити |
|---|---|---|
| 1 | Створіть повну резервну копію сайту — базу даних та файли | Завантажте резервну копію за допомогою панелі управління хостингом, UpdraftPlus або подібного плагіна для резервного копіювання. Перевірте, чи можете ви отримати доступ до файлу резервної копії. |
| 2 | Запишіть вашу поточну версію ACF Pro | Перейдіть до Плагіни > Встановлені плагіни, знайдіть ACF Pro, запишіть номер версії |
| 3 | Порахуйте ваші групи полів ACF | Перейдіть до ACF > Групи полів, запишіть загальну кількість |
| 4 | Визначте ваші найкритичніші групи полів | Виберіть 3-5 груп полів, які забезпечують найбільш видимі частини вашого сайту (геройські секції, сторінки продуктів, ключові цільові сторінки) |
| 5 | Перевірте ці критичні сторінки | Відвідайте 3-5 ключових сторінок на фронтенді та зробіть скріншоти або нотатки про те, як вони виглядають зараз — це ваша “до” довідка |
| 6 | Залиште ACF Pro активним | Не деактивуйте ACF поки що — Field Forge читає з нього під час міграції |
| 7 | Активуйте вашу ліцензію Field Forge PRO | Перейдіть до Field Forge > Ліцензія та активуйте — вам потрібен PRO для міграції значень полів (не лише визначень груп полів) |
| 8 | Перевірте ресурси вашого хостингу | Великі сайти потребують достатньої пам’яті PHP (256MB+) та часу виконання (300 секунд+). Запитайте у вашого хостера, якщо ви не впевнені. |
| 9 | Виберіть час з низьким трафіком | Запустіть міграцію, коли на вашому сайті мінімум відвідувачів, на випадок, якщо щось тимчасово порушить фронтенд |
| 10 | Повідомте вашу команду контенту | Скажіть редакторам уникати редагування постів під час вікна міграції |
Крок 1: Виявлення даних ACF
- Перейдіть до Field Forge > Міграція в адмінці WordPress
- Натисніть Виявити дані ACF
- Field Forge сканує ваш сайт і повідомляє, що він знайшов:
– Кількість постів/сторінок з даними полів ACF
– Загальна кількість значень полів, збережених у базі даних
– Список функцій ACF, що використовуються (Повторювачі, Гнучкий контент, Сторінки опцій тощо)
- Уважно перегляньте підсумок. Кількість груп полів повинна відповідати тому, що ви порахували в контрольному списку перед міграцією. Якщо числа сильно відрізняються, розслідуйте перед продовженням.
- Зверніть увагу, чи згадує підсумок типи полів лише для PRO (Повторювачі, Гнучкий контент, Групи, Клон). Якщо так, підтвердіть, що ваша ліцензія Field Forge PRO активна.
[Скріншот: екран Міграції, що показує результати виявлення — “Знайдено 12 груп полів, 847 постів з даними полів, 4,231 загальна кількість значень полів”]
Крок 2: Імпорт груп полів (тільки структура)
Цей крок імпортує визначення груп полів — самі поля, їх типи, налаштування, правила розташування та макет. Він не торкається фактичних даних контенту.
- Натисніть Імпорт груп полів
- Field Forge конвертує кожну групу полів ACF у формат Field Forge
- Індикатор прогресу показує, як обробляється кожна група
- Все зберігається:
– Правила розташування (які пости/сторінки показують кожну групу полів)
– Порядок полів та налаштування ширини обгортки
– Правила умовної логіки
– Поля макету вкладок, акордеонів та повідомлень
– Підполя всередині Груп, Повторювачів та Гнучких макетів, включаючи глибоко вкладені структури
– Групи полів лише для ACF Local JSON з acf-json/group_*.json, навіть якщо відповідні пости бази даних групи полів ACF не присутні
- З’являється повідомлення про успіх, яке вказує, скільки груп було імпортовано
- Перевірка: Перейдіть до Field Forge > Групи полів та порахуйте імпортовані групи. Кількість повинна відповідати кількості ACF.
- Перевірка: Відкрийте 2-3 імпортовані групи полів і перевірте, що поля, їх типи та налаштування виглядають правильно
- Перевірка: Відкрийте пост в редакторі, який повинен показувати одну з цих груп полів. Тепер ви повинні бачити групу полів двічі — один раз з ACF і один раз з Field Forge. Це очікується на цьому етапі.
Крок 3: Імпорт значень полів (дані — потрібен PRO)
Цей крок мігрує фактичний контент — все, що ваші редактори ввели в поля ACF на постах і сторінках. Це найкритичніший крок.
- Натисніть Імпорт груп полів зі значеннями
- З’являється індикатор прогресу, що показує статус міграції
- Field Forge обробляє пости партіями по 50 для надійності
- Для малих сайтів (менше 500 постів) це завершується менш ніж за хвилину
- Для великих сайтів (тисячі постів) міграція працює у фоновому режимі — ви можете закрити вкладку браузера, і вона продовжить обробку. Повідомлення з’являється в адмінці, коли вона закінчує.
- Дочекайтеся повідомлення про завершення перед продовженням
- Перевірка: Відкрийте 5-10 постів різних типів і перевірте, що:
– Текстові поля містять правильний текст
– Поля зображень показують правильні зображення
– Поля вибору/чекбокси/радіо мають правильні вибори
– Рядки повторювача збережені з усіма їх підпольовими даними
– Поля груп зберігають свої значення дітей
– Макети гнучкого контенту в правильному порядку з правильними даними
– Якщо макет гнучкого контенту містить вкладений повторювач, перетягніть один вкладений рядок, натисніть Оновити і підтвердіть, що порядок рядків зберігається без дублікатів
Крок 4: Перевірка фронтенду
Це те місце, де ваші “до” скріншоти з контрольного списку перед міграцією стають важливими.
- Відвідайте 3-5 критичних сторінок, які ви задокументували перед міграцією
- Порівняйте їх зі своїми скріншотами/нотатками — все повинно виглядати ідентично
- Перевірте сторінки, які використовують повторювачі (сторінки команди, секції FAQ, таблиці цін) — перевірте, чи всі рядки з’являються
- Перевірте сторінки, які використовують гнучкий контент — перевірте, чи всі секції з’являються в правильному порядку
- Перевірте заголовок та нижній колонтитул сайту — якщо вони використовують дані сторінки опцій, перевірте, чи номер телефону, логотип, соціальні посилання тощо все ще з’являються
- Перевірте на мобільних пристроях — адаптивні макети не повинні бути порушені
Крок 5: Деактивуйте ACF Pro (коли будете готові)
Продовжуйте до цього кроку лише після ретельної перевірки. Немає поспіху.
- Перейдіть до Плагіни > Встановлені плагіни
- Знайдіть ACF Pro у списку
- Натисніть Деактивувати (не видалити — лише деактивуйте поки що)
- Негайно знову відвідайте свої 3-5 критичних фронтенд-сторінок
- Все ще повинно виглядати ідентично, оскільки Field Forge надає всі ті ж шаблонні функції
- Перевірте редактор WordPress — пости повинні показувати метабокси Field Forge (не ACF метабокси)
- Якщо все працює, залиште ACF Pro деактивованим принаймні на тиждень, поки ваша команда використовує сайт нормально
- Після одного тижня безперебійної роботи ви можете видалити ACF Pro, якщо хочете — але немає шкоди в тому, щоб залишити його деактивованим як запобіжний захід
План відкату
Якщо щось піде не так на будь-якому етапі:
| Проблема | Рішення |
|---|---|
| Групи полів імпортовані неправильно | Видаліть групи полів Field Forge та повторно запустіть імпорт |
| Значення полів відсутні або неправильні | Повторно запустіть міграцію значень — вона є ідемпотентною та видаляє дублікатні записи груп ACF перед імпортом значень |
| Фронтенд-сторінки виглядають інакше після деактивації ACF | Негайно повторно активуйте ACF Pro — сайт повертається до свого попереднього стану |
| Міграція не вдалася або вийшла за межі часу | Перевірте журнали помилок сервера на наявність проблем з пам’яттю або тайм-аутами. Збільшіть пам’ять PHP до 512MB та максимальний час виконання до 600 секунд, а потім спробуйте знову. |
| Ви хочете скасувати все | Відновіть повну резервну копію, яку ви створили в контрольному списку перед міграцією. Це поверне весь сайт до його точного стану до міграції. |
Посилання на сумісність міграції
| Функція ACF | Підтримується в міграції | Примітки |
|---|---|---|
| Усі основні типи полів (текст, число, зображення тощо) | Так | |
| Вибір, чекбокс, радіо, правда/неправда, група кнопок | Так | |
| Вибір дати, вибір кольору | Так | |
| Вкладки, акордеони, повідомлення | Так | |
| Повторювачі | Так | Потрібен PRO |
| Групи | Так | Потрібен PRO |
| Гнучкий контент | Так | Потрібен PRO |
| Поля клонування | Так | Потрібен PRO |
| Сторінки опцій та їх дані | Так | Потрібен PRO |
| Умовна логіка | Так (поля верхнього рівня) | Правила для полів верхнього рівня імпортуються та оцінюються під час виконання. Правила для полів, вкладених у Повторювач / Групу / Гнучкий контент, імпортуються, але ще не оцінюються — кожне вкладене поле все ще відображається. |
| Правила розташування | Так | |
| Значення полів (дані контенту постів) | Так | Потрібен PRO |
| Локальні JSON файли | Так | Field Forge може імпортувати визначення груп полів лише для ACF Local JSON з acf-json/group_*.json; власна синхронізація Field Forge використовує fieldforge-json/. |
| ACF Blocks (блоки Gutenberg) | Бета / ручний перегляд | Просте визначення блоків ACF може бути відображено у блоках PHP Field Forge (PRO), але користувацькі колбеки рендерингу, активи блоків та код реєстрації, специфічний для теми, слід переглянути вручну перед видаленням ACF Pro. |
> Добре знати: Міграція не змінює і не видаляє жодних даних ACF. Обидва плагіни можуть співіснувати, поки ви все перевіряєте. Ваші оригінальні дані ACF залишаються в таблиці wp_postmeta, навіть після міграції. Видаляйте ACF Pro лише після тривалого тестування, яке підтверджує, що все працює.
> Важливо: Якщо ваш сайт використовує функції ACF у користувацьких плагінах (не лише у темі), протестуйте ці плагіни після міграції також. Field Forge надає всі стандартні функції ACF, але дуже незвичайні або не задокументовані внутрішні елементи ACF можуть поводитися інакше. Тестуйте ретельно.
> Порада: Для великих корпоративних сайтів з десятками тисяч постів розгляньте можливість міграції під час вікна технічного обслуговування та використання функції фонової міграції. Повідомте про вікно всю вашу команду контенту, щоб ніхто не редагував пости під час міграції значень.