Modules WordPress modernes avec le Guide de migration Gutenberg –

Cet article du Guide de migration de Gutenberg a été publié à l'origine par par Torque Magazine et est reproduit ici avec autorisation.

Aimez-le ou détestez-le, Gutenberg est ici pour rester . En tant que tel, faire en sorte que vos thèmes et plugins WordPress fonctionnent avec le nouvel éditeur devrait être une préoccupation majeure. À vrai dire, si vous ne faites que penser à cet aspect maintenant, vous réduisez les choses de très près.

Les projets de Daniel Bachhuber relatifs à Gutenberg ont déjà été présentés sur le blog Torque, et c’est un autre exemple. un qui mérite l'attention. Modifier vos plugins pour qu'ils soient compatibles avec Gutenberg pourrait s'avérer une tâche délicate, mais le Guide de migration de Gutenberg devrait vous aider à changer d'avis. C’est un guide de référence pratique pour comparer les points de personnalisation entre l’éditeur classique de WordPress et Gutenberg.

Dans cet article, nous examinerons le projet dans son ensemble et discuterons de son fonctionnement. Nous verrons ensuite comment vous assurer que vos plugins et vos thèmes sont prêts pour Gutenberg. Commençons!

L’état actuel du rédacteur en chef de Gutenberg

Nous avons beaucoup parlé de l’histoire de Gutenberg sur le blog Torque, nous n’entrerons donc pas dans les détails. Cependant, pour offrir un contexte contextuel, Gutenberg deviendra le nouvel éditeur par défaut de WordPress. Il remplacera la version TinyMCE actuellement en place. Alors que Gutenberg est hors de la version bêta nous attendons toujours que le plugin soit intégré à la plate-forme principale.

Cependant, malgré le bon raisonnement derrière les fonctionnalités de Gutenberg, beaucoup n’ont pas été impressionnés par la manque de vernis dans l'éditeur jusqu'à présent. Cette évaluation peut être un peu dure compte tenu de l’état actuel du projet. Quoi qu’il en soit, le nombre élevé de critiques a entraîné un manque de réactivité de la part de nombreux développeurs WordPress, notamment en ce qui concerne la mise aux normes de leurs produits.

Cela n’a pas empêché certains développeurs avisés d’essayer de saisir marché adoptant, cependant. Par exemple, le très populaire constructeur de pages Elementor Pro inclut désormais un certain nombre de [blocs] compatibles avec Gutenberg . D'autres développeurs commencent également à inclure cette fonctionnalité en tant que fonctionnalité standard:

Le fait que nous voyions enfin des fonctionnalités liées à Gutenberg apparaissant dans des thèmes commerciaux devrait mettre la situation de côté. la perspective. En d'autres termes, certains développeurs travaillent depuis un certain temps sur leurs solutions Gutenberg. Maintenant, ils commencent à les proposer au public.

Si vous n’avez pas encore commencé à faire de même, vous aurez probablement besoin d’aide pour démarrer.

Présentation du Guide de migration Gutenberg

Avoir un peu de support lors de la migration de vos fonctionnalités vers Gutenberg devrait sans doute plaire à de nombreux développeurs. Pour cette raison, Daniel Bachhuber – qui est devenu un point focal des initiatives liées à Gutenberg – a créé le Guide de migration Gutenberg .

Il s'agit d'une ressource destinée à aider les développeurs à porter leurs plugins centrés sur TinyMCE. et thèmes pour le nouvel éditeur. Il contient de nombreuses captures d’écran et des références pratiques au Manuel du développeur Gutenberg . Vous pouvez le considérer comme le propre "Codex" de Gutenberg, même s'il ne fait pas partie des documents officiels du Codex WordPress .

Ce guide contient également un bref aperçu de chaque point de personnalisation de l'éditeur TinyMCE avec un Gutenberg. équivalent. De plus, il couvre tous les crochets impactés et les fonctionnalités de l'éditeur classiques. Cela sera évidemment une ressource incontournable lorsque vous tenterez de trouver des solutions de portage des fonctionnalités sur Gutenberg.

Comment réussir le projet de migration de Gutenberg

Comme indiqué sur un blog Make WordPress post vers la fin avril, Daniel cherche à externaliser ce projet, au lieu de rester le seul contributeur. Cependant, malgré la pléthore d'éléments composant le nouvel éditeur, les contributions supplémentaires ont été rares:

C'est pourquoi, compte tenu de la grande valeur du projet, plus de contributeurs sont nécessaires pour aider à remplir le guide. Pour commencer à contribuer, vous pouvez simplement envoyer une demande de tirage comme d'habitude, qui sera ensuite approuvée et fusionnée dans le guide proprement dit. Vous pouvez également suggérer un nouveau crochet (ou poser une question) en en ouvrant un numéro de GitHub .

Comment utiliser le Guide de migration Gutenberg pour créer des plugins WordPress modernes

Le Guide de migration Gutenberg est en réalité utilisé. une brise absolue, principalement en raison de sa présentation hautement organisée:

Vous trouverez une référence à l'action ou au filtre pertinent de l'éditeur TinyMCE en haut de chaque page, et ensuite un exemple générique de son utilisation dans WordPress. Vous trouverez ensuite des exemples concrets d’utilisation du crochet. C'est un domaine où le projet a besoin de plus de contributions. Il existe de nombreux plug-ins qui ajouteront leurs propres fonctionnalités à l'éditeur, qui doivent être documentées.

Ci-dessous, vous trouverez une capture d'écran du crochet équivalent dans Gutenberg. Ceci sera accompagné d'une brève explication de l'endroit où vous pouvez trouver ce crochet, ainsi que de toute information ésotérique concernant son utilisation. Enfin, il existe une référence pratique au Manuel du développeur Gutenberg pour vous aider si vous avez besoin de plus d'informations.

Dans l'ensemble, il s'agit d'un guide de référence très utile pour les développeurs de Gutenberg. passons par le processus de migration. À notre avis, les premières parties à vérifier sont les aspects qui n’ont pas encore été transférés à Gutenberg. Par exemple, un certain nombre d'actions edit_form ne sont plus compatibles dans Gutenberg. Selon le thème ou la fonctionnalité de votre plugin, cela pourrait nécessiter une solution de contournement complète.

Enfin, deux autres fonctionnalités classiques de l'éditeur qui n'ont pas été intégrées à Gutenberg sont l'onglet Options d'écran et l'inofficiel . Fonction de statut de publication personnalisée . La première solution est probablement plus inquiétante pour de nombreux développeurs, car c’était une fonctionnalité ‘power’ que beaucoup d’utilisateurs de WordPress ont trouvée utile.

Il est absolument essentiel que vos thèmes et vos plugins puissent s’adapter aux deux éditeurs. Comme vous l’avez vu, c’est le Guide de migration Gutenberg qui vous y conduira.

Conclusion

Gutenberg a ses détracteurs, mais chaque mise à jour bêta apporte plus à la fête. Le nouvel éditeur devient progressivement une méthode puissante pour créer des mises en page WordPress, ce qui est une excellente nouvelle pour les utilisateurs finaux et les développeurs.

De plus, le Guide de migration Gutenberg de Daniel Bachhuber peut être une excellente ressource pour ceux qui ont besoin d’adapter rapidement leurs propres projets. C’est incroyablement simple à utiliser en l’état, mais elle a toujours besoin de l’aide de la communauté WordPress pour atteindre son plein potentiel. Pour vous aider, vous pouvez envoyer une demande de tirage, ouvrir un numéro de GitHub ou même offrir vos propres exemples réels d'équivalents Gutenberg aux fonctionnalités de l'éditeur de TinyMCE.

Tom Rankin est un membre clé de WordCandy musicien, photographe, végétalien, propriétaire de la barbe et codeur (très) amateur. Quand il ne fait aucune de ces choses, il est probablement en train de dormir.