Частина 1: Перед початком

Чому мігрувати?

Перед тим, як інвестувати час у міграцію, переконайтеся, що зміна того варта. Причини для міграції з ACF або SCF до Field Forge:

• Продуктивність — кастомне зберігання таблиць Field Forge в 3–10 разів швидше на сайтах з 1,000+ постами або складними повторювачами
• Генерація схеми за допомогою ШІ — унікально для Field Forge, економить 80% часу на налаштування груп полів
• Інструменти безголового WordPress — автоматична генерація TypeScript і GraphQL
• Ціна — Field Forge Personal $35/рік проти ACF Pro $49/рік; Agency $169 проти ACF Agency $249
• Невизначеність з ACF/SCF — уникайте драми WP Engine / WordPress.org з плагіном, який не залучений
• Версійність схеми — ніколи не втрачаєте зміни групи полів; відкат в один клік
• Сучасна архітектура — Field Forge був створений для WordPress у 2026 році, а не у 2016

Якщо жодна з цих причин не стосується вашої ситуації, залишайтеся на ACF або SCF. Міграція має свою вартість (час, тестування, ризик), і ви повинні мігрувати лише тоді, коли переваги перевищують цю вартість.

Перевірка сумісності

Перед міграцією перевірте, що ваш код, специфічний для ACF, не зіткнеться з крайніми випадками в сумісному шарі Field Forge.

Речі, які працюють з коробки:

• get_field(), the_field(), get_fields(), get_field_object(), get_field_objects()
• update_field(), delete_field()
• have_rows(), the_row(), get_row(), get_row_index(), get_row_layout()
• get_sub_field(), the_sub_field(), update_sub_field()
• acf_register_block_type() (Gutenberg PHP blocks)
• get_field('name', 'options') та get_field('name', 'option') (сторінки налаштувань)
• get_field('name', 'user_123') (кастомні поля користувача)
• format_value параметр у всіх функціях
• Усі 32 типи полів (текст, зображення, повторювач, гнучкий контент, зв’язок тощо)

Речі, які потребують корекції:

• Специфічні для ACF хуки такі як acf/load_field, acf/save_post, acf/format_value/type=text — у них є еквіваленти Field Forge (fieldforge/load_field тощо), які ваш код потрібно буде оновити для використання. Сумісний шар Field Forge НЕ пересилає хуки ACF до своєї системи хуків.
• Розширення типів кастомних полів, зареєстровані через систему хуків ACF — їх потрібно повторно зареєструвати, використовуючи API реєстрації типів полів Field Forge
• Внутрішні PHP класи ACF, доступ до яких здійснюється безпосередньо (наприклад, ACFAdminAdminFields) — їх не існує в Field Forge
• Внутрішній JavaScript API ACF (acf.addAction() тощо) — Field Forge має свій власний JS API

Для 95% сайтів жодна з вищезазначених речей не має значення. Теми зазвичай використовують лише функції шаблонів, а не внутрішні API.

Як перевірити свій код:

Запустіть grep по файлах вашої теми та кастомних плагінів:

“`bash

Знайти всі виклики функцій шаблону ACF (повинно працювати)

grep -r “get_field|have_rows|the_sub_field|acf_register_block_type” wp-content/themes/your-theme/

Знайти специфічні для ACF хуки (потребують корекції)

grep -r “add_action.‘acf/|add_filter.‘acf/” wp-content/themes/your-theme/

Знайти використання внутрішніх класів ACF (потребують переписування)

grep -r “\\ACF\\|use ACF” wp-content/themes/your-theme/ “`

Якщо перший grep повертає результати, а другі два порожні, ви в безпеці — пряма міграція працює. Якщо другий або третій повертає результати, сплануйте додаткові оновлення коду після міграції.

---

Частина 2: Резервне копіювання (критично)

Повне резервне копіювання бази даних

Завжди робіть резервну копію перед міграцією. Це не підлягає обговоренню.

Через інструмент вашого хостингу: Більшість керованих хостингів WordPress (Kinsta, WP Engine, SiteGround, Cloudways тощо) мають резервне копіювання бази даних в один клік. Використовуйте його.

Через WP-CLI: “bash wp db export backup-before-fieldforge-$(date +%Y%m%d).sql “

Це створює SQL дамп вашої всієї бази даних. Зберігайте його в безпечному місці (завантажте на локальний комп’ютер, завантажте на S3 тощо). Якщо міграція піде не так, ви зможете відновити з цього дампу.

Через плагін: UpdraftPlus, BackupBuddy, BackWPup або подібні. Виконайте повне резервне копіювання — бази даних І Файлів — перед продовженням.

Резервне копіювання файлів

Також зробіть резервну копію всього каталогу wp-content/. Якщо ви використовуєте функцію Local JSON ACF, JSON файли знаходяться в wp-content/themes/your-theme/acf-json/.

Середовище для стадії (рекомендується)

Якщо можливо, спочатку виконайте міграцію в середовищі для стадії. Клонуйте свій виробничий сайт на стадію, виконайте міграцію, перевірте, що все працює, а потім повторіть на виробництві. Більшість керованих хостингів пропонують клонування стадії в один клік.

Якщо у вас немає стадії, виконайте міграцію під час години з низьким трафіком.

---

Частина 3: Встановіть Field Forge

Завантажте плагін

Перейдіть до ціни Field Forge та придбайте ліцензію. Ви отримаєте посилання для завантаження ZIP-файлу плагіна Field Forge.

Або встановіть безкоштовну версію з WordPress.org:

1. Адмін WordPress → Плагіни → Додати новий
2. Шукайте “Field Forge”
3. Встановіть та активуйте

Примітка: безкоштовна версія охоплює основні функції міграції. Платні плани відкривають генерацію ШІ, TypeScript, GraphQL та деякі розширені типи полів.

Завантажте та активуйте

1. Адмін WordPress → Плагіни → Додати новий → Завантажити плагін
2. Виберіть ZIP-файл Field Forge
3. Встановити зараз → Активувати плагін

Field Forge тепер з’являється у вашому меню адміністратора WordPress. ACF (або SCF) все ще активний — ви деактивуєте його пізніше.

Активуйте свою ліцензію

Якщо ви придбали платний план, активуйте ліцензію:

1. Field Forge → Налаштування → Ліцензія
2. Вставте свій ключ ліцензії
3. Натисніть Активувати ліцензію

Ви отримаєте підтвердження, що ліцензія дійсна.

Підтвердіть, що Field Forge та ACF не конфліктують

Сумісний шар ACF Field Forge розумний у роботі поряд з ACF. Коли обидва плагіни активні:

• ACF продовжує обслуговувати всі виклики функцій шаблону (get_field() тощо)
• Field Forge НЕ перевизначає функції ACF (оскільки ACF все ще є авторитетним джерелом)
• Field Forge реєструє свої власні екрани адміністратора поряд з екранами ACF
• Ви можете налаштувати групи полів Field Forge, не впливаючи на ACF

Це означає, що під час міграції немає конфлікту. Ви можете працювати в екранах адміністратора обох плагінів одночасно.

---

Частина 4: Запустіть імпорт

Відкрийте інструмент імпорту

1. Адмін WordPress → Field Forge → Інструменти → Імпорт
2. Ви побачите список виявлених плагінів кастомних полів (ACF, SCF, Meta Box, CMB2, Carbon Fields)
3. Натисніть Імпортувати з Advanced Custom Fields (або Secure Custom Fields)

Налаштуйте параметри імпорту

Екран налаштування імпорту пропонує кілька параметрів:

• Імпортувати групи полів — імпортує визначення груп полів з ACF до Field Forge (обов’язково)
• Імпортувати значення полів — мігрує всі існуючі значення полів з wp_postmeta до кастомної таблиці Field Forge (рекомендується)
• Імпортувати значення сторінок налаштувань — мігрує дані сторінки налаштувань (якщо ви використовуєте сторінки налаштувань ACF)
• Розмір партії — пости на запит (за замовчуванням 50, менше для повільних хостів, більше для швидких хостів)
• Пропустити порожні значення полів — не мігрувати поля з порожніми значеннями (економить час і місце)
• Сухий запуск — симулювати міграцію без внесення змін (добре для попереднього перегляду)

Почніть з параметрів за замовчуванням. Якщо міграція стикається з помилками, відкоригуйте параметри та повторіть.

Запустіть імпорт

Натисніть Почати імпорт. З’являється індикатор прогресу, що показує:

• Поточна фаза (групи полів → значення полів → сторінки налаштувань → перевірка)
• Оброблені пости / загальна кількість постів
• Час, що минув / оцінений залишковий час
• Помилки (якщо є)

Імпорт виконується партіями по 50 постів на AJAX-запит. Партіонування запобігає тайм-аутам PHP на великих сайтах і забезпечує видимий прогрес.

Очікуваний час

• <100 постів: 1–2 хвилини
• 100–1,000 постів: 3–10 хвилин
• 1,000–10,000 постів: 15–45 хвилин
• 10,000+ постів: 45 хвилин до 2 годин

Під час імпорту не закривайте вкладку браузера. Якщо ви випадково закриєте її, імпорт призупиняється; повторно відкрийте сторінку імпорту та натисніть Продовжити імпорт.

---

Частина 5: Перевірте міграцію

Автоматична перевірка

Після завершення імпорту Field Forge виконує автоматичні перевірки:

• Кількість груп полів — кількість мігрованих груп відповідає кількості вихідних груп
• Кількість значень полів — перевірки на випадкових постах для підтвердження міграції значень
• Цілісність схеми — перевіряє, що визначення полів дійсні
• Сторінки налаштувань — підтверджує, що дані сторінки налаштувань доступні

Ви побачите зелену галочку поруч з кожним кроком перевірки або ж жовте/червоне попередження, якщо щось потребує уваги.

Ручна перевірка

Не покладайтеся лише на автоматичні перевірки. Перевірте важливі сторінки:

1. Перевірте типовий пост з кастомними полями

Перейдіть до адміністратора WordPress → Пости → виберіть пост, який використовує кастомні поля → прокрутіть до метабоксу Field Forge → перевірте, що значення полів відповідають тим, що в метабоксі ACF вище.

2. Перевірте сторінку з гнучким контентом

Якщо ви використовуєте поля гнучкого контенту, перевірте сторінку з кількома макетами. Усі макети повинні з’явитися в метабоксі Field Forge з правильними значеннями полів.

3. Перевірте сторінку з повторювачами

Якщо ви використовуєте поля повторювачів, перевірте, що всі рядки присутні з правильними значеннями підполів.

4. Перевірте сторінки налаштувань

Перейдіть до будь-якої сторінки налаштувань (Налаштування сайту, Налаштування заголовка тощо) — значення повинні з’явитися як в перегляді сторінки налаштувань ACF, так і в версії Field Forge.

5. Перевірте фронтенд

Завантажте домашню сторінку та кілька ключових сторінок у браузері. ACF все ще активний на цьому етапі, тому рендеринг фронтенду все ще відбувається з ACF. Підтверджуйте, що нічого не зламалося під час процесу міграції.

Якщо перевірка не вдалася

Якщо будь-яка перевірка не вдалася:

1. Не панікуйте. ACF все ще активний; ваш сайт все ще обслуговує контент нормально.
2. Перевірте журнал помилок. Field Forge записує детальні помилки в журналі помилок WordPress або в адміністрації Field Forge в Інструменти → Журнали.
3. Повторіть імпорт. Іноді тимчасові помилки (тайм-аути, тимчасові проблеми з базою даних) вирішуються при повторній спробі.
4. Перевірте конкретні типи полів, які не вдалися. Журнал Field Forge вказує, які типи полів мали проблеми.
5. Зв’яжіться з підтримкою — [email protected] з деталями про невдачу.

---

Частина 6: Деактивуйте ACF (критичний крок)

Це момент істини. Деактивація ACF активує сумісний шар Field Forge — всі виклики get_field() з вашої теми тепер будуть звертатися до зберігання Field Forge, а не ACF.

Перед деактивацією

• Переконайтеся, що все мігрувало (Частина 5)
• Підтверджуйте, що фронтенд виглядає правильно з ACF все ще активним
• Майте резервну копію готовою (Частина 2)
• Виберіть момент з низьким трафіком, якщо це виробничий сайт

Деактивуйте ACF

Адмін WordPress → Плагіни → Встановлені плагіни → Advanced Custom Fields → Деактивувати

Не натискайте “Видалити” ще — ми хочемо, щоб ACF був доступний як резервний варіант, якщо щось піде не так.

Що відбувається відразу

В момент деактивації ACF:

• Шаблонні функції ACF (get_field тощо) перестають реєструватися ACF
• Сумісний шар Field Forge виявляє це і реєструє свої власні реалізації
• Виклики шаблону тепер звертаються до зберігання Field Forge
• Екрани адміністратора Field Forge беруть на себе навігацію “Кастомні поля”

Перевірте фронтенд

Негайно перезавантажте фронтенд:

1. Домашня сторінка — чи виглядає вона правильно?
2. Сторінка з гнучким контентом — чи всі секції рендеряться?
3. Сторінка з повторювачем — чи всі рядки відображаються?
4. Сторінки налаштувань — чи з’являються глобальні налаштування (назва сайту, соціальні URL тощо)?
5. Gutenberg PHP блок (якщо ви використовуєте acf_register_block_type()) — чи рендериться він?

Якщо все виглядає правильно, міграція успішна. Святкуйте.

Якщо щось зламалося, перейдіть до Частини 8 (Усунення неполадок) нижче.

---

Частина 7: Очищення та оптимізація

Видалити ACF (після 1 тижня)

Почекайте 1 тиждень з активним Field Forge перед повним видаленням ACF. Це дає вам час виявити будь-які крайні випадки, які не були виявлені під час негайної перевірки. Якщо виникають проблеми, повторно активуйте ACF як резервний варіант, поки ви налагоджуєте.

Після 1 тижня стабільної роботи:

1. Адмін WordPress → Плагіни → Встановлені плагіни
2. Advanced Custom Fields → Видалити
3. Підтвердіть видалення
4. ACF зник з вашого сайту

Необов’язково: очистіть wp_postmeta

Після міграції дані ACF все ще залишаються в wp_postmeta (міграція Field Forge є не руйнівною — вона копіює дані, не видаляючи з джерела). Ці додаткові дані займають місце, але нічого не шкодять.

Якщо ви хочете їх очистити:

“sql DELETE FROM wp_postmeta WHERE meta_key LIKE '_%' AND meta_key IN ( SELECT DISTINCT meta_key FROM wp_postmeta WHERE meta_key LIKE '_%' ); “

ПОПЕРЕДЖЕННЯ: Цей SQL є приблизним і небезпечним. Запускайте його лише якщо ви впевнені у своїх навичках роботи з базами даних І маєте нещодавню резервну копію. Підтримка Field Forge може допомогти з безпечнішим запитом очищення, адаптованим до ваших конкретних груп полів.

Більшість сайтів не займаються цим очищенням — додаткове зберігання є незначним.

Оптимізуйте налаштування Field Forge

Тепер, коли ви повністю на Field Forge, скористайтеся його функціями:

1. Увімкніть синхронізацію Local JSON — зберігайте групи полів як JSON файли у вашій темі для версійності git (Field Forge → Налаштування → Local JSON)
2. Увімкніть об’єктний кеш — якщо у вас є Redis або Memcached, Field Forge автоматично використовує його
3. Запустіть пакетне завантаження на архівних сторінках через кастомні теги шаблону для ще швидшої продуктивності
4. Спробуйте генерацію схеми за допомогою ШІ — у наступній групі полів, яку ви створите, спробуйте генератор ШІ замість ручного створення
5. Генеруйте типи TypeScript — якщо у вас є безголовий фронтенд, завантажте файли .d.ts з адміністрації Field Forge

---

Частина 8: Усунення неполадок

“Відсутні значення полів” після деактивації ACF

Симптом: Пост, який мав кастомні значення полів в ACF, виглядає порожнім у Field Forge після деактивації ACF.

Причина: Значення поля не мігрувало під час імпорту. Це може статися, якщо:

• Поле було додано до ACF після останнього збереження поста
• Поле має незвичний формат зберігання (дуже рідко)
• Імпорт був перерваний до того, як цей конкретний пост був оброблений

Виправлення:

1. Повторно активуйте ACF (дані в безпеці)
2. Перейдіть до Field Forge → Інструменти → Імпорт
3. Повторіть імпорт з опцією “Продовжити” або “Повний повтор”
4. Імпортер повторно перевірить всі пости та підбере будь-які пропущені значення
5. Знову деактивуйте ACF та перевірте знову

“Зламаний шаблон” після деактивації ACF

Симптом: Шаблон, який раніше рендерився правильно, тепер викликає помилку PHP або показує несподіваний контент.

Причина: Шаблон використовує специфічну для ACF функцію або хук, яку сумісний шар Field Forge не покриває.

Виправлення:

1. Повторно активуйте ACF
2. Перевірте журнали помилок PHP для конкретної функції / хуку, що не вдалася
3. Визначте, який специфічний API ACF використовує шаблон
4. Оновіть шаблон, щоб використовувати еквівалент Field Forge
5. Знову деактивуйте ACF

Найбільш поширені винуватці:

• acf_add_local_field_group() — використовуйте fieldforge_register_field_group() замість
• acf_form() — використовуйте Form Forge або інший конструктор форм
• Кастомні типи полів, зареєстровані через хук acf/include_field_types — повторно зареєструйте через фільтр fieldforge/field_types/register

“Повільніша продуктивність після міграції”

Симптом: Сторінки завантажуються повільніше після переходу на Field Forge.

Причина: Рідко, але можливо. Кастомне зберігання таблиць Field Forge має бути швидшим, а не повільнішим. Якщо ви бачите повільнішу продуктивність:

• Об’єктний кеш неправильно налаштований — Field Forge повертається до запитів бази даних
• У WordPress увімкнено WP_DEBUG з великим файлом журналу
• Інший плагін викликає уповільнення (випадковий збіг)

Виправлення:

1. Перевірте, що ваш плагін об’єктного кешу активний і працює
2. Вимкніть WP_DEBUG та WP_DEBUG_LOG у виробництві
3. Запустіть Field Forge → Інструменти → Тест продуктивності, щоб оцінити конкретні сторінки
4. Зв’яжіться з підтримкою з деталями часу

“Міграція, здається, пропустила сторінки налаштувань”

Симптом: Значення сторінок налаштувань виглядають порожніми або за замовчуванням після міграції.

Причина: ACF зберігає значення сторінок налаштувань з іншим префіксом ключа, ніж значення полів постів. Імпортер повинен обробляти обидва випадки.

Виправлення:

1. Перейдіть до Field Forge → Інструменти → Імпорт
2. Натисніть Повторно імпортувати сторінки налаштувань
3. Це повторно запускає лише міграцію сторінок налаштувань

“Рядки повторювача в неправильному порядку”

Симптом: Поля повторювачів мігрували, але рядки з’являються в іншому порядку, ніж були в ACF.

Причина: Рідкісна гонка під час імпорту, коли row_index не був правильно встановлений.

Виправлення: Зв’яжіться з підтримкою з конкретною назвою групи полів. Це зазвичай одноразове виправлення з SQL-оновленням.

---

Частина 9: Відкат (якщо вам це потрібно)

Швидкий відкат

Якщо міграція йде не так, і вам потрібно повернутися до ACF:

1. Повторно активуйте ACF (Плагіни → Встановлені плагіни → ACF → Активувати)
2. Деактивуйте Field Forge (Плагіни → Встановлені плагіни → Field Forge → Деактивувати)
3. Функції шаблону ACF знову реєструються
4. Ваш сайт повертається до обслуговування даних з wp_postmeta (зберігання ACF)
5. Все працює так, як було до спроби міграції

Міграція Field Forge є не руйнівною — дані ACF все ще на місці. Відкат завжди можливий, поки ви не видалили ACF.

Повний відкат до стану до міграції

Якщо ви хочете повністю скасувати міграцію та видалити Field Forge:

1. Повторно активуйте ACF
2. Деактивуйте Field Forge
3. Field Forge → Налаштування → Видалити всі дані (видаляє кастомну таблицю Field Forge, ревізії, JSON файли)
4. Деактивуйте та видаліть Field Forge
5. Ваш сайт повертається точно до того, де він був до міграції

---

Часті запитання

Скільки часу займає типова міграція ACF? 30–90 хвилин для більшості сайтів. Великі сайти (10,000+ постів) можуть зайняти 2+ години.

Чи знизяться мої рейтинги під час міграції? Ні. Міграція не змінює URL, контент або метадані, які бачить Google. Field Forge мігрує лише шар зберігання.

Чи можу я безкінечно використовувати ACF та Field Forge? Технічно так під час міграції, але не як довгострокову виробничу установку. Використання обох означає дублювання адміністративних інтерфейсів та плутанину в налаштуваннях.

Що з функціями ACF Pro, такими як Повторювач і Гнучкий контент? Платні плани Field Forge включають всі функції ACF Pro. Повторювач, Гнучкий контент, Група, Клон, Сторінки налаштувань, Галерея, PHP блоки — все працює після міграції.

Чи потрібно переписувати код моєї теми? Ні. Сумісний шар ACF Field Forge означає, що існуючий код продовжує працювати.

Що, якщо у мене є кастомні типи полів ACF від сторонніх плагінів? Кастомні типи полів, зареєстровані через систему хуків ACF, потрібно повторно зареєструвати для Field Forge. Зв’яжіться з підтримкою для допомоги з конкретними випадками.

Чи можу я пізніше мігрувати назад з Field Forge до ACF? Так. Експорт даних Field Forge дозволяє вам експортувати групи полів у форматі, сумісному з ACF. Імпортуйте в ACF, деактивуйте Field Forge. Ваш сайт продовжить працювати.

Чи безкоштовна міграція? Безкоштовна версія Field Forge на WordPress.org включає інструменти міграції. Вам потрібна лише платна ліцензія для функцій ШІ, генерації TypeScript/GraphQL та деяких розширених типів полів.

Чи працює міграція також для SCF? Так. SCF є форком ACF з тим самим форматом даних. Імпортер ACF обробляє обидва.

---

Готові до міграції?

Отримайте Field Forge — від $35/рік →

14-денний повернення. Безкоштовна версія включає інструменти міграції. Пріоритетна підтримка під час міграції.

Питання перед початком? Зв’яжіться з нашою командою підтримки міграції →