La Sincronización Local de JSON guarda las definiciones de tus grupos de campos como archivos JSON dentro de la carpeta de tu tema. Esta función existe principalmente para flujos de trabajo de desarrollo donde un desarrollador utiliza control de versiones (como Git) para gestionar cambios en el código y desplegarlos a través de entornos (máquina local, servidor de staging, servidor de producción). Para la mayoría de los gestores de contenido, esta función se ejecuta silenciosamente en segundo plano y no requiere ninguna acción más allá de hacer clic ocasionalmente en un botón de “Sincronizar”.
No confundas esto con la carpeta Local JSON de ACF. Field Forge escribe sus propios archivos en fieldforge-json/ por defecto. Durante la migración desde ACF, Field Forge también puede leer los archivos acf-json/group_*.json de ACF como fuente cuando no existen registros de grupos de campos en la base de datos de ACF.
Esta sección explica qué hace la Sincronización JSON, por qué existe, cuándo podrías encontrarla y qué hacer cuando veas notificaciones de sincronización en el administrador.
Por qué Existe la Sincronización Local de JSON
Cuando un desarrollador construye un sitio, normalmente crea grupos de campos en su máquina local. Sin la Sincronización JSON, las definiciones de los grupos de campos viven solo en la base de datos. Para moverlas al servidor de staging o producción, el desarrollador tendría que exportar e importar manualmente archivos JSON cada vez que realiza un cambio. La Sincronización JSON automatiza esto escribiendo las definiciones de los grupos de campos en archivos dentro de la carpeta del tema. Estos archivos viajan con el código del tema a través del control de versiones, y cuando se despliega el código, Field Forge detecta los archivos nuevos o cambiados y los aplica.
Este flujo de trabajo es invisible para los gestores de contenido: los campos simplemente aparecen o se actualizan a medida que el desarrollador envía cambios.
Cómo Funciona Detrás de Escenas
- Cuando la Sincronización JSON está habilitada, cada vez que se guarda un grupo de campos en el administrador, Field Forge escribe un archivo JSON en
fieldforge-json/dentro del tema activo (el nombre de carpeta por defecto; se puede sobrescribir a través del filtrofieldforge/local_json/save_path) - El archivo JSON contiene la definición completa del grupo de campos: campos, tipos, configuraciones, diseño, reglas de ubicación, lógica condicional y orden
- El desarrollador incluye estos archivos en su repositorio de control de versiones (Git, SVN, etc.)
- Cuando se despliegan archivos actualizados en un servidor, Field Forge detecta que los archivos JSON son más nuevos que las versiones de la base de datos
- Aparece un aviso de sincronización en el administrador que te solicita aplicar las actualizaciones
Lo Que Necesitan Saber los Gestores de Contenido
La mayor parte del tiempo, la Sincronización JSON funciona de manera invisible. Aquí están las dos situaciones en las que podrías necesitar tomar acción:
Situación 1: Ves una notificación de “grupos de campos fuera de sincronización”- Ve a Field Forge > Grupos de Campos
- Verás un banner o insignia que indica que uno o más grupos de campos están fuera de sincronización con sus archivos JSON
- Haz clic en el botón Sincronizar
- Field Forge actualiza los grupos de campos de la base de datos para que coincidan con los archivos JSON
- La notificación desaparece
- Esto significa que tu desarrollador envió cambios: los campos actualizados ahora reflejan su trabajo
Si editas un grupo de campos en el administrador mientras la Sincronización JSON está habilitada, tus cambios se guardan en la base de datos Y se escriben en el archivo JSON en el tema. Si un desarrollador más tarde envía su propia versión de ese archivo JSON, podría haber un conflicto.
| Escenario | Qué Sucede |
|---|---|
| Solo el desarrollador cambió el archivo JSON | La sincronización aplica sus cambios de manera limpia cuando haces clic en Sincronizar |
| Solo tú cambiaste el grupo de campos en el administrador | Tus cambios están activos. El archivo JSON se actualizó con tus cambios. Si el desarrollador obtiene tu archivo JSON actualizado, verá tus cambios. |
| Tanto tú como el desarrollador cambiaron el mismo grupo de campos | Field Forge detecta un conflicto y muestra una advertencia. Tú eliges qué versión mantener. |
Habilitar o Deshabilitar la Sincronización JSON
- Ve a Field Forge > Configuración
- Encuentra el interruptor de Sincronización Local de JSON
- Actívalo o desactívalo
- La ruta de guardado es
fieldforge-json/dentro de la carpeta del tema activo. No hay un control de interfaz para esto: tu desarrollador puede sobrescribir la ruta a través del filtrofieldforge/local_json/save_pathsi necesita una ubicación personalizada. - Guarda la configuración
Detalles Clave Sobre los Archivos JSON
- Los archivos JSON son texto plano que contiene solo la estructura del grupo de campos: no contienen ningún contenido de publicación, datos del editor, información del usuario o archivos multimedia
- Guardar un grupo de campos con la sincronización habilitada escribe inmediatamente el archivo JSON correspondiente
- Eliminar un grupo de campos también elimina su archivo JSON
- La ruta de la carpeta de sincronización puede ser personalizada por tu desarrollador si utiliza una estructura de carpetas no estándar
- La Sincronización JSON funciona con cualquier sistema de control de versiones (Git, SVN, Mercurial, etc.)
- Si cambias de tema, los archivos JSON en la carpeta del antiguo tema ya no se detectan. Tu desarrollador puede necesitar moverlos o copiarlos.
Consejos de Comunicación para Equipos que Usan la Sincronización JSON
Si trabajas estrechamente con un desarrollador que utiliza la Sincronización JSON:
- Comunica antes de editar grupos de campos en el administrador. Si el desarrollador también está trabajando en cambios de grupos de campos en su código, las ediciones simultáneas crean conflictos.
- Informa al desarrollador cuando añadas o elimines campos. Puede que necesite actualizar las plantillas del tema para mostrar nuevos campos o eliminar referencias a los eliminados.
- Cuando veas una notificación de sincronización, haz clic en Sincronizar rápidamente. Retrasar la sincronización significa que tu base de datos tiene definiciones de campos obsoletas mientras que los archivos JSON tienen la versión más reciente. Esto puede causar confusión si editas un grupo de campos en el ínterin.
> Bueno saber: Si eres un gestor de contenido que nunca trabaja con archivos de tema o control de versiones, puedes ignorar esta función por completo. Se ejecuta silenciosamente si tu desarrollador la habilitó. La única vez que necesitas hacer algo es cuando aparece una notificación de sincronización: solo haz clic en el botón Sincronizar y habrás terminado.
> Consejo: Si accidentalmente haces cambios en un grupo de campos y deseas la versión del desarrollador en su lugar, utiliza la función de Sincronizar para sobrescribir tus cambios con la versión del archivo JSON. Por el contrario, si deseas que tus cambios se mantengan, guarda el grupo de campos en el administrador: el archivo JSON se actualiza para coincidir con tu versión.