Импорт в один клик — из ACF, SCF, Meta Box или CMB2 | Field Forge - Произвольные поля, созданные для скорости

Q: Что если мой сайт использует хуки или фильтры пользовательских полей?

Слой совместимости ACF охватывает API функций шаблонов (get_field(), have_rows() и т.д.), используемый 95% сайтов. Для оставшихся 5%, которые используют специфические хуки и фильтры ACF (например, acf/load_field, acf/save_post, расширения пользовательских типов полей), может потребоваться корректировка кода. Field Forge имеет эквивалентные хуки с префиксом fieldforge/: acf/load_field → fieldforge/load_field acf/save_post → fieldforge/save_post acf/format_value/type=text → fieldforge/format_value/type=text В большинстве случаев простая замена в файлах вашей темы или пользовательском плагине мигрирует ваши хуки. Наша команда поддержки может помочь, если вы столкнётесь с крайними случаями.

Q: Готовы к миграции?

Получите Field Forge — от $35/год → Инструмент импорта включён в каждый платный план. Ознакомьтесь с нашим полным руководством по миграции для пошаговых инструкций и устранения неполадок.

Поддерживаемые плагины-источники

Field Forge может мигрировать из:

Advanced Custom Fields (ACF)

ACF Free — ограниченные типы полей, но полная миграция групп полей
ACF Pro — все 30+ типов полей, включая повторяющиеся, гибкий контент, клоны, галереи, отношения, страницы опций, PHP блоки
Обе версии — бесплатная и платная — инструмент миграции автоматически определяет, какая версия установлена, и обрабатывает обе

Secure Custom Fields (SCF)

SCF — это форк ACF от WordPress.org, созданный в октябре 2024 года. Он использует тот же формат данных, что и ACF, поэтому один и тот же импортёр обрабатывает оба. Пользователи, использующие SCF после форка, могут мигрировать в Field Forge без дополнительной настройки.

Meta Box

Meta Box core — все основные типы полей
Расширения Meta Box — самые распространённые расширения (MB Text Limiter, MB Admin Columns, MB Custom Post Type, MB User Meta)
MB Include Exclude (правила местоположения) — сопоставлены с правилами местоположения Field Forge

CMB2

Определения полей CMB2 — определённые в PHP файлах, обнаруживаются и импортируются
Значения CMB2 — мигрируют из wp_postmeta в пользовательскую таблицу Field Forge
Примечание: CMB2 — это код-первый. Миграция преобразует поля, определённые в PHP, в группы полей Field Forge, так что вы получаете визуальный конструктор, сохраняя совместимость с API

Carbon Fields

Определения Carbon Fields — определённые в PHP файлах, обнаруживаются и импортируются
Значения Carbon Fields — мигрируют из хранилища в Field Forge
Похожи на CMB2, Carbon Fields — это код-первый

Что мигрирует

Определения групп полей

Название группы полей и слаг
Все определения подполей с правильными типами полей
Ярлыки полей, имена, флаги обязательности, значения по умолчанию, инструкции
Правила местоположения (тип поста, страница, категория, роль пользователя и т.д.)
Настройки позиции и стиля
Настройки скрытия на экране
Правила условной логики

Значения полей

Все существующие значения полей для каждого поста
Значения для сложных полей (повторяющиеся, гибкий контент, группа, клон)
Вложенные данные повторителей с правильными отношениями родитель-ребёнок
Ссылки на изображения и файлы (сохраняются как ID, не загружаются заново)
Ссылки на реляционные поля (ID постов, ID пользователей, ID терминов все сохраняются)
Значения даты/времени в правильном формате
Содержимое WYSIWYG с сохранением HTML

Страницы опций

Регистрации страниц опций
Все значения полей страниц опций
Назначения групп полей через правила местоположения

Пользовательские типы постов и таксономии

Если плагин-источник определяет пользовательские типы постов (Pods, Toolset), они мигрируют
Таксономии мигрируют с метаданными терминов, если это применимо

Особенности ACF

acf_register_block_type() вызовы обнаруживаются и преобразуются в PHP блоки Field Forge
JSON файлы групп полей из функции Local JSON ACF импортируются в синхронизацию JSON Field Forge

Процесс миграции

Шаг 1: Резервное копирование вашей базы данных

Всегда делайте резервную копию перед миграцией. Используйте инструмент резервного копирования вашего хостинга, UpdraftPlus или wp db export через WP-CLI.

«bash wp db export backup-before-fieldforge.sql «

Шаг 2: Установите Field Forge рядом с плагином-источником

Field Forge может работать одновременно с ACF, SCF, Meta Box, CMB2 или Carbon Fields во время миграции. Конфликтов нет, потому что слой совместимости ACF Field Forge активируется только тогда, когда ACF не работает, а собственное хранилище Field Forge изолировано от хранилища плагина-источника.

Шаг 3: Перейдите в Field Forge → Инструменты → Импорт

Экран импорта автоматически определяет, какие плагины пользовательских полей активны на вашем сайте. Вы увидите список обнаруженных плагинов с вариантами импорта для каждого.

Шаг 4: Нажмите «Начать импорт»

Выберите плагин-источник и нажмите «Начать импорт». Field Forge выполняет миграцию партиями, чтобы избежать тайм-аутов PHP на больших сайтах:

Определения групп полей — импортируются первыми (обычно <10 секунд)
Определения страниц опций — импортируются следующими
Значения полей — мигрируют партиями по 50 постов за запрос через AJAX
Проверка — проверка после миграции, чтобы убедиться, что количество совпадает

Полоса прогресса показывает:

Всего постов для миграции
Постов, мигрированных до сих пор
Постов в минуту
Оценочное оставшееся время

На сайте с 10,000 постами и сложными группами полей полная миграция обычно занимает 15–45 минут.

Шаг 5: Проверьте мигрированные данные

После завершения миграции Field Forge выполняет автоматическую проверку:

Количество мигрированных групп полей совпадает с количеством групп полей источника
Количество мигрированных значений постов совпадает с количеством значений постов источника
Сравнение образцов постов: выберите 10 случайных постов и проверьте, совпадают ли значения полей между хранилищем источника и Field Forge
Любые несоответствия перечисляются с деталями

Если проверка проходит, вы готовы деактивировать плагин-источник.

Шаг 6: Протестируйте сайт

С обоими плагинами, всё ещё активными, проверьте важные страницы:

Главная страница (глобальные группы полей)
Несколько постов, использующих пользовательские поля
Страницы опций
Любые страницы пользовательских типов постов
Экраны администратора (проверьте, правильно ли отображаются группы полей)

Если всё выглядит хорошо, переходите к Шагу 7.

Шаг 7: Деактивируйте плагин-источник

С деактивированным ACF (или SCF / Meta Box / CMB2 / Carbon Fields) слой совместимости ACF Field Forge берёт на себя управление. Все вызовы get_field(), have_rows() и т.д. теперь разрешаются в хранилище Field Forge.

Шаг 8: Финальная проверка

Проверьте те же страницы, что и на Шаге 6. Шаблоны должны отображаться идентично. Если шаблон показывает отсутствующие данные или ошибку 500, повторно активируйте плагин-источник (данные в безопасности) и свяжитесь с поддержкой Field Forge.

Пакетная обработка для больших сайтов

Инструмент миграции работает партиями по 50 постов за запрос по умолчанию (настраиваемо). Это предотвращает тайм-ауты PHP на больших сайтах и позволяет продолжать миграцию — если что-то прерывает процесс, вы можете перезапустить с того места, где он остановился.

Для сайтов с 50,000+ постами мы рекомендуем:

Запускать в часы низкой нагрузки
Использовать WP-CLI для более быстрой массовой миграции: wp fieldforge migrate --source=acf --batch-size=100
Мониторить с помощью wp fieldforge migrate-status для отслеживания прогресса

Безопасность данных

Миграция Field Forge неразрушительна:

Данные плагина-источника остаются на месте во время миграции
Миграция копирует данные в хранилище Field Forge, не изменяя источник
Если вы деактивируете Field Forge, данные плагина-источника остаются нетронутыми
Если вы деактивируете плагин-источник после миграции, данные Field Forge берут на себя управление, а данные источника остаются в базе данных в качестве резервной копии

Если миграция не удалась по какой-либо причине, вы всегда можете:

Деактивировать Field Forge
Повторно активировать плагин-источник
Ваш сайт вернётся в исходное состояние

Что если мой сайт использует хуки или фильтры пользовательских полей?

Слой совместимости ACF охватывает API функций шаблонов (get_field(), have_rows() и т.д.), используемый 95% сайтов. Для оставшихся 5%, которые используют специфические хуки и фильтры ACF (например, acf/load_field, acf/save_post, расширения пользовательских типов полей), может потребоваться корректировка кода.

Field Forge имеет эквивалентные хуки с префиксом fieldforge/:

acf/load_field → fieldforge/load_field
acf/save_post → fieldforge/save_post
acf/format_value/type=text → fieldforge/format_value/type=text

В большинстве случаев простая замена в файлах вашей темы или пользовательском плагине мигрирует ваши хуки. Наша команда поддержки может помочь, если вы столкнётесь с крайними случаями.

Миграция из ACF против SCF

Поскольку SCF является прямым форком ACF (тот же формат данных, тот же API), инструмент миграции обрабатывает их идентично. Если вы используете SCF после форка WordPress.org в октябре 2024 года, инструмент импорта определяет его как «ACF» и выполняет ту же логику миграции.

Готовы к миграции?

Получите Field Forge — от $35/год →

Инструмент импорта включён в каждый платный план. Ознакомьтесь с нашим полным руководством по миграции для пошаговых инструкций и устранения неполадок.