Plugins de origen soportados
Field Forge puede migrar desde:
Advanced Custom Fields (ACF)
- ACF Free — tipos de campo limitados pero migración completa de grupos de campos
- ACF Pro — todos los 30+ tipos de campo incluyendo repetidor, contenido flexible, clon, galería, relación, páginas de opciones, bloques PHP
- Tanto la versión gratuita como la pro — la herramienta de migración detecta automáticamente qué versión está instalada y maneja ambas
Secure Custom Fields (SCF)
- SCF es el fork de ACF en WordPress.org creado en octubre de 2024. Utiliza el mismo formato de datos que ACF, por lo que el mismo importador maneja ambos. Los usuarios que ejecutan SCF después del fork pueden migrar a Field Forge sin configuración adicional.
Meta Box
- Meta Box core — todos los tipos de campo básicos
- Extensiones de Meta Box — las extensiones más comunes (MB Text Limiter, MB Admin Columns, MB Custom Post Type, MB User Meta)
- MB Include Exclude (reglas de ubicación) — mapeadas a las reglas de ubicación de Field Forge
CMB2
- Definiciones de campos CMB2 — definidas en archivos PHP son detectadas e importadas
- Valores CMB2 — migrados de
wp_postmeta a la tabla personalizada de Field Forge
- Nota: CMB2 es código primero. La migración convierte campos definidos en PHP en grupos de campos de Field Forge para que obtengas un constructor visual mientras mantienes la compatibilidad con la API
Carbon Fields
- Definiciones de Carbon Fields — definidas en archivos PHP son detectadas e importadas
- Valores de Carbon Fields — migrados del almacenamiento a Field Forge
- Similar a CMB2, Carbon Fields es código primero
Qué se migra
Definiciones de grupos de campos
- Título y slug del grupo de campos
- Todas las definiciones de subcampos con los tipos de campo correctos
- Etiquetas de campo, nombres, banderas de requerimiento, valores predeterminados, instrucciones
- Reglas de ubicación (tipo de publicación, página, categoría, rol de usuario, etc.)
- Ajustes de posición y estilo
- Ajustes de ocultar en pantalla
- Reglas de lógica condicional
Valores de campo
- Todos los valores de campo existentes para cada publicación
- Valores para campos complejos (repetidor, contenido flexible, grupo, clon)
- Datos de repetidor anidado con relaciones correctas de padre-hijo
- Referencias de imágenes y archivos (preservadas como IDs, no re-subidas)
- Referencias de campos relacionales (IDs de publicaciones, IDs de usuarios, IDs de términos, todos preservados)
- Valores de fecha/hora en el formato correcto
- Contenido WYSIWYG con HTML preservado
Páginas de opciones
- Registros de páginas de opciones
- Todos los valores de campo de la página de opciones
- Asignaciones de grupos de campos a través de reglas de ubicación
Tipos de publicaciones personalizadas y taxonomías
- Si el plugin de origen define tipos de publicaciones personalizadas (Pods, Toolset), se migran
- Las taxonomías se migran con meta de término si es aplicable
Características específicas de ACF
acf_register_block_type() llamadas son detectadas y convertidas a bloques PHP de Field Forge- Archivos JSON de grupos de campos de la función Local JSON de ACF son importados en la sincronización JSON de Field Forge
Proceso de migración
Paso 1: Haz una copia de seguridad de tu base de datos
Siempre haz una copia de seguridad antes de la migración. Usa la herramienta de copia de seguridad de tu proveedor de hosting, UpdraftPlus, o wp db export a través de WP-CLI.
“bash wp db export backup-before-fieldforge.sql “
Paso 2: Instala Field Forge junto al plugin de origen
Field Forge puede ejecutarse simultáneamente con ACF, SCF, Meta Box, CMB2 o Carbon Fields durante la migración. No hay conflicto porque la capa de compatibilidad de ACF de Field Forge solo se activa cuando ACF no está en ejecución, y el almacenamiento propio de Field Forge está aislado del almacenamiento del plugin de origen.
Paso 3: Ve a Field Forge → Herramientas → Importar
La pantalla de Importación detecta automáticamente qué plugins de campos personalizados están activos en tu sitio. Verás una lista de plugins detectados con opciones de importación para cada uno.
Paso 4: Haz clic en “Iniciar Importación”
Selecciona el plugin de origen y haz clic en “Iniciar Importación.” Field Forge ejecuta la migración en lotes para evitar tiempos de espera de PHP en sitios grandes:
- Definiciones de grupos de campos — importadas primero (generalmente <10 segundos)
- Definiciones de páginas de opciones — importadas a continuación
- Valores de campo — migrados en lotes de 50 publicaciones por solicitud a través de AJAX
- Validación — verificación post-migración que cuenta las coincidencias
Una barra de progreso muestra:
- Total de publicaciones a migrar
- Publicaciones migradas hasta ahora
- Publicaciones por minuto
- Tiempo estimado restante
En un sitio con 10,000 publicaciones y grupos de campos complejos, la migración completa suele tardar de 15 a 45 minutos.
Paso 5: Verifica los datos migrados
Después de que la migración se complete, Field Forge ejecuta una verificación automática:
- El conteo de grupos de campos migrados coincide con el conteo de grupos de campos de origen
- El conteo de valores de publicaciones migrados coincide con el conteo de valores de publicaciones de origen
- Comparación de publicaciones de muestra: selecciona 10 publicaciones aleatorias y verifica que los valores de campo coincidan entre el almacenamiento de origen y Field Forge
- Cualquier discrepancia se lista con detalles
Si la verificación pasa, estás listo para desactivar el plugin de origen.
Paso 6: Prueba el sitio
Con ambos plugins aún activos, revisa páginas importantes:
- Página de inicio (grupos de campos globales)
- Algunas publicaciones usando campos personalizados
- Páginas de opciones
- Cualquier página de tipo de publicación personalizada
- Pantallas de administración (verifica que los grupos de campos aparezcan correctamente)
Si todo se ve bien, pasa al Paso 7.
Paso 7: Desactiva el plugin de origen
Con ACF (o SCF / Meta Box / CMB2 / Carbon Fields) desactivado, la capa de compatibilidad de ACF de Field Forge toma el control. Todas las llamadas a get_field(), have_rows(), etc. ahora resuelven al almacenamiento de Field Forge.
Paso 8: Verificación final
Revisa nuevamente las mismas páginas del Paso 6. Las plantillas deberían renderizarse de manera idéntica. Si una plantilla muestra datos faltantes o un error 500, reactiva el plugin de origen (los datos están a salvo) y contacta con el soporte de Field Forge.
Procesamiento por lotes para sitios grandes
La herramienta de migración se ejecuta en lotes de 50 publicaciones por solicitud por defecto (configurable). Esto previene tiempos de espera de PHP en sitios grandes y mantiene la migración reanudable: si algo interrumpe el proceso, puedes reiniciar desde donde se detuvo.
Para sitios con más de 50,000 publicaciones, recomendamos:
- Ejecutar durante horas de bajo tráfico
- Usar WP-CLI para una migración masiva más rápida:
wp fieldforge migrate --source=acf --batch-size=100
- Monitorear con
wp fieldforge migrate-status para seguir el progreso
Seguridad de los datos
La migración de Field Forge es no destructiva:
- Los datos del plugin de origen permanecen en su lugar durante la migración
- La migración copia datos en el almacenamiento de Field Forge sin modificar el origen
- Si desactivas Field Forge, los datos del plugin de origen quedan intactos
- Si desactivas el plugin de origen después de la migración, los datos de Field Forge toman el control y los datos de origen permanecen en la base de datos como respaldo
Si la migración falla por cualquier motivo, siempre puedes:
- Desactivar Field Forge
- Reactivar el plugin de origen
- Tu sitio vuelve a su estado original
¿Qué pasa si mi sitio utiliza hooks o filtros de campos personalizados?
La capa de compatibilidad de ACF cubre la API de funciones de plantilla (get_field(), have_rows(), etc.) utilizada por el 95% de los sitios. Para el 5% restante que utiliza hooks y filtros específicos de ACF (por ejemplo, acf/load_field, acf/save_post, extensiones de tipos de campo personalizados), puede que se necesiten ajustes en el código.
Field Forge tiene hooks equivalentes con el prefijo fieldforge/:
acf/load_field → fieldforge/load_fieldacf/save_post → fieldforge/save_postacf/format_value/type=text → fieldforge/format_value/type=text
Para la mayoría de los casos, una simple búsqueda y reemplazo en los archivos de tu tema o un plugin personalizado migrará tus hooks. Nuestro equipo de soporte puede ayudar si te encuentras con casos extremos.
Migración de ACF vs SCF
Dado que SCF es un fork directo de ACF (mismo formato de datos, misma API), la herramienta de migración los trata de manera idéntica. Si estás ejecutando SCF después del fork de WordPress.org de octubre de 2024, la herramienta de Importación lo detecta como “ACF” y ejecuta la misma lógica de migración.
¿Listo para migrar?
Obtén Field Forge — desde $35/año →
La herramienta de importación está incluida en cada plan de pago. Consulta nuestra guía completa de migración para recorridos paso a paso y solución de problemas.