Deux façons d’utiliser Field Forge avec Gutenberg

1. Groupes de champs en tant que métaboxes

C’est l’approche standard des champs personnalisés de WordPress. Créez un groupe de champs dans le constructeur visuel de Field Forge, assignez-le via des règles de localisation à un type de publication, et il apparaît comme une métabox lors de l’édition des publications de ce type.

Dans Gutenberg, les métaboxes peuvent être :

• En dessous de la zone de contenu — position=”normal” — en dessous de l’éditeur de blocs
• Dans la barre latérale — position=”side” — dans la barre latérale du document
• Dans la section avancée — position=”advanced” — repliée sous l’éditeur principal

Les trois positions fonctionnent nativement avec Gutenberg. Les éditeurs remplissent les valeurs des champs de la même manière qu’ils le feraient dans l’éditeur classique.

2. Blocs Gutenberg rendus par PHP

C’est ici que Field Forge devient plus intéressant pour les développeurs. Vous pouvez enregistrer des blocs Gutenberg personnalisés avec des rappels de rendu PHP, où le rappel de rendu a un accès complet aux champs personnalisés via get_field().

C’est la même approche que ACF Pro a popularisée avec acf_register_block_type() — et Field Forge prend en charge la même signature de fonction pour la compatibilité de migration.

“`php add_action(‘init’, function() { if (function_exists(‘acf_register_block_type’)) { acf_register_block_type([ ‘name’ => ‘hero-section’, ‘title’ => ‘Section Héros’, ‘description’ => ‘Une section héro avec titre, sous-titre et CTA.’, ‘render_callback’ => ‘render_hero_section_block’, ‘category’ => ‘theme’, ‘icon’ => ‘cover-image’, ‘keywords’ => [‘hero’, ‘section’], ‘supports’ => [ ‘align’ => [‘wide’, ‘full’], ‘anchor’ => true, ], ]); } });

function render_hero_section_block($block) { $title = get_field(‘title’); $subtitle = get_field(‘subtitle’); $background_image = get_field(‘background_image’); ?>

<img decoding="async" src="” alt=””>

<?php } ```

Assignez un groupe de champs à ce bloc via des règles de localisation :

“ Règles de Localisation : Le bloc est égal à "acf/hero-section" “

Lorsque un éditeur ajoute ce bloc à une publication Gutenberg, le groupe de champs se rend dans le panneau d’inspection du bloc. Les éditeurs remplissent les champs, le bloc se re-rend avec un aperçu en direct, et la sortie frontend provient du rappel PHP.

Fonctionnalité complète des blocs PHP →

---

Détection automatique des blocs FAQ

Field Forge détecte automatiquement le contenu de style FAQ construit avec les blocs Accordéon ou Détails de Gutenberg. Lorsqu’une publication utilise ces blocs, Field Forge les expose en tant que données structurées pour la génération de schéma FAQ (c’est l’intégration inter-plugin avec SEO Forge).

Vous n’avez pas besoin d’enregistrer manuellement les champs FAQ — Field Forge lit la structure du bloc et rend les données disponibles de manière programmatique.

---

Intégration des modèles de blocs

Les groupes de champs de Field Forge peuvent être utilisés à l’intérieur des modèles de blocs. Enregistrez un modèle réutilisable qui inclut un bloc personnalisé alimenté par Field Forge, et les éditeurs peuvent déposer le modèle dans n’importe quelle publication pour obtenir instantanément un bloc pré-configuré avec des champs personnalisés attachés.

---

Compatibilité avec l’Édition Complète du Site (FSE)

Pour les sites utilisant le mode d’Édition Complète du Site de WordPress (thèmes de blocs avec éditeur de site), Field Forge fonctionne normalement :

• Les groupes de champs se rendent dans les éditeurs de publication de thème de blocs
• Les blocs Gutenberg personnalisés enregistrés via acf_register_block_type() fonctionnent dans l’éditeur de site
• Les parties de modèle peuvent inclure des blocs alimentés par Field Forge
• Les styles globaux s’intègrent avec les blocs Field Forge via la configuration supports

---

Blocs dynamiques avec InnerBlocks

Pour des modèles de blocs plus complexes, combinez les blocs Field Forge avec le composant de Gutenberg :

“`php acf_register_block_type([ ‘name’ => ‘two-column-with-fields’, ‘render_callback’ => ‘render_two_column_block’, ‘supports’ => [ ‘inner_blocks’ => true, ], ]);

function render_two_column_block($block) { $sidebar_title = get_field(‘sidebar_title’); $sidebar_content = get_field(‘sidebar_content’); ?>

<?php } ```

La zone de la barre latérale est alimentée par des champs personnalisés, la zone principale est constituée de blocs Gutenberg standard. Les utilisateurs obtiennent le meilleur des deux mondes.

---

Performance

Les valeurs des champs de Field Forge sont chargées via le cache d’objet lors du premier rendu du bloc, et les rendus suivants sur la même page sont des hits de cache. Pour les pages avec plusieurs blocs personnalisés, cela signifie une requête de base de données par champ unique, peu importe combien de blocs l’utilisent.

Combiné avec le stockage de table personnalisé, les pages Gutenberg avec de nombreux blocs alimentés par Field Forge se chargent plus rapidement que les pages équivalentes alimentées par ACF.

---

Migration des enregistrements de blocs ACF

Si vous avez des appels existants à acf_register_block_type() dans votre thème, ils continueront à fonctionner sans changement après la migration d’ACF à Field Forge. La couche de compatibilité implémente acf_register_block_type() avec la même signature, redirigeant vers l’enregistrement de blocs de Field Forge en interne.

Aucun changement de code n’est nécessaire. Vos blocs Gutenberg continuent de se rendre via des rappels PHP qui utilisent get_field() — qui résout maintenant vers le stockage de Field Forge au lieu de celui d’ACF.

---

Prêt à utiliser Field Forge dans l’éditeur de blocs ?

Obtenez Field Forge — à partir de $35/an →

L’intégration de Gutenberg est incluse dans chaque version de Field Forge, y compris la version gratuite.