Blocs Gutenberg Rendus en PHP — Compatible avec acf_register_block_type

Pourquoi des blocs rendus en PHP ?

Gutenberg (l’éditeur de blocs de WordPress) a été conçu autour de blocs rendus en JavaScript. Vous écrivez une fonction save() en JS qui retourne le HTML du bloc, et WordPress enregistre ce HTML dans le contenu de l’article. Pour des blocs visuels simples, cela fonctionne très bien.

Mais pour des blocs dynamiques — “Afficher les 3 derniers articles de blog avec un style personnalisé,” “Afficher un membre de l’équipe avec des données du profil de l’utilisateur actuel,” “Rendre une grille de produits à partir d’une requête WooCommerce” — les blocs JavaScript sont pénibles. Vous finissez par écrire des appels à l’API REST, gérer les états de chargement, et reconstruire la logique de récupération de données que WordPress sait déjà faire en PHP.

Les blocs rendus en PHP vous permettent d’écrire un rappel PHP qui s’exécute au moment du rendu de la page, a un accès complet aux API de données de WordPress (WP_Query, get_field(), get_post_meta(), etc.), et retourne le HTML directement. Plus simple, plus rapide, et plus conforme à l’idiome WordPress.

ACF a introduit acf_register_block_type() il y a des années et cela est devenu la norme de facto pour les développeurs d’agences construisant des blocs Gutenberg personnalisés. Field Forge prend en charge la même signature de fonction, donc la migration est triviale.

---

Comment enregistrer un bloc PHP

Exemple de base

“`php // functions.php ou un plugin personnalisé

add_action(‘acf/init’, ‘register_my_blocks’);

function register_my_blocks() { if (function_exists(‘acf_register_block_type’)) { acf_register_block_type([ ‘name’ => ‘feature-card’, ‘title’ => __(‘Carte de Fonctionnalité’), ‘description’ => __(‘Une carte de fonctionnalité avec icône, titre et description.’), ‘render_callback’ => ‘render_feature_card_block’, ‘category’ => ‘theme’, ‘icon’ => ‘star-filled’, ‘keywords’ => [‘feature’, ‘card’], ‘supports’ => [ ‘align’ => [‘wide’, ‘full’], ‘anchor’ => true, ‘color’ => true, ], ]); } }

function render_feature_card_block($block) { $icon = get_field(‘icon’); $title = get_field(‘title’); $description = get_field(‘description’); ?>

<?php } ```

Ce code est identique au code d’enregistrement d’ACF. Fonctionne sans changement après la migration.

Enregistrement natif de Field Forge

Si vous préférez l’API native de Field Forge (pour la propreté du code ou pour éviter d’impliquer qu’ACF est toujours nécessaire), utilisez fieldforge_register_block_type() :

“php add_action('init', function() { fieldforge_register_block_type([ 'name' => 'feature-card', 'title' => __('Carte de Fonctionnalité'), 'render_callback' => 'render_feature_card_block', 'category' => 'theme', ]); }); “

Les deux fonctions font la même chose. Utilisez celle qui correspond aux conventions de votre équipe.

---

Champs personnalisés dans le bloc

Chaque bloc PHP peut avoir son propre groupe de champs assigné via des règles de localisation :

“ Règles de localisation : Le bloc est égal à "acf/feature-card" “

Lorsque un éditeur ajoute le bloc à un article, Field Forge rend le groupe de champs dans la barre latérale du bloc (ou en ligne, selon les paramètres du bloc). L’éditeur remplit les champs, le bloc se met à jour automatiquement avec un aperçu en direct.

Au moment du rendu, la fonction render_callback utilise get_field() pour accéder aux valeurs des champs :

“`php function render_feature_card_block($block) { // get_field() fonctionne à l’intérieur des rappels de bloc $icon = get_field(‘icon’); $title = get_field(‘title’);

// Le tableau $block contient tout sur cette instance spécifique du bloc $block_id = $block[‘id’]; $is_preview = !empty($block[‘is_preview’]); $block_data = $block[‘data’]; $className = !empty($block[‘className’]) ? $block[‘className’] : ”;

// Rendre le HTML ?>

<div class="feature-card “>