From 2bb41249a26a7c16b85dd8c412a8df68e920a0d8 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Wed, 12 Nov 2025 18:42:08 +0000 Subject: [PATCH 01/11] Adding information about the resource type git repository --- .../developers/03-build-an-app/01-index.md | 22 ++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index 1cb5aa8e20..2fda00af86 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -85,6 +85,26 @@ See [getting started with Blueprints](/blueprints/getting-started) to learn more ## Preview pull requests from your repository +Developers can preview plugins and themes from a repository with two alternatives: using the resource type `git:directory` or pointing to the zip file from a CI pipeline. For the first approach, we are demonstrating via [JSON Blueprints](/blueprints): + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "git:directory", + "url": "https://github.com/my-user/my-repo", + "ref": "add-feature-xyz", + "refType": "branch" + } + } + ] +} +``` + +With this approach, there is no extra configuration on your repository to create a CI pipeline to generate a `.ZIP` file from your project. The second approach can have a better performance, but requires the CI configuration. The resource would be type `url`, which will install the plugin or theme directly to the WordPress Playground instance. + See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). You can use Playground as a Pull Request previewer if: @@ -93,7 +113,7 @@ You can use Playground as a Pull Request previewer if: - Your CI pipeline bundles your plugin or theme - You can expose the zip file generated by your CI pipeline publicly -Those zip bundles aren't any different from regular WordPress Plugins, which means you can install them in Playground using the [JSON Blueprints](/blueprints) API. Once you exposed an endpoint like https://your-site.com/pull-request-1234.zip, the following Blueprint will do the rest: +Those zip bundles aren't any different from regular WordPress Plugins, which means you can install them in Playground using the [JSON Blueprints](/blueprints) API. Once you expose an endpoint like https://your-site.com/pull-request-1234.zip, the following Blueprint will do the rest: ```json { From 8314e376ab88d3096d552008123fdc333c00a40c Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Wed, 12 Nov 2025 19:41:11 +0000 Subject: [PATCH 02/11] Adding page description, new Queries and github preview --- .../developers/03-build-an-app/01-index.md | 28 ++++++++++++------- 1 file changed, 18 insertions(+), 10 deletions(-) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index 2fda00af86..7d88a3e42a 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -1,6 +1,7 @@ --- title: Quick Start Guide for Developers slug: /developers/build-your-first-app +description: Practical guide to embedding WordPress, installing plugins, previewing PRs, and building apps with Playground APIs. --- # Quick Start Guide for Developers @@ -39,8 +40,7 @@ Learn more about each of these APIs in the [APIs overview section](/developers/a import ThisIsQueryApi from '@site/docs/\_fragments/\_this_is_query_api.md'; -You can install plugins and themes from the WordPress directory with only URL parameters. For example this iframe would come with the `coblocks` and `friends` plugins preinstalled as well as the `pendant` theme. - +You can install plugins and themes from the WordPress directory with only URL parameters. This iframe preinstalls the `coblocks` and `friends` plugins and the `pendant` theme. ```html @@ -72,7 +72,7 @@ You can still showcase it on Playground by using [JSON Blueprints](/blueprints). }, { "step": "importWxr", - "pluginData": { + "file": { "resource": "url", "url": "https://your-site.com/starter-content.wxr" } @@ -85,7 +85,7 @@ See [getting started with Blueprints](/blueprints/getting-started) to learn more ## Preview pull requests from your repository -Developers can preview plugins and themes from a repository with two alternatives: using the resource type `git:directory` or pointing to the zip file from a CI pipeline. For the first approach, we are demonstrating via [JSON Blueprints](/blueprints): +You can preview repository code two ways: directly with `git:directory`, or by pointing to a `.zip` from your CI pipeline. Here's the `git:directory` approach using [Blueprints](/blueprints): ```json { @@ -103,15 +103,14 @@ Developers can preview plugins and themes from a repository with two alternative } ``` -With this approach, there is no extra configuration on your repository to create a CI pipeline to generate a `.ZIP` file from your project. The second approach can have a better performance, but requires the CI configuration. The resource would be type `url`, which will install the plugin or theme directly to the WordPress Playground instance. +`git:directory` requires no CI configuration. Using a direct .zip URL performs better because Playground downloads a single file, but requires CI setup. See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). -You can use Playground as a Pull Request previewer if: +To use Playground as a PR previewer, you need: -- Your WordPress plugin or theme uses a CI pipeline -- Your CI pipeline bundles your plugin or theme -- You can expose the zip file generated by your CI pipeline publicly +- A CI pipeline that bundles your plugin or theme +- Public access to the generated `.zip` file Those zip bundles aren't any different from regular WordPress Plugins, which means you can install them in Playground using the [JSON Blueprints](/blueprints) API. Once you expose an endpoint like https://your-site.com/pull-request-1234.zip, the following Blueprint will do the rest: @@ -174,9 +173,18 @@ blueprint={{ ] }} /> +### Preview WordPress Core and Gutenberg Branches or PRs + +You can preview specific branches or pull requests from WordPress Core and Gutenberg repositories using Query API parameters. This is useful for testing the latest trunk changes or specific feature branches without creating a PR. + +- Preview WordPress Core trunk branch: `https://playground.wordpress.net/?core-branch=trunk` +- Preview a specific WordPress Core PR: `https://playground.wordpress.net/?core-pr=9500` +- Preview the Gutenberg trunk branch: `https://playground.wordpress.net/?gutenberg-branch=trunk` +- Preview a specific Gutenberg PR: `https://playground.wordpress.net/?gutenberg-pr=73010` + ## Build a compatibility testing environment -A live plugin demo with a configurable PHP and WordPress makes an excellent compatibility testing environment. +Test your plugin across PHP and WordPress versions by configuring them in Playground. This helps you verify compatibility before release. With the Query API, you'd simply add the `php` and `wp` query parameters to the URL: From 85dcee627f1df9855529d67452701a8667e38d92 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Wed, 12 Nov 2025 20:55:57 +0000 Subject: [PATCH 03/11] adding spanish translation --- .../developers/03-build-an-app/01-index.md | 299 ++++++++++++++++++ 1 file changed, 299 insertions(+) create mode 100644 packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md new file mode 100644 index 0000000000..7c4bab9f0e --- /dev/null +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -0,0 +1,299 @@ +--- +title: Guía de inicio rápido para desarrolladores +slug: /developers/build-your-first-app +description: Guía práctica para integrar WordPress, instalar plugins, previsualizar PRs y crear aplicaciones con las APIs de Playground. +--- + + + +# Guía de inicio rápido para desarrolladores + + + +WordPress Playground fue creado como una herramienta programable. A continuación encontrarás algunos ejemplos de lo que puedes hacer con él. Cada API discutida se describe en detalle en la [sección de APIs](/developers/apis/): + +import TOCInline from '@theme/TOCInline'; + + + + + +## Integrar WordPress en tu sitio web + + + +Playground se puede integrar en tu sitio web usando la etiqueta HTML ` +``` + + + +Cada visitante obtendrá su propia instancia privada de WordPress de forma gratuita. Luego puedes personalizarla usando una de las [APIs de Playground](/developers/apis/). + +import PlaygroundWpNetWarning from '@site/docs/\_fragments/\_playground_wp_net_may_stop_working.md'; + + + + + +## Controlar el sitio web integrado + + + +WordPress Playground proporciona tres APIs que puedes usar para controlar el sitio web en iframe. Todos los ejemplos en esta sección se construyen usando una de estas: + +import APIList from '@site/docs/\_fragments/\_api_list.mdx'; + + + + + +Aprende más sobre cada una de estas APIs en la [sección de descripción general de APIs](/developers/apis/). + + + +## Mostrar un plugin o tema del directorio de WordPress + +import ThisIsQueryApi from '@site/docs/\_fragments/\_this_is_query_api.md'; + + + +Puedes instalar plugins y temas del directorio de WordPress con solo parámetros de URL. Este iframe preinstala los plugins `coblocks` y `friends` y el tema `pendant`. + + + +```html + +``` + + + +## Mostrar cualquier plugin o tema + + + +¿Y si tu plugin no está en el directorio de WordPress? + + + +Aún puedes mostrarlo en Playground usando [JSON Blueprints](/blueprints). Por ejemplo, este Blueprint descargaría e instalaría un plugin y un tema desde tu sitio web y también importaría contenido inicial: + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "url", + "url": "https://your-site.com/your-plugin.zip" + } + }, + { + "step": "installTheme", + "themeData": { + "resource": "url", + "url": "https://your-site.com/your-theme.zip" + } + }, + { + "step": "importWxr", + "file": { + "resource": "url", + "url": "https://your-site.com/starter-content.wxr" + } + } + ] +} +``` + + + +Consulta [comenzando con Blueprints](/blueprints/getting-started) para obtener más información. + + + +## Previsualizar pull requests de tu repositorio + + + +Puedes previsualizar el código del repositorio de dos maneras: directamente con `git:directory`, o apuntando a un `.zip` de tu pipeline de CI. Aquí está el enfoque `git:directory` usando [Blueprints](/blueprints): + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "git:directory", + "url": "https://github.com/my-user/my-repo", + "ref": "add-feature-xyz", + "refType": "branch" + } + } + ] +} +``` + + + +`git:directory` no requiere configuración de CI. Usar una URL .zip directa tiene mejor rendimiento porque Playground descarga un solo archivo, pero requiere configuración de CI. + + + +Consulta el [ejemplo en vivo del previsualizador de PR de Gutenberg](https://playground.wordpress.net/gutenberg.html). + + + +Para usar Playground como previsualizador de PR, necesitas: + + + + +- Un pipeline de CI que empaquete tu plugin o tema +- Acceso público al archivo `.zip` generado + + + +Esos paquetes zip no son diferentes de los plugins de WordPress normales, lo que significa que puedes instalarlos en Playground usando la API [JSON Blueprints](/blueprints). Una vez que expongas un endpoint como https://your-site.com/pull-request-1234.zip, el siguiente Blueprint hará el resto: + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "url", + "url": "https://your-site.com/pull-request-1234.zip" + } + } + ] +} +``` + + + +La demostración oficial de Playground utiliza esta técnica para previsualizar pull requests del repositorio de Gutenberg: + +import BlueprintExample from '@site/src/components/Blueprints/BlueprintExample.mdx'; + + + + + +### Previsualizar ramas o PRs de WordPress Core y Gutenberg + + + +Puedes previsualizar ramas o pull requests específicas de los repositorios de WordPress Core y Gutenberg usando parámetros de la Query API. Esto es útil para probar los últimos cambios del trunk o ramas de características específicas sin crear un PR. + + + + + + +- Previsualizar rama trunk de WordPress Core: `https://playground.wordpress.net/?core-branch=trunk` +- Previsualizar un PR específico de WordPress Core: `https://playground.wordpress.net/?core-pr=9500` +- Previsualizar rama trunk de Gutenberg: `https://playground.wordpress.net/?gutenberg-branch=trunk` +- Previsualizar un PR específico de Gutenberg: `https://playground.wordpress.net/?gutenberg-pr=73010` + + + +## Crear un entorno de pruebas de compatibilidad + + + +Prueba tu plugin en diferentes versiones de PHP y WordPress configurándolas en Playground. Esto te ayuda a verificar la compatibilidad antes del lanzamiento. + + + +Con la Query API, simplemente agregarías los parámetros de consulta `php` y `wp` a la URL: + +```html + +``` + + + +Con JSON Blueprints, usarías la propiedad `preferredVersions`: + +```json +{ + "preferredVersions": { + "php": "8.3", + "wp": "6.1" + } +} +``` + + + +## Ejecutar código PHP en el navegador + + + +La API de JavaScript proporciona el método `run()` que puedes usar para ejecutar código PHP en el navegador: + +```html + + +``` + + + +¡Combina eso con un editor de código como Monaco o CodeMirror, y obtendrás fragmentos de código en vivo como en [este artículo](https://adamadam.blog/2023/02/16/how-to-modify-html-in-a-php-wordpress-plugin-using-the-new-tag-processor-api/)! From c7618afdafdc55ef9aadf53614506e2f921c2b4e Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Wed, 12 Nov 2025 20:56:14 +0000 Subject: [PATCH 04/11] adding French translation --- .../developers/03-build-an-app/01-index.md | 299 ++++++++++++++++++ 1 file changed, 299 insertions(+) create mode 100644 packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md new file mode 100644 index 0000000000..86a44c5b64 --- /dev/null +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -0,0 +1,299 @@ +--- +title: Guide de démarrage rapide pour les développeurs +slug: /developers/build-your-first-app +description: Guide pratique pour intégrer WordPress, installer des plugins, prévisualiser des PRs et créer des applications avec les APIs Playground. +--- + + + +# Guide de démarrage rapide pour les développeurs + + + +WordPress Playground a été créé comme un outil programmable. Vous trouverez ci-dessous quelques exemples de ce que vous pouvez faire avec. Chaque API discutée est décrite en détail dans la [section APIs](/developers/apis/) : + +import TOCInline from '@theme/TOCInline'; + + + + + +## Intégrer WordPress sur votre site web + + + +Playground peut être intégré sur votre site web en utilisant la balise HTML ` +``` + + + +Chaque visiteur obtiendra sa propre instance WordPress privée gratuitement. Vous pouvez ensuite la personnaliser en utilisant l'une des [APIs Playground](/developers/apis/). + +import PlaygroundWpNetWarning from '@site/docs/\_fragments/\_playground_wp_net_may_stop_working.md'; + + + + + +## Contrôler le site web intégré + + + +WordPress Playground fournit trois APIs que vous pouvez utiliser pour contrôler le site web en iframe. Tous les exemples de cette section sont construits en utilisant l'une d'entre elles : + +import APIList from '@site/docs/\_fragments/\_api_list.mdx'; + + + + + +En savoir plus sur chacune de ces APIs dans la [section de présentation des APIs](/developers/apis/). + + + +## Présenter un plugin ou un thème du répertoire WordPress + +import ThisIsQueryApi from '@site/docs/\_fragments/\_this_is_query_api.md'; + + + +Vous pouvez installer des plugins et des thèmes du répertoire WordPress avec uniquement des paramètres d'URL. Cet iframe préinstalle les plugins `coblocks` et `friends` ainsi que le thème `pendant`. + + + +```html + +``` + + + +## Présenter n'importe quel plugin ou thème + + + +Et si votre plugin n'est pas dans le répertoire WordPress ? + + + +Vous pouvez toujours le présenter sur Playground en utilisant les [JSON Blueprints](/blueprints). Par exemple, ce Blueprint téléchargerait et installerait un plugin et un thème depuis votre site web et importerait également du contenu de démarrage : + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "url", + "url": "https://your-site.com/your-plugin.zip" + } + }, + { + "step": "installTheme", + "themeData": { + "resource": "url", + "url": "https://your-site.com/your-theme.zip" + } + }, + { + "step": "importWxr", + "file": { + "resource": "url", + "url": "https://your-site.com/starter-content.wxr" + } + } + ] +} +``` + + + +Voir [commencer avec les Blueprints](/blueprints/getting-started) pour en savoir plus. + + + +## Prévisualiser les pull requests de votre dépôt + + + +Vous pouvez prévisualiser le code du dépôt de deux manières : directement avec `git:directory`, ou en pointant vers un `.zip` de votre pipeline CI. Voici l'approche `git:directory` utilisant les [Blueprints](/blueprints) : + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "git:directory", + "url": "https://github.com/my-user/my-repo", + "ref": "add-feature-xyz", + "refType": "branch" + } + } + ] +} +``` + + + +`git:directory` ne nécessite aucune configuration CI. L'utilisation d'une URL .zip directe offre de meilleures performances car Playground télécharge un seul fichier, mais nécessite une configuration CI. + + + +Voir l'[exemple en direct du prévisualiseur de PR Gutenberg](https://playground.wordpress.net/gutenberg.html). + + + +Pour utiliser Playground comme prévisualiseur de PR, vous avez besoin : + + + + +- D'un pipeline CI qui empaquette votre plugin ou thème +- D'un accès public au fichier `.zip` généré + + + +Ces archives zip ne sont pas différentes des plugins WordPress classiques, ce qui signifie que vous pouvez les installer dans Playground en utilisant l'API [JSON Blueprints](/blueprints). Une fois que vous exposez un point de terminaison comme https://your-site.com/pull-request-1234.zip, le Blueprint suivant fera le reste : + +```json +{ + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "url", + "url": "https://your-site.com/pull-request-1234.zip" + } + } + ] +} +``` + + + +La démo officielle de Playground utilise cette technique pour prévisualiser les pull requests du dépôt Gutenberg : + +import BlueprintExample from '@site/src/components/Blueprints/BlueprintExample.mdx'; + + + + + +### Prévisualiser les branches ou PRs de WordPress Core et Gutenberg + + + +Vous pouvez prévisualiser des branches ou pull requests spécifiques des dépôts WordPress Core et Gutenberg en utilisant les paramètres de la Query API. Cela est utile pour tester les dernières modifications du trunk ou des branches de fonctionnalités spécifiques sans créer de PR. + + + + + + +- Prévisualiser la branche trunk de WordPress Core : `https://playground.wordpress.net/?core-branch=trunk` +- Prévisualiser une PR spécifique de WordPress Core : `https://playground.wordpress.net/?core-pr=9500` +- Prévisualiser la branche trunk de Gutenberg : `https://playground.wordpress.net/?gutenberg-branch=trunk` +- Prévisualiser une PR spécifique de Gutenberg : `https://playground.wordpress.net/?gutenberg-pr=73010` + + + +## Créer un environnement de test de compatibilité + + + +Testez votre plugin sur différentes versions de PHP et WordPress en les configurant dans Playground. Cela vous aide à vérifier la compatibilité avant la publication. + + + +Avec la Query API, vous ajouteriez simplement les paramètres de requête `php` et `wp` à l'URL : + +```html + +``` + + + +Avec les JSON Blueprints, vous utiliseriez la propriété `preferredVersions` : + +```json +{ + "preferredVersions": { + "php": "8.3", + "wp": "6.1" + } +} +``` + + + +## Exécuter du code PHP dans le navigateur + + + +L'API JavaScript fournit la méthode `run()` que vous pouvez utiliser pour exécuter du code PHP dans le navigateur : + +```html + + +``` + + + +Combinez cela avec un éditeur de code comme Monaco ou CodeMirror, et vous obtiendrez des extraits de code en direct comme dans [cet article](https://adamadam.blog/2023/02/16/how-to-modify-html-in-a-php-wordpress-plugin-using-the-new-tag-processor-api/) ! From 269cd59400a8e55cfa47091174f5289ead5e16f4 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Wed, 12 Nov 2025 20:56:31 +0000 Subject: [PATCH 05/11] updating portuguese translation --- .../developers/03-build-an-app/01-index.md | 79 ++++++++++++++----- 1 file changed, 60 insertions(+), 19 deletions(-) diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 6c3a37a293..7bfefe8f20 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -1,6 +1,7 @@ --- title: Guia rápido para desenvolvedores slug: /developers/build-your-first-app +description: Guia prático para incorporar WordPress, instalar plugins, visualizar PRs e criar aplicativos com as APIs do Playground. --- @@ -9,7 +10,7 @@ slug: /developers/build-your-first-app -WordPress Playground foi criado como uma ferramenta programável. A seguir você irá encontrar alguns exemplos de como você pode fazer isso. Cada API discutida será descrita em detalhes na [Sessão de APIs](/developers/apis/): +WordPress Playground foi criado como uma ferramenta programável. Abaixo você encontrará alguns exemplos do que pode fazer com ele. Cada API discutida é descrita em detalhes na [seção de APIs](/developers/apis/): import TOCInline from '@theme/TOCInline'; @@ -19,7 +20,7 @@ import TOCInline from '@theme/TOCInline'; ## Incorporar WordPress no seu site - + O Playground pode ser incorporado no seu site usando a tag HTML ` + ``` @@ -219,8 +260,8 @@ Com JSON Blueprints, você usaria a propriedade `preferredVersions`: ```json { "preferredVersions": { - "php": "8.0", - "wp": "6.8" + "php": "8.3", + "wp": "6.1" } } ``` From c31cee95feef64d770d2f84294025e5f767fd4c4 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Thu, 13 Nov 2025 18:43:56 +0000 Subject: [PATCH 06/11] updating blueprint demo to load a pull request --- .../docs/developers/03-build-an-app/01-index.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index 7d88a3e42a..156218a516 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -95,17 +95,21 @@ You can preview repository code two ways: directly with `git:directory`, or by p "pluginData": { "resource": "git:directory", "url": "https://github.com/my-user/my-repo", - "ref": "add-feature-xyz", - "refType": "branch" + "ref": "refs/pull/1/head", + "refType": "refname" + }, + "options": { + "activate": true + }, + "progress": { + "caption": "Installing plugin from my-user/my-repo PR #1" } } ] } ``` -`git:directory` requires no CI configuration. Using a direct .zip URL performs better because Playground downloads a single file, but requires CI setup. - -See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). +Loading a `.zip` file is another alternative for previewing your project. See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). To use Playground as a PR previewer, you need: From a31cf744e964a409ea8ded668787635259ec07bf Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 18 Nov 2025 10:43:43 +0000 Subject: [PATCH 07/11] removing core branch preview --- .../docs/site/docs/developers/03-build-an-app/01-index.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index 156218a516..cfa5f6f927 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -179,12 +179,11 @@ blueprint={{ ### Preview WordPress Core and Gutenberg Branches or PRs -You can preview specific branches or pull requests from WordPress Core and Gutenberg repositories using Query API parameters. This is useful for testing the latest trunk changes or specific feature branches without creating a PR. +You can preview specific pull requests from WordPress Core and Gutenberg repositories using Query API parameters. Gutenberg branches also have an alternative to preview them with the parameter `gutenberg-branch`. This is useful for testing the latest trunk changes or specific feature branches without creating a PR. -- Preview WordPress Core trunk branch: `https://playground.wordpress.net/?core-branch=trunk` - Preview a specific WordPress Core PR: `https://playground.wordpress.net/?core-pr=9500` -- Preview the Gutenberg trunk branch: `https://playground.wordpress.net/?gutenberg-branch=trunk` - Preview a specific Gutenberg PR: `https://playground.wordpress.net/?gutenberg-pr=73010` +- Preview the Gutenberg trunk branch: `https://playground.wordpress.net/?gutenberg-branch=trunk` ## Build a compatibility testing environment From 3418f1c549f773e2f5085be2374e228ed38581ff Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 18 Nov 2025 10:50:50 +0000 Subject: [PATCH 08/11] updating translations --- .../developers/03-build-an-app/01-index.md | 184 ++++++++++++------ .../developers/03-build-an-app/01-index.md | 180 +++++++++++------ .../developers/03-build-an-app/01-index.md | 28 +-- 3 files changed, 258 insertions(+), 134 deletions(-) diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 7c4bab9f0e..1fa090a7a4 100644 --- a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -1,14 +1,18 @@ --- title: Guía de inicio rápido para desarrolladores slug: /developers/build-your-first-app -description: Guía práctica para integrar WordPress, instalar plugins, previsualizar PRs y crear aplicaciones con las APIs de Playground. +description: Guía práctica para incrustar WordPress, instalar plugins, previsualizar PRs y construir aplicaciones con las APIs de Playground. --- - + # Guía de inicio rápido para desarrolladores - + WordPress Playground fue creado como una herramienta programable. A continuación encontrarás algunos ejemplos de lo que puedes hacer con él. Cada API discutida se describe en detalle en la [sección de APIs](/developers/apis/): @@ -16,19 +20,25 @@ import TOCInline from '@theme/TOCInline'; - + -## Integrar WordPress en tu sitio web +## Incrustar WordPress en tu sitio web - + -Playground se puede integrar en tu sitio web usando la etiqueta HTML ` ``` - + Cada visitante obtendrá su propia instancia privada de WordPress de forma gratuita. Luego puedes personalizarla usando una de las [APIs de Playground](/developers/apis/). @@ -36,31 +46,41 @@ import PlaygroundWpNetWarning from '@site/docs/\_fragments/\_playground_wp_net_m - + -## Controlar el sitio web integrado +## Controlar el sitio web incrustado - + -WordPress Playground proporciona tres APIs que puedes usar para controlar el sitio web en iframe. Todos los ejemplos en esta sección se construyen usando una de estas: +WordPress Playground proporciona tres APIs que puedes usar para controlar el sitio web incrustado. Todos los ejemplos en esta sección están construidos usando una de estas: import APIList from '@site/docs/\_fragments/\_api_list.mdx'; - + Aprende más sobre cada una de estas APIs en la [sección de descripción general de APIs](/developers/apis/). - + ## Mostrar un plugin o tema del directorio de WordPress import ThisIsQueryApi from '@site/docs/\_fragments/\_this_is_query_api.md'; - + -Puedes instalar plugins y temas del directorio de WordPress con solo parámetros de URL. Este iframe preinstala los plugins `coblocks` y `friends` y el tema `pendant`. +Puedes instalar plugins y temas del directorio de WordPress solo con parámetros de URL. Este iframe preinstala los plugins `coblocks` y `friends` y el tema `pendant`. @@ -68,17 +88,23 @@ Puedes instalar plugins y temas del directorio de WordPress con solo parámetros ``` - + ## Mostrar cualquier plugin o tema - + -¿Y si tu plugin no está en el directorio de WordPress? +¿Qué pasa si tu plugin no está en el directorio de WordPress? - + -Aún puedes mostrarlo en Playground usando [JSON Blueprints](/blueprints). Por ejemplo, este Blueprint descargaría e instalaría un plugin y un tema desde tu sitio web y también importaría contenido inicial: +Aún puedes mostrarlo en Playground usando [Blueprints JSON](/blueprints). Por ejemplo, este Blueprint descargaría e instalaría un plugin y un tema desde tu sitio web y también importaría contenido inicial: ```json { @@ -108,17 +134,23 @@ Aún puedes mostrarlo en Playground usando [JSON Blueprints](/blueprints). Por e } ``` - + -Consulta [comenzando con Blueprints](/blueprints/getting-started) para obtener más información. +Consulta [primeros pasos con Blueprints](/blueprints/getting-started) para aprender más. - + ## Previsualizar pull requests de tu repositorio - + -Puedes previsualizar el código del repositorio de dos maneras: directamente con `git:directory`, o apuntando a un `.zip` de tu pipeline de CI. Aquí está el enfoque `git:directory` usando [Blueprints](/blueprints): +Puedes previsualizar código del repositorio de dos maneras: directamente con `git:directory`, o apuntando a un `.zip` de tu pipeline de CI. Aquí está el enfoque `git:directory` usando [Blueprints](/blueprints): ```json { @@ -128,35 +160,45 @@ Puedes previsualizar el código del repositorio de dos maneras: directamente con "pluginData": { "resource": "git:directory", "url": "https://github.com/my-user/my-repo", - "ref": "add-feature-xyz", - "refType": "branch" + "ref": "refs/pull/1/head", + "refType": "refname" + }, + "options": { + "activate": true + }, + "progress": { + "caption": "Installing plugin from my-user/my-repo PR #1" } } ] } ``` - - -`git:directory` no requiere configuración de CI. Usar una URL .zip directa tiene mejor rendimiento porque Playground descarga un solo archivo, pero requiere configuración de CI. - - + -Consulta el [ejemplo en vivo del previsualizador de PR de Gutenberg](https://playground.wordpress.net/gutenberg.html). +Cargar un archivo `.zip` es otra alternativa para previsualizar tu proyecto. Consulta el [ejemplo en vivo del previsualizador de PR de Gutenberg](https://playground.wordpress.net/gutenberg.html). - + -Para usar Playground como previsualizador de PR, necesitas: +Para usar Playground como un previsualizador de PR, necesitas: - - + - Un pipeline de CI que empaquete tu plugin o tema - Acceso público al archivo `.zip` generado - + -Esos paquetes zip no son diferentes de los plugins de WordPress normales, lo que significa que puedes instalarlos en Playground usando la API [JSON Blueprints](/blueprints). Una vez que expongas un endpoint como https://your-site.com/pull-request-1234.zip, el siguiente Blueprint hará el resto: +Esos paquetes zip no son diferentes de los plugins regulares de WordPress, lo que significa que puedes instalarlos en Playground usando la API de [Blueprints JSON](/blueprints). Una vez que expongas un endpoint como https://your-site.com/pull-request-1234.zip, el siguiente Blueprint hará el resto: ```json { @@ -172,9 +214,11 @@ Esos paquetes zip no son diferentes de los plugins de WordPress normales, lo que } ``` - + -La demostración oficial de Playground utiliza esta técnica para previsualizar pull requests del repositorio de Gutenberg: +La demo oficial de Playground usa esta técnica para previsualizar pull requests del repositorio de Gutenberg: import BlueprintExample from '@site/src/components/Blueprints/BlueprintExample.mdx'; @@ -219,43 +263,55 @@ blueprint={{ ] }} /> - + ### Previsualizar ramas o PRs de WordPress Core y Gutenberg - + -Puedes previsualizar ramas o pull requests específicas de los repositorios de WordPress Core y Gutenberg usando parámetros de la Query API. Esto es útil para probar los últimos cambios del trunk o ramas de características específicas sin crear un PR. +Puedes previsualizar pull requests específicos de los repositorios de WordPress Core y Gutenberg usando parámetros de la API Query. Las ramas de Gutenberg también tienen una alternativa para previsualizarlas con el parámetro `gutenberg-branch`. Esto es útil para probar los últimos cambios de trunk o ramas de características específicas sin crear un PR. - - - - + -- Previsualizar rama trunk de WordPress Core: `https://playground.wordpress.net/?core-branch=trunk` - Previsualizar un PR específico de WordPress Core: `https://playground.wordpress.net/?core-pr=9500` -- Previsualizar rama trunk de Gutenberg: `https://playground.wordpress.net/?gutenberg-branch=trunk` - Previsualizar un PR específico de Gutenberg: `https://playground.wordpress.net/?gutenberg-pr=73010` +- Previsualizar la rama trunk de Gutenberg: `https://playground.wordpress.net/?gutenberg-branch=trunk` - + -## Crear un entorno de pruebas de compatibilidad +## Construir un entorno de pruebas de compatibilidad - + Prueba tu plugin en diferentes versiones de PHP y WordPress configurándolas en Playground. Esto te ayuda a verificar la compatibilidad antes del lanzamiento. - + -Con la Query API, simplemente agregarías los parámetros de consulta `php` y `wp` a la URL: +Con la API Query, simplemente agregarías los parámetros de consulta `php` y `wp` a la URL: ```html ``` - + -Con JSON Blueprints, usarías la propiedad `preferredVersions`: +Con Blueprints JSON, usarías la propiedad `preferredVersions`: ```json { @@ -266,11 +322,15 @@ Con JSON Blueprints, usarías la propiedad `preferredVersions`: } ``` - + ## Ejecutar código PHP en el navegador - + La API de JavaScript proporciona el método `run()` que puedes usar para ejecutar código PHP en el navegador: @@ -294,6 +354,8 @@ La API de JavaScript proporciona el método `run()` que puedes usar para ejecuta ``` - + ¡Combina eso con un editor de código como Monaco o CodeMirror, y obtendrás fragmentos de código en vivo como en [este artículo](https://adamadam.blog/2023/02/16/how-to-modify-html-in-a-php-wordpress-plugin-using-the-new-tag-processor-api/)! diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 86a44c5b64..83ab59b868 100644 --- a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -1,14 +1,18 @@ --- title: Guide de démarrage rapide pour les développeurs slug: /developers/build-your-first-app -description: Guide pratique pour intégrer WordPress, installer des plugins, prévisualiser des PRs et créer des applications avec les APIs Playground. +description: Guide pratique pour intégrer WordPress, installer des plugins, prévisualiser des PRs et créer des applications avec les APIs de Playground. --- - + # Guide de démarrage rapide pour les développeurs - + WordPress Playground a été créé comme un outil programmable. Vous trouverez ci-dessous quelques exemples de ce que vous pouvez faire avec. Chaque API discutée est décrite en détail dans la [section APIs](/developers/apis/) : @@ -16,11 +20,15 @@ import TOCInline from '@theme/TOCInline'; - + ## Intégrer WordPress sur votre site web - + Playground peut être intégré sur votre site web en utilisant la balise HTML ` ``` - + -Chaque visiteur obtiendra sa propre instance WordPress privée gratuitement. Vous pouvez ensuite la personnaliser en utilisant l'une des [APIs Playground](/developers/apis/). +Chaque visiteur obtiendra sa propre instance WordPress privée gratuitement. Vous pouvez ensuite la personnaliser en utilisant l'une des [APIs de Playground](/developers/apis/). import PlaygroundWpNetWarning from '@site/docs/\_fragments/\_playground_wp_net_may_stop_working.md'; - + ## Contrôler le site web intégré - + -WordPress Playground fournit trois APIs que vous pouvez utiliser pour contrôler le site web en iframe. Tous les exemples de cette section sont construits en utilisant l'une d'entre elles : +WordPress Playground fournit trois APIs que vous pouvez utiliser pour contrôler le site web intégré. Tous les exemples de cette section sont construits en utilisant l'une de ces APIs : import APIList from '@site/docs/\_fragments/\_api_list.mdx'; - + -En savoir plus sur chacune de ces APIs dans la [section de présentation des APIs](/developers/apis/). +Apprenez-en plus sur chacune de ces APIs dans la [section aperçu des APIs](/developers/apis/). - + -## Présenter un plugin ou un thème du répertoire WordPress +## Présenter un plugin ou thème du répertoire WordPress import ThisIsQueryApi from '@site/docs/\_fragments/\_this_is_query_api.md'; - + -Vous pouvez installer des plugins et des thèmes du répertoire WordPress avec uniquement des paramètres d'URL. Cet iframe préinstalle les plugins `coblocks` et `friends` ainsi que le thème `pendant`. +Vous pouvez installer des plugins et thèmes du répertoire WordPress avec seulement des paramètres d'URL. Cet iframe préinstalle les plugins `coblocks` et `friends` et le thème `pendant`. @@ -68,17 +88,23 @@ Vous pouvez installer des plugins et des thèmes du répertoire WordPress avec u ``` - + ## Présenter n'importe quel plugin ou thème - + Et si votre plugin n'est pas dans le répertoire WordPress ? - + -Vous pouvez toujours le présenter sur Playground en utilisant les [JSON Blueprints](/blueprints). Par exemple, ce Blueprint téléchargerait et installerait un plugin et un thème depuis votre site web et importerait également du contenu de démarrage : +Vous pouvez toujours le présenter sur Playground en utilisant les [Blueprints JSON](/blueprints). Par exemple, ce Blueprint téléchargerait et installerait un plugin et un thème depuis votre site web et importerait également du contenu de démarrage : ```json { @@ -108,15 +134,21 @@ Vous pouvez toujours le présenter sur Playground en utilisant les [JSON Bluepri } ``` - + -Voir [commencer avec les Blueprints](/blueprints/getting-started) pour en savoir plus. +Consultez [débuter avec les Blueprints](/blueprints/getting-started) pour en savoir plus. - + ## Prévisualiser les pull requests de votre dépôt - + Vous pouvez prévisualiser le code du dépôt de deux manières : directement avec `git:directory`, ou en pointant vers un `.zip` de votre pipeline CI. Voici l'approche `git:directory` utilisant les [Blueprints](/blueprints) : @@ -128,35 +160,45 @@ Vous pouvez prévisualiser le code du dépôt de deux manières : directement av "pluginData": { "resource": "git:directory", "url": "https://github.com/my-user/my-repo", - "ref": "add-feature-xyz", - "refType": "branch" + "ref": "refs/pull/1/head", + "refType": "refname" + }, + "options": { + "activate": true + }, + "progress": { + "caption": "Installing plugin from my-user/my-repo PR #1" } } ] } ``` - - -`git:directory` ne nécessite aucune configuration CI. L'utilisation d'une URL .zip directe offre de meilleures performances car Playground télécharge un seul fichier, mais nécessite une configuration CI. - - + -Voir l'[exemple en direct du prévisualiseur de PR Gutenberg](https://playground.wordpress.net/gutenberg.html). +Charger un fichier `.zip` est une autre alternative pour prévisualiser votre projet. Consultez l'[exemple en direct du visualiseur de PR Gutenberg](https://playground.wordpress.net/gutenberg.html). - + -Pour utiliser Playground comme prévisualiseur de PR, vous avez besoin : +Pour utiliser Playground comme visualiseur de PR, vous avez besoin : - - + - D'un pipeline CI qui empaquette votre plugin ou thème - D'un accès public au fichier `.zip` généré - + -Ces archives zip ne sont pas différentes des plugins WordPress classiques, ce qui signifie que vous pouvez les installer dans Playground en utilisant l'API [JSON Blueprints](/blueprints). Une fois que vous exposez un point de terminaison comme https://your-site.com/pull-request-1234.zip, le Blueprint suivant fera le reste : +Ces archives zip ne sont pas différentes des plugins WordPress ordinaires, ce qui signifie que vous pouvez les installer dans Playground en utilisant l'API [Blueprints JSON](/blueprints). Une fois que vous exposez un endpoint comme https://your-site.com/pull-request-1234.zip, le Blueprint suivant fera le reste : ```json { @@ -172,7 +214,9 @@ Ces archives zip ne sont pas différentes des plugins WordPress classiques, ce q } ``` - + La démo officielle de Playground utilise cette technique pour prévisualiser les pull requests du dépôt Gutenberg : @@ -219,43 +263,55 @@ blueprint={{ ] }} /> - + ### Prévisualiser les branches ou PRs de WordPress Core et Gutenberg - + -Vous pouvez prévisualiser des branches ou pull requests spécifiques des dépôts WordPress Core et Gutenberg en utilisant les paramètres de la Query API. Cela est utile pour tester les dernières modifications du trunk ou des branches de fonctionnalités spécifiques sans créer de PR. +Vous pouvez prévisualiser des pull requests spécifiques des dépôts WordPress Core et Gutenberg en utilisant les paramètres de l'API Query. Les branches Gutenberg ont également une alternative pour les prévisualiser avec le paramètre `gutenberg-branch`. Ceci est utile pour tester les derniers changements du trunk ou des branches de fonctionnalités spécifiques sans créer de PR. - - - - + -- Prévisualiser la branche trunk de WordPress Core : `https://playground.wordpress.net/?core-branch=trunk` -- Prévisualiser une PR spécifique de WordPress Core : `https://playground.wordpress.net/?core-pr=9500` +- Prévisualiser un PR WordPress Core spécifique : `https://playground.wordpress.net/?core-pr=9500` +- Prévisualiser un PR Gutenberg spécifique : `https://playground.wordpress.net/?gutenberg-pr=73010` - Prévisualiser la branche trunk de Gutenberg : `https://playground.wordpress.net/?gutenberg-branch=trunk` -- Prévisualiser une PR spécifique de Gutenberg : `https://playground.wordpress.net/?gutenberg-pr=73010` - + -## Créer un environnement de test de compatibilité +## Construire un environnement de test de compatibilité - + Testez votre plugin sur différentes versions de PHP et WordPress en les configurant dans Playground. Cela vous aide à vérifier la compatibilité avant la publication. - + -Avec la Query API, vous ajouteriez simplement les paramètres de requête `php` et `wp` à l'URL : +Avec l'API Query, vous ajouteriez simplement les paramètres de requête `php` et `wp` à l'URL : ```html ``` - + -Avec les JSON Blueprints, vous utiliseriez la propriété `preferredVersions` : +Avec les Blueprints JSON, vous utiliseriez la propriété `preferredVersions` : ```json { @@ -266,11 +322,15 @@ Avec les JSON Blueprints, vous utiliseriez la propriété `preferredVersions` : } ``` - + ## Exécuter du code PHP dans le navigateur - + L'API JavaScript fournit la méthode `run()` que vous pouvez utiliser pour exécuter du code PHP dans le navigateur : @@ -294,6 +354,8 @@ L'API JavaScript fournit la méthode `run()` que vous pouvez utiliser pour exéc ``` - + Combinez cela avec un éditeur de code comme Monaco ou CodeMirror, et vous obtiendrez des extraits de code en direct comme dans [cet article](https://adamadam.blog/2023/02/16/how-to-modify-html-in-a-php-wordpress-plugin-using-the-new-tag-processor-api/) ! diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 7bfefe8f20..b48882dbb3 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -128,21 +128,23 @@ Você pode visualizar código do repositório de duas maneiras: diretamente com "pluginData": { "resource": "git:directory", "url": "https://github.com/my-user/my-repo", - "ref": "add-feature-xyz", - "refType": "branch" + "ref": "refs/pull/1/head", + "refType": "refname" + }, + "options": { + "activate": true + }, + "progress": { + "caption": "Installing plugin from my-user/my-repo PR #1" } } ] } ``` - - -`git:directory` não requer configuração de CI. Usar uma URL .zip direta tem melhor desempenho porque o Playground baixa um único arquivo, mas requer configuração de CI. + - - -Veja o [exemplo ao vivo do visualizador de PR do Gutenberg](https://playground.wordpress.net/gutenberg.html). +Carregar um arquivo `.zip` é outra alternativa para visualizar seu projeto. Veja o [exemplo ao vivo do visualizador de PR do Gutenberg](https://playground.wordpress.net/gutenberg.html). @@ -223,19 +225,17 @@ blueprint={{ ### Visualizar Branches ou PRs do WordPress Core e Gutenberg - + -Você pode visualizar branches ou pull requests específicos dos repositórios WordPress Core e Gutenberg usando parâmetros da Query API. Isso é útil para testar as últimas alterações do trunk ou branches de recursos específicos sem criar um PR. +Você pode visualizar pull requests específicos dos repositórios WordPress Core e Gutenberg usando parâmetros da Query API. Os branches do Gutenberg também têm uma alternativa para visualizá-los com o parâmetro `gutenberg-branch`. Isso é útil para testar as últimas alterações do trunk ou branches de recursos específicos sem criar um PR. - - + -- Visualizar branch trunk do WordPress Core: `https://playground.wordpress.net/?core-branch=trunk` - Visualizar um PR específico do WordPress Core: `https://playground.wordpress.net/?core-pr=9500` -- Visualizar branch trunk do Gutenberg: `https://playground.wordpress.net/?gutenberg-branch=trunk` - Visualizar um PR específico do Gutenberg: `https://playground.wordpress.net/?gutenberg-pr=73010` +- Visualizar o branch trunk do Gutenberg: `https://playground.wordpress.net/?gutenberg-branch=trunk` From 0945724924aa21a90812f08d32b9746c52002934 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 18 Nov 2025 11:06:04 +0000 Subject: [PATCH 09/11] adding info about refType --- packages/docs/site/docs/developers/03-build-an-app/01-index.md | 2 ++ .../current/developers/03-build-an-app/01-index.md | 2 ++ .../current/developers/03-build-an-app/01-index.md | 2 ++ .../current/developers/03-build-an-app/01-index.md | 2 ++ 4 files changed, 8 insertions(+) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index cfa5f6f927..3207f5d749 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -109,6 +109,8 @@ You can preview repository code two ways: directly with `git:directory`, or by p } ``` +In the code above, it will install a plugin from a repository located at the `url`, and the reference to find the branch is `refType`; in this case, it will use `refname`, but it can also use `branch`, `tag`, and `commit`. + Loading a `.zip` file is another alternative for previewing your project. See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). To use Playground as a PR previewer, you need: diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 1fa090a7a4..3822e10dd1 100644 --- a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -174,6 +174,8 @@ Puedes previsualizar código del repositorio de dos maneras: directamente con `g } ``` +En el código anterior, se instalará un complemento desde un repositorio ubicado en `url`, y la referencia para encontrar la rama es `refType`; en este caso, se utilizará `refname`, pero también se puede utilizar `branch`, `tag` y `commit`. + diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 83ab59b868..9eacc3f686 100644 --- a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -174,6 +174,8 @@ Vous pouvez prévisualiser le code du dépôt de deux manières : directement av } ``` +Dans le code ci-dessus, un plugin sera installé à partir d'un dépôt situé à l'URL indiquée, et la référence pour trouver la branche est `refType` ; dans ce cas, il utilisera `refname`, mais il peut également utiliser `branch`, `tag` et `commit`. + diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index b48882dbb3..6004a431df 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -142,6 +142,8 @@ Você pode visualizar código do repositório de duas maneiras: diretamente com } ``` +No código acima, será instalado um plugin de um repositório localizado na `url`, e a referência para encontrar o branch é `refType`; neste caso, será usado `refname`, mas também pode ser usado `branch`, `tag` e `commit`. + Carregar um arquivo `.zip` é outra alternativa para visualizar seu projeto. Veja o [exemplo ao vivo do visualizador de PR do Gutenberg](https://playground.wordpress.net/gutenberg.html). From f5e8ab6efefaae4aa8e70bb54298b3e690118099 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 18 Nov 2025 13:01:06 +0000 Subject: [PATCH 10/11] Adding gitbub preview git action --- .../docs/site/docs/developers/03-build-an-app/01-index.md | 4 ++++ .../current/developers/03-build-an-app/01-index.md | 4 ++++ .../current/developers/03-build-an-app/01-index.md | 4 ++++ .../current/developers/03-build-an-app/01-index.md | 4 ++++ 4 files changed, 16 insertions(+) diff --git a/packages/docs/site/docs/developers/03-build-an-app/01-index.md b/packages/docs/site/docs/developers/03-build-an-app/01-index.md index 3207f5d749..d232cb80ba 100644 --- a/packages/docs/site/docs/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/docs/developers/03-build-an-app/01-index.md @@ -111,6 +111,10 @@ You can preview repository code two ways: directly with `git:directory`, or by p In the code above, it will install a plugin from a repository located at the `url`, and the reference to find the branch is `refType`; in this case, it will use `refname`, but it can also use `branch`, `tag`, and `commit`. +:::tip +You can automate this process using the [GitHub Action to generate preview links](/guides/github-action-pr-preview), which will help streamline the process. +::: + Loading a `.zip` file is another alternative for previewing your project. See the [live example of Gutenberg PR previewer](https://playground.wordpress.net/gutenberg.html). To use Playground as a PR previewer, you need: diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 3822e10dd1..4107659fec 100644 --- a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -176,6 +176,10 @@ Puedes previsualizar código del repositorio de dos maneras: directamente con `g En el código anterior, se instalará un complemento desde un repositorio ubicado en `url`, y la referencia para encontrar la rama es `refType`; en este caso, se utilizará `refname`, pero también se puede utilizar `branch`, `tag` y `commit`. +:::tip +Puedes automatizar este proceso usando la [Acción de GitHub para generar enlaces de vista previa](/guides/github-action-pr-preview), lo que te ayudará a agilizarlo. +::: + diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 9eacc3f686..68d411497e 100644 --- a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -176,6 +176,10 @@ Vous pouvez prévisualiser le code du dépôt de deux manières : directement av Dans le code ci-dessus, un plugin sera installé à partir d'un dépôt situé à l'URL indiquée, et la référence pour trouver la branche est `refType` ; dans ce cas, il utilisera `refname`, mais il peut également utiliser `branch`, `tag` et `commit`. +:::tip +Vous pouvez automatiser ce processus à l'aide de l'[Action GitHub pour générer des liens de prévisualisation](/guides/github-action-pr-preview), ce qui permettra de le simplifier. +::: + diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 6004a431df..3b87c2a803 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -144,6 +144,10 @@ Você pode visualizar código do repositório de duas maneiras: diretamente com No código acima, será instalado um plugin de um repositório localizado na `url`, e a referência para encontrar o branch é `refType`; neste caso, será usado `refname`, mas também pode ser usado `branch`, `tag` e `commit`. +:::tip +Você pode automatizar esse processo usando a [Ação do GitHub para gerar links de pré-visualização](/guides/github-action-pr-preview), o que ajudará a agilizar o processo. +::: + Carregar um arquivo `.zip` é outra alternativa para visualizar seu projeto. Veja o [exemplo ao vivo do visualizador de PR do Gutenberg](https://playground.wordpress.net/gutenberg.html). From 9ad8d9f2cf72513dc0e0096b0dc13e4e406b2f5a Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 18 Nov 2025 15:55:10 +0000 Subject: [PATCH 11/11] updating French Translation base on preview --- .../developers/03-build-an-app/01-index.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md index 68d411497e..ea7794175e 100644 --- a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/03-build-an-app/01-index.md @@ -1,7 +1,7 @@ --- title: Guide de démarrage rapide pour les développeurs slug: /developers/build-your-first-app -description: Guide pratique pour intégrer WordPress, installer des plugins, prévisualiser des PRs et créer des applications avec les APIs de Playground. +description: Guide pratique pour intégrer WordPress, installer des extensions, prévisualiser des PRs et créer des applications avec les APIs Playground. --- -## Intégrer WordPress sur votre site web +## Intégrer WordPress sur votre site -Playground peut être intégré sur votre site web en utilisant la balise HTML ` @@ -50,13 +50,13 @@ import PlaygroundWpNetWarning from '@site/docs/\_fragments/\_playground_wp_net_m ## Control the embedded website --> -## Contrôler le site web intégré +## Contrôler le site intégré -WordPress Playground fournit trois APIs que vous pouvez utiliser pour contrôler le site web intégré. Tous les exemples de cette section sont construits en utilisant l'une de ces APIs : +WordPress Playground fournit trois APIs que vous pouvez utiliser pour contrôler le site en iframe. Tous les exemples de cette section sont construits en utilisant l’une d'entre elles : import APIList from '@site/docs/\_fragments/\_api_list.mdx'; @@ -98,13 +98,13 @@ Vous pouvez installer des plugins et thèmes du répertoire WordPress avec seule What if your plugin is not in the WordPress directory? --> -Et si votre plugin n'est pas dans le répertoire WordPress ? +Et si votre extension ne figure pas dans le répertoire de WordPress ? -Vous pouvez toujours le présenter sur Playground en utilisant les [Blueprints JSON](/blueprints). Par exemple, ce Blueprint téléchargerait et installerait un plugin et un thème depuis votre site web et importerait également du contenu de démarrage : +Vous pouvez toujours la présenter avec Playground en utilisant les [JSON Blueprints](/blueprints). Par exemple, ce Blueprint téléchargerait et installerait une extension et un thème depuis votre site et importerait également un contenu de démarrage : ```json { @@ -204,7 +204,7 @@ Pour utiliser Playground comme visualiseur de PR, vous avez besoin : Those zip bundles aren't any different from regular WordPress Plugins, which means you can install them in Playground using the [JSON Blueprints](/blueprints) API. Once you expose an endpoint like https://your-site.com/pull-request-1234.zip, the following Blueprint will do the rest: --> -Ces archives zip ne sont pas différentes des plugins WordPress ordinaires, ce qui signifie que vous pouvez les installer dans Playground en utilisant l'API [Blueprints JSON](/blueprints). Une fois que vous exposez un endpoint comme https://your-site.com/pull-request-1234.zip, le Blueprint suivant fera le reste : +Ces archives zip ne sont pas différentes des extensions WordPress classiques, ce qui signifie que vous pouvez les installer dans Playground en utilisant l'API [JSON Blueprints](/blueprints). Une fois que vous exposez un point de terminaison comme `https://your-site.com/pull-request-1234.zip`, le Blueprint suivant fera le reste : ```json { @@ -301,7 +301,7 @@ Vous pouvez prévisualiser des pull requests spécifiques des dépôts WordPress Test your plugin across PHP and WordPress versions by configuring them in Playground. This helps you verify compatibility before release. --> -Testez votre plugin sur différentes versions de PHP et WordPress en les configurant dans Playground. Cela vous aide à vérifier la compatibilité avant la publication. +Testez votre extension sur différentes versions de PHP et WordPress en les configurant dans Playground. Cela vous aide à vérifier la compatibilité avant la publication.