Librairie de blocs Gutenberg - ACF
Librairie personnelle de blocs Gutenberg personnalisés développés avec ACF, pensée comme base réutilisable pour mes futurs projets WordPress, avec un premier bloc de lecture vidéo en lightbox.
- Date
- Déc. 2025
- Section
- Projets Personnels
Compétences démontrées
- Développer
- Entreprendre
Contexte
Je n'avais pas eu l'occasion de travailler sur des blocs Gutenberg personnalisés à l'agence Zetruc, où les projets ne s'y prêtaient pas. J'ai donc lancé ce projet en dehors du cadre client pour découvrir par moi-même le fonctionnement des blocs personnalisés avec ACF (Advanced Custom Fields), tout en me constituant une base réutilisable pour mes prochains projets WordPress.
Objectifs
- Découvrir le fonctionnement des blocs Gutenberg personnalisés avec ACF.
- Structurer un repository réutilisable de blocs Gutenberg personnalisés.
- Respecter les standards WordPress pour chaque bloc (block.json, template de rendu).
- Développer un premier bloc complet de bout en bout : lecture vidéo en lightbox.
Structure de la librairie
J'ai organisé le repository en un dossier `blocks/` contenant un sous-dossier par bloc, chacun avec son `block.json` conforme aux standards WordPress, son template PHP de rendu, ses styles optionnels et sa définition de champs ACF exportée en JSON dans `acf-json/`. Cette structure modulaire permet d'ajouter ou de copier un bloc dans un autre projet sans dépendances cachées.
Premier bloc : lecture vidéo en lightbox
Le premier bloc développé permet d'afficher une vidéo dans une lightbox Fancybox, avec deux sources possibles : un fichier MP4 uploadé directement, ou une URL externe (YouTube, Vimeo...). Pour les vidéos YouTube, la miniature est récupérée automatiquement à partir de l'ID de la vidéo, et la couleur du bouton de lecture est personnalisable via ACF.
Conclusion
Ce projet m'a surtout permis de combler un manque : découvrir par moi-même le fonctionnement des blocs Gutenberg personnalisés avec ACF, que je n'avais pas eu l'occasion de pratiquer en agence. Avoir maintenant une base de blocs propres et documentés me fait aussi gagner du temps sur mes prochains projets WordPress, personnels ou pour l'agence.