28. Flux de travail JSON local

Le JSON local enregistre les définitions de groupes de champs en tant que fichiers .json dans votre thème, permettant le contrôle de version et le déploiement inter-environnements. Nécessite une licence PRO.

C’est le format JSON local propre à Field Forge et utilise fieldforge-json/ par défaut. L’outil de migration ACF comprend également les fichiers source JSON locaux d’ACF provenant de acf-json/group_*.json, de sorte qu’un site peut importer des groupes de champs ACF même lorsque les publications de base de données acf-field-group et acf-field sont absentes.

Configuration

1. Activez le JSON local dans Field Forge > Paramètres.
2. Créez le répertoire : your-theme/fieldforge-json/
3. Les groupes de champs se sauvegardent automatiquement dans ce répertoire lorsqu’ils sont modifiés.

your-theme/
  fieldforge-json/
    group_1_product-fields.json
    group_2_hero-section.json
    .htaccess          # Auto-created: "Deny from all"
    index.php          # Auto-created: silence

Synchronisation bidirectionnelle

Field Forge détecte les modifications JSON lors du chargement de l’administration :

• JSON vers DB : Les fichiers JSON nouveaux ou modifiés sont importés dans la base de données.
• DB vers JSON : Les modifications de la base de données sont exportées vers des fichiers JSON.

Flux de travail de déploiement

Development          Staging              Production
-----------          -------              ----------
1. Edit field        3. git pull          5. git pull
   groups in UI      4. Visit admin ->    6. Visit admin ->
2. git commit           auto-sync            auto-sync
   fieldforge-json/     JSON -> DB           JSON -> DB

Synchronisation programmatique

// Force export all groups to JSON
$local_json = FIELDFORGE_Local_JSON::instance();
$count = $local_json->save_all();

// Check for differences
$diff = $local_json->get_diff();
// Returns: ['new_in_json' => [...], 'new_in_db' => [...], 'modified' => [...], 'in_sync' => [1, 3]]

// Run sync (JSON wins)
$result = $local_json->sync( 'json_to_db' );

// Run sync (DB wins)
$result = $local_json->sync( 'db_to_json' );

—