Ajouter un bouton à tous les & # 39; Éditeur Gutenberg utilisant @ WordPress \/ scripts
Antonio a écrit ce blog il y a environ un an et demi pour expliquer l’une des difficultés que nous avons rencontrées lors de l’adaptation du plugin au nouvel éditeur de blocs WordPress. Les résultats de son tutoriel sont similaires: Nous ajoutons des boutons à Gutenberg dans le tutoriel 2019. Heureusement ou malheureusement, Gutenberg a beaucoup changé cette année. La pile de développement a été étendue et améliorée, et les plug – ins et les développeurs de sujets doivent accepter et s’adapter aux nouvelles technologies. Ceux d’entre nous qui ont également écrit nos expériences et partagé ce que nous avons appris sont maintenant « forcés » de mettre à jour Nos tutoriels afin que vous puissiez vous tenir au courant de l’évolution de l’époque. Mais nous sommes heureux!
Il y a quelques semaines, Ivan, un de nos lecteurs, nous a laissé un commentaire dans le tutoriel d’Antonio, demandant de l’aide. Apparemment, il n’a pas pu implémenter le plug – in d’Antonio. En fait, cela n’est pas surprenant, car la situation a beaucoup changé ces derniers temps. Donc, pour aider Ivan et tous ceux qui nous lisent et qui veulent en savoir plus sur WordPress, Recréez un tutoriel sur la façon d’ajouter des boutons à l’éditeur de blocs Gutenberg en utilisant tous les nouveaux outils fournis par WordPress! La première chose que nous devons faire pour créer un plugin est de créer un plugin wordpress. C’est simple. Fondamentalement, tout ce que nous avons à faire est de créer un dossier dans le contenu \/ plug – in WP et d’utiliser le nom que nous voulons donner au plug – in (par exemple, le bouton Gutenberg), puis de créer un fichier avec le même nom et extension. Extension PHP. Php. Tapez ensuite le code suivant dans le fichier plug – in:
Maintenant, regardons de plus près ce que le fragment précédent fait: d’abord, ouvrons une balise <?php . Nessuna sorpresa qui. Successivamente, in questo file principale, aggiungiamo un commento su più righe. Il commento include diverse righe con coppie "Chiave / Valore". Ad esempio, vediamo come specifichiamo il nome del plugin ( Plugin Name ), la sua versione ( Version ) o il nome dell'autore ( Author ). Tutte queste informazioni saranno quindi visibili nella sezione Plugin all'interno di WordPress. Infine, aggiungiamo del codice boilerplate: specifichiamo uno namespace (ne abbiamo parlato qui), ci assicuriamo che, se il file viene eseguito, venga eseguito come parte di WordPress e definiamo alcune costanti sul plugin (che saranno utili in seguito). Una volta che abbiamo fatto tutto questo, se andiamo nella schermata Plugin del nostro WordPress, vedremo che il pulsante Gutenberg è lì:
Le plug – in que nous venons de créer est maintenant disponible. Brillant On l’active, regarde! Bien sûr, il ne fera rien, mais il est déjà là. Développement quotidien du plug – in JavaScript
JS, \
Comment s’assurer que tout va bien… Nous créons un dossier SRC dans le Répertoire racine du projet et ajoutons un fichier index. JS interne. Ce sera le fichier javascript principal de notre plug – in et contiendra tout votre code (de sorte que vous pouvez organiser le Code selon vos préférences, tant que le fichier principal est src \/ index.js). Essayons de travailler comme prévu en ajoutant l’énoncé d’index suivant. Js: console. Journal (‘hi!’); Et construire le projet en utilisant NPM Run Build. Cela convertit votre code en quelque chose qui peut être exécuté par le navigateur (ce qui n’est pas vraiment nécessaire pour le moment, mais prend quelques minutes) et génère un nouveau script dans le dossier Build.
Tout ce que nous avons à faire maintenant est de dire à WordPress que ce script existe afin qu’il puisse le charger. Pour ce faire, il suffit d’ouvrir le fichier plug – in principal (gutenberg-button.php) et d’ajouter la ligne suivante à la fin: function enqueue _ script () {WP enqueue script (‘gutenberg-button’, Gutenberg button URL. \/ Build \/ index.js’, [], Gutenberg button version);} \/ \/ Fin de la file d’attente _ script () Ajouter action (‘file d’attente Block Editor Assets’, namespace U.’ \ \ enqueue script ‘); Si vous remarquez, vous verrez que nous disons simplement à WordPress de joindre notre nouveau script \/ Build \/ index. JS agit comme une ressource d’éditeur de bloc. Ainsi, lorsque l’utilisateur accède à l’éditeur de bloc, nos scripts feront partie des actifs que l’éditeur contiendra.
Alors donnons un o
Inclure le chemin Gutenberg _ button path. \