·

4–6 minutes

Un playground pour mes extensions WordPress : démos en ligne et WordPress Playground


Mes extensions WordPress sont publiées sur WordPress.org, mais une page de dépôt montre mal un bloc : quelques captures, une description. J’en ai profité pour faire un chantier que je repoussais depuis un moment : remettre les extensions à jour, leur donner une charte commune, et refaire playground.juzed.dev, avec une page de démo par extension et un bouton pour l’essayer soi-même dans l’éditeur, sans rien installer.

Ce qu’on y trouve

Quatre extensions pour l’éditeur de blocs, libres et gratuites :

Chaque page reprend la même structure : la bannière, le nom et une phrase d’explication, les boutons de téléchargement et de code source, plus un bouton pour l’essayer quand l’extension est publiée sur WordPress.org, la démo, puis une FAQ tirée du readme. En bas, les extensions précédente et suivante.

Des extensions remises à jour

Les trois extensions publiées sur WordPress.org sont passées en version 1.1 :

  • compatibles WordPress 7.1, avec WordPress 6.6 et PHP 7.4 comme minimum, et des outils de compilation à jour ;
  • des libellés dans la langue de la page : JuZ DualView et JuZ Simple Video Preview n’enregistrent plus de texte traduit dans le contenu. Les libellés sont ajoutés à l’affichage, ce qui évite qu’un bloc devienne invalide quand la traduction ou la langue de l’éditeur change, et un site multilingue affiche chaque page dans sa langue ;
  • des traductions qui viennent de translate.wordpress.org : la version validée par l’équipe de traduction française fait référence, celle fournie avec l’extension la suit ;
  • un nom cohérent : Simple Video Preview devient JuZ Simple Video Preview, comme les autres ;
  • un dépôt Git par extension, sur GitLab, avec une procédure de publication outillée : vérifications, contrôle de l’extension, puis envoi sur WordPress.org.

Une charte commune

Les bannières et icônes de WordPress.org ont été refaites dans la charte de juzed.dev : fond sombre partagé en deux, une illustration simple de ce que fait l’extension à gauche, et à droite JuZ avec le Z en vert, le nom de l’extension et une phrase d’explication. Montserrat pour les mots, JetBrains Mono pour tout ce qui est technique, un seul élément vert par visuel.

Elles sont générées par un script, en anglais et en français, aux formats de WordPress.org. Les mêmes visuels servent de bannières aux fiches du playground et d’images de partage.

Construit sur mon starter kit

Le playground tourne sur le même socle que juzed.dev : mon starter kit WordPress FSE, Bedrock, un thème enfant et Modern Fields. Les extensions y sont un type de contenu à part entière :

  • un gabarit unique pour toutes les fiches, l’image à la une servant de bannière et l’extrait de chapeau ;
  • les boutons liés à des champs lien : changer une URL ne demande pas de retoucher la page ;
  • une page de liste réglée dans l’administration, dont l’adresse suit la langue : /our-plugins/ en anglais, /fr/nos-extensions/ en français.

Le site est en anglais par défaut, avec une version française, grâce à Polylang et à mon extension maison qui traduit les adresses et donne un menu à chaque langue. En chemin, j’ai corrigé deux oublis de cette extension : les fiches françaises sortaient avec l’adresse anglaise de la liste, et le fil d’Ariane aussi. Le correctif sert à tous mes sites bilingues.

Tout le contenu est produit par un script : pages, menus, démos, FAQ, métas. On peut le rejouer sur une base vierge et obtenir le même site, ce qui rend chaque évolution facile à tester avant de la mettre en ligne.

Essayer sans rien installer

WordPress Playground fait tourner WordPress entièrement dans le navigateur. Un fichier, le blueprint, décrit ce qu’il faut préparer : installer l’extension depuis WordPress.org, créer une page de démo, ouvrir l’éditeur dessus. Publié avec l’extension, il active aussi le bouton « Live Preview » de WordPress.org.

Le lien d’essai pointe vers le blueprint servi par WordPress.org :

https://playground.wordpress.net/?blueprint-url=https://wordpress.org/plugins/wp-json/plugins/v1/plugin/juz-dualview/blueprint.json

Pour JuZ Rich Text Extender, qui n’ajoute aucun bouton par lui-même, le blueprint dépose aussi une petite extension qui déclare deux formats de démo. Sans elle, l’éditeur n’aurait rien à montrer.

Lisible par les moteurs, y compris génératifs

J’ai repris la démarche appliquée à juzed.dev : titres et descriptions écrits à la main dans les deux langues, une FAQ balisée sur chaque fiche, une entité « logiciel » par extension (gratuite, licence GPL, lien de téléchargement, auteur), un fichier llms.txt qui résume le site, et un plan du site qui inclut les extensions.

La mesure d’audience passe par Umami auto-hébergé : sans cookie, et seulement en production.

Questions fréquentes

Comment essayer une extension WordPress sans l’installer ?

Avec WordPress Playground : un lien ouvre un WordPress complet dans le navigateur, avec l’extension déjà installée. Sur playground.juzed.dev, chaque fiche a un bouton « Essayer dans WordPress Playground ».

Qu’est-ce qu’un blueprint WordPress Playground ?

Un fichier JSON qui décrit comment préparer le site : version de WordPress et de PHP, extensions à installer, contenu à créer, page à ouvrir. Placé dans les assets d’une extension sur WordPress.org, il active le bouton « Live Preview ».

Quelles versions de WordPress sont prises en charge ?

JuZ DualView, JuZ Simple Video Preview et JuZ Rich Text Extender demandent WordPress 6.6 et PHP 7.4, et sont testées avec WordPress 7.1. JuZ Mirage, en bêta, demande WordPress 6.7 et PHP 8.1, avec un thème blocs.

Une extension à faire connaître, une démo à monter, ou une question sur l’une des miennes ? Écrivez-moi à contact@juzed.dev.


Stack : WordPress FSE · Polylang · Modern Fields · WordPress Playground · Rank Math · Umami