Esta receta proporciona un proceso de migración detallado y cauteloso con listas de verificación y pasos de verificación. Síguelo en orden para asegurar una transición suave.
Lista de Verificación Pre-Migración
Antes de comenzar, completa cada elemento de esta lista:
| Paso | Acción | ¿Hecho? |
|---|---|---|
| 1 | Crea una copia de seguridad completa del sitio (archivos + base de datos) | |
| 2 | Configura un sitio de prueba/escenario y realiza la migración allí primero | |
| 3 | Documenta tus grupos de campos ACF actuales (captura de pantalla o exportación) | |
| 4 | Anota cualquier grupo de campos registrado en PHP en el functions.php de tu tema | |
| 5 | Verifica si hay plugins que dependen de ACF (algunos plugins agrupan sus propios campos ACF) | |
| 6 | Instala Field Forge en tu sitio de prueba (NO desactives ACF aún) | |
| 7 | Si migras valores de campo, activa una licencia PRO de Field Forge | |
| 8 | Verifica que tu límite de memoria PHP sea al menos 256M y max_execution_time sea al menos 300 |
Paso 1: Detectar Datos de ACF
- Ve a Field Forge > Migración
- Haz clic en Detectar Datos de ACF
- Revisa los resultados del escaneo:
– Número de publicaciones con datos ACF
– Total de valores de campo a migrar
- Toma una captura de pantalla o anota estos números — los usarás para verificar la completitud de la migración más tarde
Paso 2: Importar Grupos de Campos
- Haz clic en Importar Grupos de Campos
- Espera a que se complete la importación
- Verifica los resultados:
– Abre 2-3 grupos de campos y verifica que todos los campos, configuraciones y reglas de ubicación coincidan con tu configuración de ACF
– Presta especial atención a los campos complejos: Repetidores, Contenido Flexible y Grupos deben tener todos sus subcampos intactos
- Si algo parece incorrecto, puedes eliminar los grupos importados y volver a ejecutar la importación — lee desde los datos de ACF, que no han cambiado
Paso 3: Migrar Valores de Campo (PRO)
- De vuelta en Field Forge > Migración, haz clic en Importar Grupos de Campos con Valores
- Aparece una barra de progreso que muestra el procesamiento por lotes
- Para sitios grandes, la migración se ejecuta en segundo plano — puedes cerrar la pestaña del navegador de forma segura
- Espera el aviso de finalización (verifica si cerraste la pestaña)
- Anota el conteo final: número de publicaciones procesadas y valores migrados
Paso 4: Verificación Post-Migración
Realiza estas verificaciones antes de desactivar ACF:
| Verificación | Cómo verificar | Resultado esperado |
|---|---|---|
| Existen grupos de campos | Field Forge > Grupos de Campos | Mismo número de grupos que en ACF |
| Los campos aparecen en las publicaciones | Edita una publicación que tenía datos ACF | Metabox con campos aparece debajo del editor |
| Los datos están poblados | Verifica los campos en varias publicaciones | Los valores coinciden con lo que se ingresó en ACF |
| Datos de Repetidor intactos | Abre una publicación con un repetidor | Todas las filas presentes con datos correctos |
| Contenido Flexible intacto | Abre una publicación con contenido flexible | Todos los diseños presentes en el orden correcto |
| Datos de la página de opciones | Visita la página de opciones | Todos los valores globales presentes |
| Visualización en el frontend | Ve el sitio en un navegador | Las páginas se ven idénticas a antes de la migración |
get_field() funciona | Prueba páginas que usan datos de campo | Sin errores, se muestran los valores correctos |
have_rows() funciona | Prueba páginas con repetidores | Los bucles funcionan correctamente |
Paso 5: Desactivar ACF
- Una vez que todas las verificaciones pasen, ve a Plugins
- Desactiva Advanced Custom Fields PRO
- Actualiza el frontend y verifica varias páginas — todo debería seguir funcionando porque Field Forge proporciona todas las mismas funciones
- Verifica el área de administración — todos los grupos de campos deberían seguir visibles y funcionales
Paso 6: Verificar que Todo Funciona Sin ACF
- Prueba cada plantilla de página que use campos personalizados
- Prueba cada formulario, repetidor y sección de contenido flexible
- Verifica las páginas de opciones y la configuración del sitio
- Prueba en múltiples dispositivos (escritorio, tablet, móvil)
- Pide a otro miembro del equipo que revise páginas clave
Problemas Comunes y Soluciones
| Problema | Causa | Solución |
|---|---|---|
| Error fatal después de desactivar ACF | Un plugin depende de ACF directamente (no a través de get_field()) | Reactiva ACF, identifica el plugin dependiente y contacta a su autor para compatibilidad con Field Forge |
| Algunos campos aparecen vacíos | Los valores de campo no fueron migrados (versión gratuita) | Actualiza a PRO y ejecuta la migración de valores |
| Filas de Repetidor en el orden incorrecto | Caso raro con datos profundamente anidados | Vuelve a ejecutar la migración; si persiste, contacta con soporte |
| Filas de Repetidor anidadas dentro de Contenido Flexible se duplican después de arrastrar y guardar | Las versiones anteriores reindexaban la fila de Contenido Flexible padre al ordenar el Repetidor anidado, luego leían los registros anidados desde el registro padre incorrecto | Actualiza Field Forge, actualiza el editor, reordena las filas anidadas una vez y guarda. Las versiones actuales reindexan solo el Repetidor activo y leen registros anidados por su ID de padre directo. |
| Valores de Grupo / Repetidor / Contenido Flexible anidados faltantes | Bases de datos antiguas de ACF pueden contener publicaciones de grupos de campos duplicados con la misma clave/título; un duplicado vacío puede ocultar el grupo poblado durante la importación | Actualiza Field Forge y vuelve a ejecutar la migración. Las versiones actuales eliminan duplicados de grupos ACF por clave/título y mantienen la versión con los campos hijos más directos antes de importar valores. |
| La lógica condicional no oculta campos | Reglas de nivel superior: confirma que “Lógica Condicional” está activada en la configuración del campo, el campo desencadenante de la regla tiene un valor y el par operador/valor coincide con tus datos. Las reglas anidadas (dentro de Repetidor / Grupo / diseños Flex) se almacenan pero aún no se evalúan. | Vuelve a abrir el editor del grupo de campos, expande el campo afectado y verifica que la regla lea el nombre de campo correcto. Para casos anidados, mueve la regla a un campo de nivel superior que controle la visibilidad del compuesto padre. |
| Página de opciones faltante | Las páginas de opciones requieren PRO | Activa la licencia PRO, luego vuelve a ejecutar la migración |
| Diseño del frontend roto | El tema depende de hooks específicos de ACF | Verifica si el tema utiliza hooks acf/ y cambia a equivalentes fieldforge/ |
| Archivos de exportación JSON que hacen referencia a claves ACF | Archivos JSON locales antiguos de ACF | Elimina los antiguos archivos acf-json/ en tu tema y vuelve a guardar los grupos de campos para que Field Forge regenere archivos frescos en fieldforge-json/ (la carpeta de sincronización predeterminada) |