Aller au contenu principal

Comment charger et exécuter des Blueprints

Fragment d’URL​

La façon la plus rapide d’exécuter des Blueprints consiste à en coller un dans le « fragment » d’URL d’un site WordPress Playground. Ajoutez simplement un # après .net/.

Supposons que vous vouliez créer un Playground avec des versions spécifiques de WordPress et de PHP avec le Blueprint suivant :

{
"$schema": "https://playground.wordpress.net/blueprint-schema.json",
"preferredVersions": {
"php": "8.3",
"wp": "5.9"
}
}

Pour l’exécuter, allez sur https://playground.wordpress.net/#{"preferredVersions": {"php":"8.3", "wp":"5.9"}}. Vous pouvez aussi utiliser le bouton ci-dessous :

   Exécuter le Blueprint   

Utilisez cette méthode pour exécuter l’exemple de code du chapitre suivant, Créer votre premier Blueprint.

Fragments de Blueprint encodés​

Lorsque vous créez un lien Playground depuis JavaScript ou un outil d’automatisation, encodez le JSON du Blueprint une seule fois avec encodeURIComponent(JSON.stringify(blueprint)) et ajoutez-le après #.

Playground prend également en charge les Blueprints encodés en Base64, qui sont utiles lorsqu’une plateforme modifie les fragments JSON ou lorsque vous voulez un lien compact et facile à copier. Par exemple, voici le Blueprint ci-dessus au format Base64 : eyJwcmVmZXJyZWRWZXJzaW9ucyI6IHsicGhwIjoiNy40IiwgIndwIjoiNS45In19.

Pour l’exécuter, allez sur https://playground.wordpress.net/#eyJwcmVmZXJyZWRWZXJzaW9ucyI6IHsicGhwIjoiNy40IiwgIndwIjoiNS45In19

Charger un Blueprint depuis une URL​

Lorsque votre Blueprint devient trop difficile à gérer, vous pouvez le charger avec le paramètre de requête ?blueprint-url dans l’URL, comme ceci :

https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/latest-gutenberg/blueprint.json

Notez que le Blueprint doit être accessible publiquement et servi avec le bon en-tête Access-Control-Allow-Origin :

Access-Control-Allow-Origin: *