Parte 1: Antes de empezar

¿Por qué migrar?

Antes de invertir tiempo en la migración, asegúrate de que el cambio vale la pena. Razones para migrar de ACF o SCF a Field Forge:

• Rendimiento — El almacenamiento en tablas personalizadas de Field Forge es de 3 a 10 veces más rápido en sitios con más de 1,000 publicaciones o repetidores complejos.
• Generación de esquemas AI — única de Field Forge, ahorra un 80% del tiempo en la configuración de grupos de campos.
• Herramientas de WordPress sin cabeza — Generación automática de TypeScript y GraphQL.
• Precio — Field Forge Personal $35/año frente a ACF Pro $49/año; Agencia $169 frente a ACF Agencia $249.
• Incertidumbre del fork de ACF/SCF — escapa del drama de WP Engine / WordPress.org con un plugin que no está involucrado.
• Versionado de esquemas — nunca pierdas un cambio en el grupo de campos; retroceso con un clic.
• Arquitectura moderna — Field Forge fue construido para WordPress en 2026, no en 2016.

Si ninguna de estas razones se aplica a tu situación, quédate en ACF o SCF. La migración tiene un costo (tiempo, pruebas, riesgo) y solo debes migrar si los beneficios superan ese costo.

Verificación de compatibilidad

Antes de migrar, verifica que tu código específico de ACF no tenga casos límite en la capa de compatibilidad de Field Forge.

Cosas que funcionan desde el principio:

• 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() (bloques PHP de Gutenberg)
• get_field('name', 'options') y get_field('name', 'option') (páginas de opciones)
• get_field('name', 'user_123') (campos personalizados de usuario)
• format_value parámetro en todas las funciones
• Todos los 32 tipos de campos (texto, imagen, repetidor, contenido flexible, relación, etc.)

Cosas que necesitan ajustes:

• Hooks específicos de ACF como acf/load_field, acf/save_post, acf/format_value/type=text — estos tienen equivalentes en Field Forge (fieldforge/load_field, etc.) que tu código necesitará actualizar. La capa de compatibilidad de Field Forge NO reenvía los hooks de ACF a su propio sistema de hooks.
• Extensiones de tipos de campos personalizados registradas a través del sistema de hooks de ACF — estas necesitan ser registradas nuevamente utilizando la API de registro de tipos de campos de Field Forge.
• Clases internas de PHP de ACF accedidas directamente (por ejemplo, ACFAdminAdminFields) — estas no existen en Field Forge.
• API interna de JavaScript de ACF (acf.addAction(), etc.) — Field Forge tiene su propia API de JS.

Para el 95% de los sitios, nada de lo anterior importa. Los temas típicamente solo utilizan las funciones de plantilla, no las APIs internas.

Cómo auditar tu código:

Ejecuta un grep en los archivos de tu tema y plugins personalizados:

“`bash

Encuentra todas las llamadas a funciones de plantilla de ACF (deberían funcionar)

grep -r “get_field|have_rows|the_sub_field|acf_register_block_type” wp-content/themes/tu-tema/

Encuentra hooks específicos de ACF (necesitan ajustes)

grep -r “add_action.‘acf/|add_filter.‘acf/” wp-content/themes/tu-tema/

Encuentra el uso de clases internas de ACF (necesitan reescritura)

grep -r “\\ACF\\|use ACF” wp-content/themes/tu-tema/ “`

Si el primer grep devuelve resultados y los dos segundos están vacíos, estás en el claro — la migración directa funciona. Si el segundo o tercero devuelve resultados, planifica actualizaciones adicionales de código después de la migración.

---

Parte 2: Copia de seguridad (crítica)

Copia de seguridad completa de la base de datos

Siempre haz una copia de seguridad antes de la migración. Esto es innegociable.

A través de la herramienta de tu host: La mayoría de los hosts de WordPress gestionados (Kinsta, WP Engine, SiteGround, Cloudways, etc.) tienen copia de seguridad de base de datos con un clic. Úsala.

A través de WP-CLI: “bash wp db export backup-before-fieldforge-$(date +%Y%m%d).sql “

Esto crea un volcado SQL de toda tu base de datos. Mantenlo en un lugar seguro (descárgalo localmente, súbelo a S3, etc.). Si la migración sale mal, puedes restaurar desde este volcado.

A través de un plugin: UpdraftPlus, BackupBuddy, BackWPup, o similar. Ejecuta una copia de seguridad completa — base de datos Y archivos — antes de continuar.

Copia de seguridad de archivos

Haz una copia de seguridad de todo tu directorio wp-content/ también. Si estás utilizando la función Local JSON de ACF, los archivos JSON están en wp-content/themes/tu-tema/acf-json/.

Entorno de staging (recomendado)

Si es posible, realiza la migración primero en un entorno de staging. Clona tu sitio de producción a staging, ejecuta la migración, verifica que todo funcione, luego repite en producción. La mayoría de los hosts gestionados ofrecen clonación de staging con un clic.

Si no tienes staging, realiza la migración durante horas de bajo tráfico.

---

Parte 3: Instalar Field Forge

Descargar el plugin

Ve a precios de Field Forge y compra una licencia. Recibirás un enlace de descarga para el archivo ZIP del plugin Field Forge.

O instala la versión gratuita desde WordPress.org:

1. Admin de WordPress → Plugins → Añadir Nuevo
2. Buscar “Field Forge”
3. Instalar y activar

Nota: la versión gratuita cubre las funciones básicas de migración. Los planes de pago desbloquean la generación AI, TypeScript, GraphQL y algunos tipos de campos avanzados.

Subir y activar

1. Admin de WordPress → Plugins → Añadir Nuevo → Subir Plugin
2. Selecciona el archivo ZIP de Field Forge
3. Instalar Ahora → Activar Plugin

Field Forge ahora aparece en tu menú de administración de WordPress. ACF (o SCF) sigue activo — lo desactivarás más tarde.

Activar tu licencia

Si compraste un plan de pago, activa la licencia:

1. Field Forge → Configuración → Licencia
2. Pega tu clave de licencia
3. Haz clic en Activar Licencia

Recibirás una confirmación de que la licencia es válida.

Confirma que Field Forge y ACF no entran en conflicto

La capa de compatibilidad de ACF de Field Forge es inteligente al funcionar junto a ACF. Cuando ambos plugins están activos:

• ACF continúa sirviendo todas las llamadas a funciones de plantilla (get_field(), etc.)
• Field Forge NO sobrescribe las funciones de ACF (porque ACF sigue siendo la fuente autorizada)
• Field Forge registra sus propias pantallas de administración junto a las de ACF
• Puedes configurar grupos de campos de Field Forge sin afectar a ACF

Esto significa que no hay conflicto durante la migración. Puedes trabajar en las pantallas de administración de ambos plugins simultáneamente.

---

Parte 4: Ejecutar la importación

Abrir la herramienta de importación

1. Admin de WordPress → Field Forge → Herramientas → Importar
2. Verás una lista de plugins de campos personalizados detectados (ACF, SCF, Meta Box, CMB2, Carbon Fields)
3. Haz clic en Importar desde Advanced Custom Fields (o Secure Custom Fields)

Configurar opciones de importación

La pantalla de configuración de importación ofrece varias opciones:

• Importar grupos de campos — importa definiciones de grupos de campos de ACF a Field Forge (requerido)
• Importar valores de campos — migra todos los valores de campos existentes de wp_postmeta a la tabla personalizada de Field Forge (recomendado)
• Importar valores de páginas de opciones — migra datos de páginas de opciones (si usas Páginas de Opciones de ACF)
• Tamaño del lote — publicaciones por solicitud (predeterminado 50, menor para hosts lentos, mayor para hosts rápidos)
• Omitir valores de campos vacíos — no migrar campos con valores vacíos (ahorra tiempo y almacenamiento)
• Prueba en seco — simula la migración sin hacer cambios (bueno para previsualizar)

Comienza con los valores predeterminados. Si la migración encuentra errores, ajusta las opciones y vuelve a ejecutar.

Ejecutar la importación

Haz clic en Iniciar Importación. Aparecerá una barra de progreso que muestra:

• Fase actual (grupos de campos → valores de campos → páginas de opciones → verificación)
• Publicaciones procesadas / total de publicaciones
• Tiempo transcurrido / tiempo estimado restante
• Errores (si los hay)

La importación se ejecuta en lotes de 50 publicaciones por solicitud AJAX. El agrupamiento evita tiempos de espera de PHP en sitios grandes y proporciona un progreso visible.

Tiempo esperado

• <100 publicaciones: 1–2 minutos
• 100–1,000 publicaciones: 3–10 minutos
• 1,000–10,000 publicaciones: 15–45 minutos
• 10,000+ publicaciones: 45 minutos a 2 horas

Durante la importación, no cierres la pestaña del navegador. Si la cierras accidentalmente, la importación se pausa; vuelve a abrir la página de importación y haz clic en Reanudar Importación.

---

Parte 5: Verificar la migración

Verificación automática

Después de que la importación se complete, Field Forge realiza verificaciones automáticas:

• Conteo de grupos de campos — el número de grupos migrados coincide con el número de grupos de origen.
• Conteo de valores de campos — verificaciones aleatorias en publicaciones para confirmar que los valores se migraron.
• Integridad del esquema — verifica que las definiciones de campos sean válidas.
• Páginas de opciones — confirma que los datos de las páginas de opciones sean accesibles.

Verás una marca de verificación verde junto a cada paso de verificación, o una alerta amarilla/roja si algo necesita atención.

Verificación manual

No te fíes solo de las verificaciones automáticas. Verifica páginas importantes:

1. Verifica una publicación típica con campos personalizados

Ve a Admin de WordPress → Publicaciones → elige una publicación que use campos personalizados → desplázate hasta el metabox de Field Forge → verifica que los valores de los campos coincidan con los que están en el metabox de ACF arriba.

2. Verifica una página con contenido flexible

Si usas campos de contenido flexible, verifica una página con múltiples diseños. Todos los diseños deberían aparecer en el metabox de Field Forge con los valores de campo correctos.

3. Verifica una página con repetidores

Si usas campos repetidores, verifica que todas las filas estén presentes con los valores de subcampo correctos.

4. Verifica las páginas de opciones

Ve a cualquier página de opciones (Configuración del Sitio, Configuración del Encabezado, etc.) — los valores deberían aparecer tanto en la vista de la página de opciones de ACF COMO en la versión de Field Forge.

5. Verifica el frontend

Carga la página de inicio y varias páginas clave en un navegador. ACF sigue activo en este punto, por lo que el renderizado en el frontend aún proviene de ACF. Confirma que nada se haya roto durante el proceso de migración.

Si la verificación falla

Si alguna verificación falla:

1. No entres en pánico. ACF sigue activo; tu sitio sigue sirviendo contenido normalmente.
2. Revisa el registro de errores. Field Forge registra errores detallados en el registro de errores de WordPress o en la administración de Field Forge en Herramientas → Registros.
3. Vuelve a ejecutar la importación. A veces, errores transitorios (tiempos de espera, problemas temporales de base de datos) se resuelven al reintentar.
4. Verifica tipos de campos específicos que fallaron. El registro de Field Forge identifica qué tipos de campos tuvieron problemas.
5. Contacta con soporte — [email protected] con detalles sobre la falla.

---

Parte 6: Desactivar ACF (el paso crítico)

Este es el momento de la verdad. Desactivar ACF activa la capa de compatibilidad de Field Forge — todas las llamadas a get_field() de tu tema ahora se resolverán en el almacenamiento de Field Forge en lugar del de ACF.

Antes de desactivar

• Verifica que todo esté migrado (Parte 5)
• Confirma que el frontend se vea correcto con ACF aún activo
• Ten tu copia de seguridad lista (Parte 2)
• Elige un momento de bajo tráfico si este es un sitio de producción

Desactivar ACF

Admin de WordPress → Plugins → Plugins Instalados → Advanced Custom Fields → Desactivar

NO hagas clic en “Eliminar” aún — queremos que ACF esté disponible como respaldo si algo sale mal.

Qué sucede inmediatamente

En el momento en que ACF se desactiva:

• Las funciones de plantilla de ACF (get_field, etc.) dejan de ser registradas por ACF.
• La capa de compatibilidad de Field Forge detecta esto y registra sus propias implementaciones.
• Las llamadas de plantilla ahora se resuelven en el almacenamiento de Field Forge.
• Las pantallas de administración de Field Forge toman el control de la navegación de “Campos Personalizados”.

Prueba el frontend

Recarga inmediatamente el frontend:

1. Página de inicio — ¿se ve correcta?
2. Una página con contenido flexible — ¿se renderizan todas las secciones?
3. Una página con un repetidor — ¿se muestran todas las filas?
4. Páginas de opciones — ¿aparecen las configuraciones globales (nombre del sitio, URLs sociales, etc.)?
5. Un bloque PHP de Gutenberg (si usas acf_register_block_type()) — ¿se renderiza?

Si todo se ve correcto, la migración es exitosa. Celebra.

Si algo está roto, ve a la Parte 8 (Solución de Problemas) a continuación.

---

Parte 7: Limpieza y optimización

Eliminar ACF (después de 1 semana)

Espera 1 semana con Field Forge activo antes de eliminar ACF por completo. Esto te da tiempo para descubrir cualquier caso límite que no se haya detectado en la verificación inmediata. Si surgen problemas, reactiva ACF como respaldo mientras depuras.

Después de 1 semana de operación estable:

1. Admin de WordPress → Plugins → Plugins Instalados
2. Advanced Custom Fields → Eliminar
3. Confirma la eliminación
4. ACF ha desaparecido de tu sitio

Opcional: limpiar wp_postmeta

Después de la migración, los datos de ACF aún están en wp_postmeta (la migración de Field Forge es no destructiva — copia datos, no elimina de la fuente). Estos datos adicionales ocupan espacio pero no dañan nada.

Si deseas limpiarlo:

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

ADVERTENCIA: Este SQL es aproximado y peligroso. Solo ejecútalo si te sientes cómodo con operaciones de base de datos Y tienes una copia de seguridad reciente. El soporte de Field Forge puede ayudar con una consulta de limpieza más segura adaptada a tus grupos de campos específicos.

La mayoría de los sitios no se molestan con esta limpieza — el almacenamiento adicional es insignificante.

Optimizar la configuración de Field Forge

Ahora que estás completamente en Field Forge, aprovecha sus características:

1. Habilitar Sincronización de JSON Local — guarda grupos de campos como archivos JSON en tu tema para versionado git (Field Forge → Configuración → JSON Local)
2. Habilitar caché de objetos — si tienes Redis o Memcached, Field Forge lo utiliza automáticamente.
3. Ejecutar carga por lotes en páginas de archivo a través de etiquetas de plantilla personalizadas para un rendimiento aún más rápido.
4. Prueba la generación de esquemas AI — en el próximo grupo de campos que crees, prueba el generador AI en lugar de construir manualmente.
5. Generar tipos de TypeScript — si tienes un frontend sin cabeza, descarga los archivos .d.ts desde la administración de Field Forge.

---

Parte 8: Solución de problemas

“Valores de campo faltantes” después de desactivar ACF

Síntoma: Una publicación que tenía valores de campos personalizados en ACF aparece vacía en Field Forge después de que ACF se desactiva.

Causa: El valor del campo no se migró durante la importación. Esto puede suceder si:

• El campo se agregó a ACF después de la última vez que se guardó una publicación.
• El campo tiene un formato de almacenamiento inusual (muy raro).
• La importación se interrumpió antes de que se procesara esta publicación específica.

Solución:

1. Reactiva ACF (los datos están seguros).
2. Ve a Field Forge → Herramientas → Importar.
3. Vuelve a ejecutar la importación con la opción “Reanudar” o “Reejecutar Completo”.
4. El importador volverá a verificar todas las publicaciones y recogerá cualquier valor que se haya perdido.
5. Desactiva ACF nuevamente y vuelve a verificar.

“Plantilla rota” después de desactivar ACF

Síntoma: Una plantilla que solía renderizar correctamente ahora lanza un error PHP o muestra contenido inesperado.

Causa: La plantilla está utilizando una función o hook específico de ACF que la capa de compatibilidad de Field Forge no cubre.

Solución:

1. Reactiva ACF.
2. Revisa los registros de errores PHP para la función / hook específico que falló.
3. Identifica qué API específica de ACF está utilizando la plantilla.
4. Actualiza la plantilla para usar el equivalente de Field Forge.
5. Desactiva ACF nuevamente.

Los culpables más comunes:

• acf_add_local_field_group() — usa fieldforge_register_field_group() en su lugar.
• acf_form() — usa Form Forge o un constructor de formularios diferente.
• Tipos de campos personalizados registrados a través del hook acf/include_field_types — vuelve a registrar a través del filtro fieldforge/field_types/register.

“Rendimiento más lento después de la migración”

Síntoma: Las páginas se cargan más lentamente después de cambiar a Field Forge.

Causa: Raro pero posible. El almacenamiento en tablas personalizadas de Field Forge debería ser más rápido, no más lento. Si ves un rendimiento más lento:

• La caché de objetos no está configurada correctamente — Field Forge recae en consultas de base de datos.
• El WP_DEBUG de WordPress está habilitado con un archivo de registro grande.
• Un plugin diferente está causando la desaceleración (sincronización coincidente).

Solución:

1. Verifica que tu plugin de caché de objetos esté activo y funcionando.
2. Desactiva WP_DEBUG y WP_DEBUG_LOG en producción.
3. Ejecuta Field Forge → Herramientas → Prueba de Rendimiento para medir páginas específicas.
4. Contacta con soporte con detalles de tiempo.

“La migración parece haber omitido las páginas de opciones”

Síntoma: Los valores de las páginas de opciones aparecen vacíos o por defecto después de la migración.

Causa: ACF almacena los valores de las páginas de opciones con un prefijo de clave diferente al de los valores de campo de publicación. El importador necesita manejar ambos casos.

Solución:

1. Ve a Field Forge → Herramientas → Importar.
2. Haz clic en Reimportar Páginas de Opciones.
3. Esto vuelve a ejecutar solo la migración de las páginas de opciones.

“Las filas de repetidor están en el orden incorrecto”

Síntoma: Los campos repetidores se migraron, pero las filas aparecen en un orden diferente al que estaban en ACF.

Causa: Rara condición de carrera durante la importación donde el row_index no se configuró correctamente.

Solución: Contacta con soporte con el nombre específico del grupo de campos. Esto es típicamente una solución única con una actualización SQL.

---

Parte 9: Retroceso (si lo necesitas)

Retroceso rápido

Si la migración sale mal y necesitas volver a ACF:

1. Reactiva ACF (Plugins → Plugins Instalados → ACF → Activar).
2. Desactiva Field Forge (Plugins → Plugins Instalados → Field Forge → Desactivar).
3. Las funciones de plantilla de ACF se vuelven a registrar.
4. Tu sitio vuelve a servir datos desde wp_postmeta (almacenamiento de ACF).
5. Todo funciona como antes del intento de migración.

La migración de Field Forge es no destructiva — los datos de ACF aún están en su lugar. El retroceso siempre es posible mientras no hayas eliminado ACF.

Retroceso completo al estado anterior a la migración

Si deseas deshacer completamente la migración y eliminar Field Forge:

1. Reactiva ACF.
2. Desactiva Field Forge.
3. Field Forge → Configuración → Eliminar Todos los Datos (elimina la tabla personalizada de Field Forge, revisiones, archivos JSON).
4. Desactiva y elimina Field Forge.
5. Tu sitio vuelve exactamente a donde estaba antes de la migración.

---

Preguntas frecuentes

¿Cuánto tiempo lleva una migración típica de ACF? 30–90 minutos para la mayoría de los sitios. Los sitios más grandes (10,000+ publicaciones) pueden tardar más de 2 horas.

¿Mis clasificaciones bajarán durante la migración? No. La migración no cambia URLs, contenido o metadatos que Google ve. Field Forge migra solo la capa de almacenamiento.

¿Puedo ejecutar ACF y Field Forge indefinidamente? Técnicamente sí durante la migración, pero no como una configuración de producción a largo plazo. Ejecutar ambos significa interfaces de administración duplicadas y confusión de configuración.

¿Qué pasa con las funciones de ACF Pro como Repetidor y Contenido Flexible? Los planes de pago de Field Forge incluyen todas las funciones de ACF Pro. Repetidor, Contenido Flexible, Grupo, Clon, Páginas de Opciones, Galería, Bloques PHP — todos funcionan después de la migración.

¿Necesito reescribir el código de mi tema? No. La capa de compatibilidad de ACF de Field Forge significa que el código existente sigue funcionando.

¿Qué pasa si tengo tipos de campos ACF personalizados de plugins de terceros? Los tipos de campos personalizados registrados a través del sistema de hooks de ACF necesitan ser registrados nuevamente para Field Forge. Contacta con soporte para ayuda con casos específicos.

¿Puedo migrar de Field Forge a ACF más tarde? Sí. La exportación de datos de Field Forge te permite exportar grupos de campos en formato compatible con ACF. Importa en ACF, desactiva Field Forge. Tu sitio sigue funcionando.

¿Es gratuita la migración? La versión gratuita de Field Forge en WordPress.org incluye las herramientas de migración. Solo necesitas una licencia de pago para funciones AI, generación de TypeScript/GraphQL y algunos tipos de campos avanzados.

¿La migración funciona también para SCF? Sí. SCF es un fork de ACF con el mismo formato de datos. El importador de ACF maneja ambos.

---

¿Listo para migrar?

Obtén Field Forge — desde $35/año →

Reembolso de 14 días. La versión gratuita incluye herramientas de migración. Soporte prioritario durante la migración.

¿Preguntas antes de empezar? Contacta a nuestro equipo de soporte de migración →