Si tu sitio actualmente utiliza ACF Pro (Advanced Custom Fields), Field Forge puede importar todos tus grupos de campos, configuraciones, lógica condicional y datos de campo. La migración está diseñada para ser fluida: tu tema sigue funcionando sin ningún cambio de código porque Field Forge proporciona las mismas funciones de plantilla que ACF (get_field(), the_field(), have_rows(), y todas las demás).
Esta sección proporciona un proceso de migración meticuloso, paso a paso, con verificación en cada etapa y un plan de reversión completo. Migrar definiciones de campo entre plugins es un cambio significativo, y vale la pena ser exhaustivo.
Antes de Tocar Nada: Lista de Verificación Pre-Migración
Completa cada elemento de esta lista de verificación antes de comenzar la migración:
| Paso | Acción | Cómo Verificar |
|---|---|---|
| 1 | Crea una copia de seguridad completa del sitio — base de datos y archivos | Descarga una copia de seguridad usando tu panel de hosting, UpdraftPlus, o un plugin de copia de seguridad similar. Verifica que puedes acceder al archivo de copia de seguridad. |
| 2 | Anota tu versión actual de ACF Pro | Ve a Plugins > Plugins Instalados, encuentra ACF Pro, anota el número de versión |
| 3 | Cuenta tus grupos de campos ACF | Ve a ACF > Grupos de Campos, anota el número total |
| 4 | Identifica tus grupos de campos más críticos | Elige de 3 a 5 grupos de campos que alimenten las partes más visibles de tu sitio (secciones principales, páginas de productos, páginas de destino clave) |
| 5 | Prueba esas páginas críticas | Visita de 3 a 5 páginas clave en el frontend y toma capturas de pantalla o notas de cómo se ven en este momento — esta es tu referencia “antes” |
| 6 | Mantén ACF Pro activo | NO desactives ACF aún — Field Forge lee de él durante la migración |
| 7 | Activa tu licencia PRO de Field Forge | Ve a Field Forge > Licencia y activa — necesitas PRO para migrar valores de campo (no solo definiciones de grupos de campos) |
| 8 | Verifica los recursos de tu hosting | Los sitios grandes necesitan suficiente memoria PHP (256MB+) y tiempo de ejecución (300 segundos+). Pregunta a tu proveedor si no estás seguro. |
| 9 | Elige un momento de bajo tráfico | Realiza la migración cuando tu sitio tenga visitantes mínimos, en caso de que algo interrumpa temporalmente el frontend |
| 10 | Informa a tu equipo de contenido | Dile a los editores que eviten editar publicaciones durante la ventana de migración |
Paso 1: Detectar Datos de ACF
- Ve a Field Forge > Migración en el admin de WordPress
- Haz clic en Detectar Datos de ACF
- Field Forge escanea tu sitio e informa lo que encuentra:
– Número de publicaciones/páginas con datos de campo ACF
– Total de valores de campo almacenados en la base de datos
– Lista de características de ACF en uso (Repetidores, Contenido Flexible, Páginas de Opciones, etc.)
- Revisa el resumen cuidadosamente. El número de grupos de campos debería coincidir con lo que contaste en la lista de verificación pre-migración. Si los números son muy diferentes, investiga antes de continuar.
- Anota si el resumen menciona tipos de campo solo para PRO (Repetidores, Contenido Flexible, Grupos, Clon). Si lo hace, confirma que tu licencia PRO de Field Forge está activa.
[Captura de pantalla: la pantalla de Migración mostrando resultados de detección — “Encontrados 12 grupos de campos, 847 publicaciones con datos de campo, 4,231 valores de campo en total”]
Paso 2: Importar Grupos de Campos (Solo Estructura)
Este paso importa las definiciones de los grupos de campos — los campos en sí, sus tipos, configuraciones, reglas de ubicación y diseño. No toca los datos de contenido reales.
- Haz clic en Importar Grupos de Campos
- Field Forge convierte cada grupo de campos ACF al formato de Field Forge
- Un indicador de progreso muestra cada grupo que se está procesando
- Todo se preserva:
– Reglas de ubicación (qué publicaciones/páginas muestran cada grupo de campos)
– Orden de los campos y configuraciones de ancho de contenedor
– Reglas de lógica condicional
– Campos de diseño de Pestaña, Acordeón y Mensaje
– Subcampos dentro de Grupos, Repetidores y diseños de Contenido Flexible, incluyendo estructuras profundamente anidadas
– Grupos de campos solo de ACF Local JSON de acf-json/group_*.json, incluso si las publicaciones de base de datos de grupos de campos ACF correspondientes no están presentes
- Aparece un mensaje de éxito que lista cuántos grupos fueron importados
- Verificación: Ve a Field Forge > Grupos de Campos y cuenta los grupos importados. El número debería coincidir con el conteo de ACF.
- Verificación: Abre de 2 a 3 grupos de campos importados y verifica que los campos, sus tipos y sus configuraciones se vean correctos
- Verificación: Abre una publicación en el editor que debería mostrar uno de estos grupos de campos. Ahora deberías ver el grupo de campos apareciendo dos veces — una vez de ACF y otra vez de Field Forge. Esto es esperado en esta etapa.
Paso 3: Importar Valores de Campo (Datos — Se Requiere PRO)
Este paso migra el contenido real — todo lo que tus editores han escrito en los campos ACF en publicaciones y páginas. Este es el paso más crítico.
- Haz clic en Importar Grupos de Campos con Valores
- Aparece una barra de progreso mostrando el estado de la migración
- Field Forge procesa publicaciones en lotes de 50 para mayor fiabilidad
- Para sitios pequeños (menos de 500 publicaciones), esto se completa en menos de un minuto
- Para sitios grandes (miles de publicaciones), la migración se ejecuta en segundo plano — puedes cerrar la pestaña del navegador y continúa procesando. Aparece una notificación en el admin cuando termina.
- Espera el aviso de finalización antes de continuar
- Verificación: Abre de 5 a 10 publicaciones de diferentes tipos de publicaciones y verifica que:
– Los campos de texto contienen el texto correcto
– Los campos de imagen muestran las imágenes correctas
– Los campos de selección/casilla de verificación/radio tienen las selecciones correctas
– Las filas de Repetidor están intactas con todos sus datos de subcampo
– Los campos de Grupo preservan sus valores hijos
– Los diseños de Contenido Flexible están en el orden correcto con los datos correctos
– Si un diseño de Contenido Flexible contiene un Repetidor anidado, arrastra una fila anidada, haz clic en Actualizar y confirma que el orden de las filas persiste sin filas duplicadas
Paso 4: Verificar el Frontend
Aquí es donde tus capturas de pantalla “antes” de la lista de verificación pre-migración se vuelven esenciales.
- Visita las 3-5 páginas críticas que documentaste antes de la migración
- Compáralas con tus capturas de pantalla/notas — todo debería verse idéntico
- Verifica las páginas que usan Repetidores (páginas de equipo, secciones de preguntas frecuentes, tablas de precios) — verifica que todas las filas aparezcan
- Verifica las páginas que usan Contenido Flexible — verifica que todas las secciones aparezcan en el orden correcto
- Verifica el encabezado y pie de página del sitio — si utilizan datos de Páginas de Opciones, verifica que el número de teléfono, logo, enlaces sociales, etc. aún aparezcan
- Prueba también en móvil — los diseños responsivos no deberían verse afectados
Paso 5: Desactivar ACF Pro (Cuando Estés Listo)
Solo procede a este paso después de una verificación exhaustiva. No hay prisa.
- Ve a Plugins > Plugins Instalados
- Encuentra ACF Pro en la lista
- Haz clic en Desactivar (no Eliminar — desactiva solo por ahora)
- Inmediatamente visita tus 3-5 páginas críticas del frontend nuevamente
- Todo debería seguir viéndose idéntico porque Field Forge proporciona todas las mismas funciones de plantilla
- Verifica el editor de WordPress — las publicaciones deberían mostrar metaboxes de Field Forge (no metaboxes de ACF)
- Si todo funciona, deja ACF Pro desactivado durante al menos una semana mientras tu equipo utiliza el sitio normalmente
- Después de una semana de funcionamiento sin problemas, puedes eliminar ACF Pro si lo deseas — pero no hay ningún daño en dejarlo desactivado como red de seguridad
El Plan de Reversión
Si algo sale mal en cualquier etapa:
| Problema | Solución |
|---|---|
| Grupos de campos importados incorrectamente | Elimina los grupos de campos de Field Forge y vuelve a ejecutar la importación |
| Valores de campo faltantes o incorrectos | Vuelve a ejecutar la migración de valores — es idempotente y elimina registros duplicados de grupos ACF antes de importar valores |
| Las páginas del frontend se ven diferentes después de desactivar ACF | Reactiva ACF Pro inmediatamente — el sitio vuelve a su estado anterior |
| La migración falló o se agotó el tiempo | Revisa los registros de errores del servidor por problemas de memoria o tiempo de espera. Aumenta la memoria PHP a 512MB y el tiempo máximo de ejecución a 600 segundos, luego vuelve a intentarlo. |
| Quieres deshacer todo | Restaura la copia de seguridad completa que creaste en la lista de verificación pre-migración. Esto devuelve todo el sitio a su estado exacto anterior a la migración. |
Referencia de Compatibilidad de Migración
| Característica de ACF | Soportada en la Migración | Notas |
|---|---|---|
| Todos los tipos de campo básicos (texto, número, imagen, etc.) | Sí | |
| Selección, casilla de verificación, radio, verdadero/falso, grupo de botones | Sí | |
| Selector de fecha, selector de color | Sí | |
| Pestañas, acordeones, mensajes | Sí | |
| Repetidores | Sí | Requiere PRO |
| Grupos | Sí | Requiere PRO |
| Contenido Flexible | Sí | Requiere PRO |
| Campos Clon | Sí | Requiere PRO |
| Páginas de Opciones y sus datos | Sí | Requiere PRO |
| Lógica Condicional | Sí (campos de nivel superior) | Las reglas en campos de nivel superior se importan y evalúan en tiempo de ejecución. Las reglas en campos anidados dentro de Repetidor / Grupo / Contenido Flexible se importan pero aún no se evalúan — cada campo anidado aún se renderiza. |
| Reglas de ubicación | Sí | |
| Valores de campo (datos de contenido de publicación) | Sí | Requiere PRO |
| Archivos JSON locales | Sí | Field Forge puede importar definiciones de grupos de campos solo de ACF Local JSON de acf-json/group_*.json; la sincronización continua de Field Forge utiliza fieldforge-json/. |
| Bloques ACF (bloques de Gutenberg) | Beta / revisión manual | Definiciones de bloques ACF simples pueden ser mapeadas a Bloques PHP de Field Forge (PRO), pero los callbacks de renderizado personalizados, activos de bloques y código de registro específico de tema deben ser revisados manualmente antes de eliminar ACF Pro. |
> Bueno saber: La migración no modifica ni elimina ningún dato de ACF. Ambos plugins pueden coexistir mientras verificas todo. Tus datos originales de ACF permanecen en la tabla wp_postmeta incluso después de la migración. Solo elimina ACF Pro después de pruebas prolongadas que confirmen que todo funciona.
> Importante: Si tu sitio utiliza funciones de ACF en plugins personalizados (no solo en el tema), prueba esos plugins después de la migración también. Field Forge proporciona todas las funciones estándar de ACF, pero internals de ACF inusuales o no documentadas podrían comportarse de manera diferente. Prueba exhaustivamente.
> Consejo: Para sitios empresariales grandes con decenas de miles de publicaciones, considera migrar durante una ventana de mantenimiento y usar la función de migración en segundo plano. Comunica la ventana a todo tu equipo de contenido para que nadie esté editando publicaciones mientras se migran los valores.
—