diff --git a/packages/docs/site/docs/developers/06-apis/query-api/01-index.md b/packages/docs/site/docs/developers/06-apis/query-api/01-index.md index 52c5b98b89a..a6552000645 100644 --- a/packages/docs/site/docs/developers/06-apis/query-api/01-index.md +++ b/packages/docs/site/docs/developers/06-apis/query-api/01-index.md @@ -46,6 +46,7 @@ You can go ahead and try it out. The Playground will automatically install the t | `can-save` | | Default functionality allows for saving Playgrounds to the user's computer or browser. If you would like to turn off the ability for users to save their Playground, add the `?can-save=no` parameter, and options to save will be removed from the UI. | | `mcp` | `no` | Starts the MCP (Model Context Protocol) server bridge, allowing external MCP clients to connect to and control the Playground instance. Accepts `yes` or `no`. | | `mcp-port` | `7999` | Sets the WebSocket port used by the MCP bridge to communicate with the MCP server. Must be used together with `mcp=yes`. For example, `mcp=yes&mcp-port=8080`. | +| `overlay` | | Opens a UI overlay on page load. Currently supports `blueprints` to open the Blueprint Gallery directly. For example, `?overlay=blueprints`. The parameter is removed from the URL when the overlay is closed. | For example, the following code embeds a Playground with a preinstalled Gutenberg plugin and opens the post editor: diff --git a/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md new file mode 100644 index 00000000000..7c9752cb216 --- /dev/null +++ b/packages/docs/site/i18n/es/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md @@ -0,0 +1,113 @@ +--- +sidebar_position: 5 +slug: /developers/apis/query-api +description: Esta página detalla la Query API de WordPress Playground, que permite configurar una instancia de WP mediante parámetros de URL. +--- + + + +# API de consulta (Query API) + + + +WordPress Playground expone una API sencilla que puedes usar para configurar la instancia de Playground en el navegador. + + + +Funciona pasando opciones de configuración como parámetros de consulta en la URL de Playground. Por ejemplo, para instalar el tema pendant, usarías la siguiente URL: + +```text +https://playground.wordpress.net/?theme=pendant +``` + + + +Puedes probarlo ahora mismo. Playground instalará automáticamente el tema e iniciará sesión como administrador. También puedes incrustar esta URL en tu sitio con una etiqueta ` +``` + + + +## Opciones disponibles + +| Opción | Valor predeterminado | Descripción | +| ------------------ | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `php` | `8.5` | Carga la versión de PHP indicada. Acepta `7.4`, `8.0`, `8.1`, `8.2`, `8.3`, `8.4`, `8.5` o `latest`. | +| `wp` | `latest` | Carga la versión de WordPress indicada. Acepta las tres últimas versiones principales. A partir del 1 de junio de 2024, son `6.3`, `6.4` o `6.5`. También puedes usar los valores genéricos `latest`, `nightly` o `beta`. | +| `blueprint-url` | | URL del Blueprint que se usará para configurar esta instancia de Playground. | +| `networking` | `yes` | Activa o desactiva la compatibilidad de red en Playground. Acepta `yes` o `no`. | +| `plugin` | | Instala el plugin indicado. Usa el nombre del plugin según la URL del directorio de plugins de WordPress. Por ejemplo, si la URL es `https://wordpress.org/plugins/wp-lazy-loading/`, el nombre sería `wp-lazy-loading`. Puedes preinstalar varios plugins con `plugin=coblocks&plugin=wp-lazy-loading&…`. Instalar un plugin inicia sesión automáticamente como admin. Puedes instalar más de un plugin repitiendo el parámetro `plugin` en la URL. | +| `theme` | | Instala el tema indicado. Usa el nombre del tema según la URL del directorio de temas. Por ejemplo, si la URL es `https://wordpress.org/themes/disco/`, el nombre sería `disco`. Instalar un tema inicia sesión automáticamente como admin. Puedes instalar varios temas repitiendo el parámetro `theme` en la URL. | +| `url` | `/wp-admin/` | Carga la página inicial de WordPress indicada en esta instancia de Playground. | +| `mode` | `browser-full-screen` | Determina cómo se muestra la instancia de WordPress: envuelta en una interfaz de navegador o a ancho completo para una experiencia continua. Acepta `browser-full-screen` o `seamless`. | +| `lazy` | | Diferir la carga de los recursos de Playground hasta que alguien pulse el botón "Ejecutar". No acepta valores. Si se añade `lazy` como parámetro de URL, la carga se diferirá. | +| `login` | `yes` | Inicia sesión como administrador. Acepta `yes` o `no`. | +| `multisite` | `no` | Activa el modo multisitio de WordPress. Acepta `yes` o `no`. | +| `import-site` | | Importa archivos del sitio y la base de datos desde un ZIP indicado por URL. | +| `import-wxr` | | Importa el contenido del sitio desde un archivo WXR indicado por URL. Usa el plugin WordPress Importer; el usuario admin de WordPress debe tener sesión iniciada. | +| `site-slug` | | Selecciona qué sitio cargar desde el almacenamiento del navegador. Si el sitio no existe, se pedirá guardar uno nuevo con el slug indicado. | +| `language` | `en_US` | Establece el idioma de la instancia de WordPress. Debe usarse junto con `networking=yes`; de lo contrario WordPress no podrá descargar traducciones. | +| `core-pr` | | Instala un PR concreto del core en https://github.com/WordPress/wordpress-develop. Acepta el número del PR. Por ejemplo, `core-pr=6883`. | +| `gutenberg-pr` | | Instala un PR concreto de Gutenberg en https://github.com/WordPress/gutenberg. Acepta el número del PR. Por ejemplo, `gutenberg-pr=65337`. | +| `gutenberg-branch` | | Instala una rama concreta de https://github.com/WordPress/gutenberg. Acepta el nombre de la rama. Por ejemplo, `gutenberg-branch=trunk`. | +| `page-title` | | Personaliza el título de la pestaña del navegador. Útil para identificar distintas instancias de Playground al trabajar con varias pestañas. El parámetro se conserva al navegar entre sitios. | +| `can-save` | | Por defecto se permite guardar Playgrounds en el ordenador o el navegador del usuario. Para desactivar la posibilidad de guardar, añade `?can-save=no` y las opciones de guardar desaparecerán de la interfaz. | +| `mcp` | `no` | Inicia el puente del servidor MCP (Model Context Protocol), permitiendo que clientes MCP externos conecten y controlen la instancia de Playground. Acepta `yes` o `no`. | +| `mcp-port` | `7999` | Define el puerto WebSocket de puente MCP para comunicarse con el servidor MCP. Debe usarse junto con `mcp=yes`. Por ejemplo, `mcp=yes&mcp-port=8080`. | +| `overlay` | | Abre una superposición de interfaz al cargar la página. Actualmente admite `blueprints` para abrir la Galería de Blueprints directamente. Por ejemplo, `?overlay=blueprints`. El parámetro se elimina de la URL al cerrar la superposición. | + + + +Por ejemplo, el siguiente código incrusta un Playground con el plugin Gutenberg preinstalado y abre el editor de entradas: + +```html + +``` + +:::info Política CORS + + + +Para importar archivos desde una URL, como un paquete zip del sitio, deben servirse con el encabezado `Access-Control-Allow-Origin` configurado. Consulta: [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#the_http_response_headers). + +::: + + + +## Opciones de exportación a GitHub + + + +Los siguientes parámetros de consulta adicionales pueden usarse para preconfigurar el formulario de exportación a GitHub: + +- `gh-ensure-auth`: Si se establece en `yes`, Playground mostrará un modal para asegurar que el usuario esté autenticado en GitHub antes de continuar. +- `ghexport-repo-url`: URL del repositorio de GitHub de destino. +- `ghexport-pr-action`: Acción al exportar (crear o actualizar). +- `ghexport-playground-root`: Directorio raíz en Playground desde el que exportar. +- `ghexport-repo-root`: Directorio raíz en el repositorio a destino. +- `ghexport-content-type`: Tipo de contenido de la exportación (plugin, theme, wp-content, custom-paths). +- `ghexport-plugin`: Ruta del plugin. Cuando el tipo es `plugin`, preselecciona el plugin a exportar. +- `ghexport-theme`: Nombre del directorio del tema. Cuando el tipo es `theme`, preselecciona el tema a exportar. +- `ghexport-path`: Ruta relativa a `ghexport-playground-root`. Puede repetirse varias veces. Cuando el tipo es `custom-paths`, rellena la lista de rutas a exportar. +- `ghexport-commit-message`: Mensaje de commit al exportar. +- `ghexport-allow-include-zip`: Si se ofrece la opción de incluir un zip en la exportación a GitHub (`yes`, `no`). Opcional. Por defecto `yes`. diff --git a/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md new file mode 100644 index 00000000000..2a3992dcf3d --- /dev/null +++ b/packages/docs/site/i18n/fr/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md @@ -0,0 +1,113 @@ +--- +sidebar_position: 5 +slug: /developers/apis/query-api +description: Cette page décrit la Query API de WordPress Playground pour configurer une instance WP via des paramètres d’URL. +--- + + + +# API de requête (Query API) + + + +WordPress Playground expose une API simple pour configurer l’instance Playground dans le navigateur. + + + +Elle fonctionne en passant des options de configuration sous forme de paramètres de requête dans l’URL Playground. Par exemple, pour installer le thème pendant, utilisez l’URL suivante : + +```text +https://playground.wordpress.net/?theme=pendant +``` + + + +Vous pouvez l’essayer tout de suite. Playground installera automatiquement le thème et vous connectera en tant qu’administrateur. Vous pouvez également intégrer cette URL à votre site avec une balise ` +``` + + + +## Options disponibles + +| Option | Valeur par défaut | Description | +| ------------------ | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `php` | `8.5` | Charge la version PHP indiquée. Accepte `7.4`, `8.0`, `8.1`, `8.2`, `8.3`, `8.4`, `8.5` ou `latest`. | +| `wp` | `latest` | Charge la version WordPress indiquée. Accepte les trois dernières versions majeures. Au 1er juin 2024, il s’agit de `6.3`, `6.4` ou `6.5`. Vous pouvez aussi utiliser `latest`, `nightly` ou `beta`. | +| `blueprint-url` | | URL du Blueprint utilisé pour configurer cette instance Playground. | +| `networking` | `yes` | Active ou désactive le réseau dans Playground. Accepte `yes` ou `no`. | +| `plugin` | | Installe l’extension indiquée. Utilisez le nom tel qu’il apparaît dans l’URL du répertoire d’extensions WordPress. Par exemple, pour `https://wordpress.org/plugins/wp-lazy-loading/`, le nom est `wp-lazy-loading`. Préinstallez plusieurs extensions avec `plugin=coblocks&plugin=wp-lazy-loading&…`. L’installation connecte automatiquement en admin. Plusieurs extensions peuvent être installées en répétant le paramètre `plugin` dans l’URL. | +| `theme` | | Installe le thème indiqué. Utilisez le nom tel qu’il apparaît dans l’URL du répertoire de thèmes. Par exemple, pour `https://wordpress.org/themes/disco/`, le nom est `disco`. L’installation connecte automatiquement en admin. Plusieurs thèmes peuvent être installés en répétant le paramètre `theme` dans l’URL. | +| `url` | `/wp-admin/` | Charge la page WordPress initiale indiquée dans cette instance Playground. | +| `mode` | `browser-full-screen` | Détermine l’affichage de l’instance WordPress : dans une interface navigateur ou en pleine largeur pour une expérience continue. Accepte `browser-full-screen` ou `seamless`. | +| `lazy` | | Diffère le chargement des ressources Playground jusqu’à ce que l’utilisateur clique sur « Exécuter ». N’accepte pas de valeur. Si `lazy` est présent dans l’URL, le chargement est différé. | +| `login` | `yes` | Connecte l’utilisateur en tant qu’administrateur. Accepte `yes` ou `no`. | +| `multisite` | `no` | Active le mode multisite WordPress. Accepte `yes` ou `no`. | +| `import-site` | | Importe les fichiers du site et la base de données depuis une archive ZIP indiquée par une URL. | +| `import-wxr` | | Importe le contenu du site depuis un fichier WXR indiqué par une URL. Utilise l’extension WordPress Importer ; l’administrateur par défaut doit être connecté. | +| `site-slug` | | Sélectionne le site à charger depuis le stockage du navigateur. Si le site n’existe pas, l’utilisateur est invité à en enregistrer un nouveau avec le slug indiqué. | +| `language` | `en_US` | Définit la locale de l’instance WordPress. À utiliser avec `networking=yes`, sinon WordPress ne pourra pas télécharger les traductions. | +| `core-pr` | | Installe une PR spécifique du core sur https://github.com/WordPress/wordpress-develop. Accepte le numéro de PR. Par exemple, `core-pr=6883`. | +| `gutenberg-pr` | | Installe une PR spécifique de Gutenberg sur https://github.com/WordPress/gutenberg. Accepte le numéro de PR. Par exemple, `gutenberg-pr=65337`. | +| `gutenberg-branch` | | Installe une branche spécifique depuis https://github.com/WordPress/gutenberg. Accepte le nom de branche. Par exemple, `gutenberg-branch=trunk`. | +| `page-title` | | Personnalise le titre de l’onglet du navigateur. Utile pour distinguer plusieurs instances Playground. Le paramètre est conservé lors de la navigation entre sites. | +| `can-save` | | Par défaut, le Playground peut être enregistré sur l’ordinateur ou le navigateur du visiteur. Pour désactiver l’enregistrement, ajoutez `?can-save=no` : les options d’enregistrement disparaissent de l’interface. | +| `mcp` | `no` | Démarre le pont serveur MCP (Model Context Protocol), permettant aux clients MCP externes de se connecter et de contrôler l’instance Playground. Accepte `yes` ou `no`. | +| `mcp-port` | `7999` | Définit le port WebSocket utilisé par le pont MCP pour communiquer avec le serveur MCP. À utiliser avec `mcp=yes`. Par exemple, `mcp=yes&mcp-port=8080`. | +| `overlay` | | Ouvre une superposition d’interface au chargement de la page. Prend actuellement en charge `blueprints` pour ouvrir directement la galerie de Blueprints. Par exemple, `?overlay=blueprints`. Le paramètre est retiré de l’URL à la fermeture de la superposition. | + + + +Par exemple, le code suivant intègre un Playground avec l’extension Gutenberg préinstallée et ouvre l’éditeur d’articles : + +```html + +``` + +:::info Politique CORS + + + +Pour importer des fichiers depuis une URL, comme une archive zip du site, ils doivent être servis avec l’en-tête `Access-Control-Allow-Origin` défini. Référence : [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#the_http_response_headers). + +::: + + + +## Options d’exportation GitHub + + + +Les paramètres de requête suivants permettent de préconfigurer le formulaire d’exportation GitHub : + +- `gh-ensure-auth` : Si défini à `yes`, Playground affiche une fenêtre pour s’assurer que l’utilisateur est authentifié sur GitHub avant de continuer. +- `ghexport-repo-url` : URL du dépôt GitHub de destination. +- `ghexport-pr-action` : Action à l’exportation (créer ou mettre à jour). +- `ghexport-playground-root` : Répertoire racine dans Playground à partir duquel exporter. +- `ghexport-repo-root` : Répertoire racine dans le dépôt de destination. +- `ghexport-content-type` : Type de contenu exporté (plugin, theme, wp-content, custom-paths). +- `ghexport-plugin` : Chemin de l’extension. Lorsque le type est `plugin`, pré-sélectionne l’extension à exporter. +- `ghexport-theme` : Nom du répertoire du thème. Lorsque le type est `theme`, pré-sélectionne le thème à exporter. +- `ghexport-path` : Chemin relatif à `ghexport-playground-root`. Peut être fourni plusieurs fois. Lorsque le type est `custom-paths`, préremplit la liste des chemins à exporter. +- `ghexport-commit-message` : Message de commit utilisé lors de l’exportation. +- `ghexport-allow-include-zip` : Proposer ou non d’inclure une archive zip dans l’export GitHub (`yes`, `no`). Optionnel. Par défaut `yes`. diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md index 869676bab5a..9bffc9e2d04 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/developers/06-apis/query-api/01-index.md @@ -1,17 +1,24 @@ --- sidebar_position: 5 slug: /developers/apis/query-api +description: Esta página detalha a Query API do WordPress Playground, permitindo configurar uma instância WP via parâmetros de URL. --- - + # API de Query - + O WordPress Playground expõe uma API simples que você pode usar para configurar o Playground no navegador. - + Ela funciona passando opções de configuração como parâmetros de consulta (query) para a URL do Playground. Por exemplo, para instalar o tema pendant, você usaria a seguinte URL: @@ -19,39 +26,51 @@ Ela funciona passando opções de configuração como parâmetros de consulta (q https://playground.wordpress.net/?theme=pendant ``` - + -Você pode testar isso agora mesmo. O Playground irá instalar automaticamente o tema e fazer login como administrador. Você pode até incorporar essa URL no seu site usando uma tag ` ``` - + ## Opções disponíveis -| Opção | Valor padrão | Descrição | -| --------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| `php` | `8.0` | Carrega a versão especificada do PHP. Aceita `7.4`, `8.0`, `8.1`, `8.2`, `8.3`, `8.4`, `8.5` ou `latest`. | -| `wp` | `latest` | Carrega a versão especificada do WordPress. Aceita as três últimas versões principais do WordPress. Em junho de 2024, são `6.3`, `6.4` ou `6.5`. Você também pode usar os valores genéricos `latest`, `nightly` ou `beta`. | -| `blueprint-url` | | A URL do Blueprint que será usada para configurar esta instância do Playground. | -| `networking` | `yes` | Ativa ou desativa o suporte a rede no Playground. Aceita `yes` ou `no`. | -| `plugin` | | Instala o plugin especificado. Use o nome do plugin conforme aparece na URL do Diretório de Plugins do WordPress. Por exemplo, se a URL for `https://wordpress.org/plugins/wp-lazy-loading/`, o nome do plugin seria `wp-lazy-loading`. Você pode pré-instalar múltiplos plugins usando `plugin=coblocks&plugin=wp-lazy-loading&…`. Instalar um plugin faz login automático como admin. | -| `theme` | | Instala o tema especificado. Use o nome do tema conforme aparece na URL do Diretório de Temas do WordPress. Por exemplo, se a URL for `https://wordpress.org/themes/disco/`, o nome do tema seria `disco`. Instalar um tema faz login automático como admin. | -| `url` | `/wp-admin/` | Carrega a página inicial do WordPress especificada nesta instância do Playground. | -| `mode` | `browser-full-screen` | Determina como a instância do WordPress é exibida. Pode ser envolta em uma interface de navegador ou em largura total para uma experiência sem bordas. Aceita `browser-full-screen` ou `seamless`. | -| `lazy` | | Adia o carregamento dos assets do Playground até que alguém clique no botão "Executar". Não aceita valores. Se `lazy` for adicionado como parâmetro de URL, o carregamento será adiado. | -| `login` | `yes` | Faz login do usuário como admin. Aceita `yes` ou `no`. | -| `multisite` | `no` | Ativa o modo multisite do WordPress. Aceita `yes` ou `no`. | -| `import-site` | | Importa arquivos do site e banco de dados a partir de um arquivo ZIP especificado por uma URL. | -| `import-wxr` | | Importa conteúdo do site a partir de um arquivo WXR especificado por uma URL. Usa o plugin WordPress Importer, então o usuário admin padrão deve estar logado. | -| `site-slug` | | Seleciona qual site carregar do armazenamento do navegador. Se o site especificado não existir, o usuário será solicitado a salvar um novo site com o slug especificado. | -| `language` | `en_US` | Define o idioma da instância do WordPress. Deve ser usado em conjunto com `networking=yes`, caso contrário o WordPress não conseguirá baixar traduções. | -| `core-pr` | | Instala um PR específico do core em https://github.com/WordPress/wordpress-develop. Aceita o número do PR. Por exemplo, `core-pr=6883`. | -| `gutenberg-pr` | | Instala um PR específico do Gutenberg em https://github.com/WordPress/gutenberg. Aceita o número do PR. Por exemplo, `gutenberg-pr=65337`. | - - +| Opção | Valor padrão | Descrição | +| ------------------ | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `php` | `8.5` | Carrega a versão especificada do PHP. Aceita `7.4`, `8.0`, `8.1`, `8.2`, `8.3`, `8.4`, `8.5` ou `latest`. | +| `wp` | `latest` | Carrega a versão especificada do WordPress. Aceita as três últimas versões principais do WordPress. A partir de 1º de junho de 2024, isso significa `6.3`, `6.4` ou `6.5`. Você também pode usar os valores genéricos `latest`, `nightly` ou `beta`. | +| `blueprint-url` | | A URL do Blueprint usada para configurar esta instância do Playground. | +| `networking` | `yes` | Ativa ou desativa o suporte a rede no Playground. Aceita `yes` ou `no`. | +| `plugin` | | Instala o plugin especificado. Use o nome do plugin conforme aparece na URL do Diretório de Plugins do WordPress. Por exemplo, se a URL for `https://wordpress.org/plugins/wp-lazy-loading/`, o nome do plugin seria `wp-lazy-loading`. Você pode pré-instalar vários plugins com `plugin=coblocks&plugin=wp-lazy-loading&…`. Instalar um plugin faz login automático como admin. Mais de um plugin pode ser instalado repetindo o atributo `plugin` na URL. | +| `theme` | | Instala o tema especificado. Use o nome do tema conforme aparece na URL do Diretório de Temas do WordPress. Por exemplo, se a URL for `https://wordpress.org/themes/disco/`, o nome do tema seria `disco`. Instalar um tema faz login automático como admin. Vários temas podem ser instalados repetindo o atributo `theme` na URL. | +| `url` | `/wp-admin/` | Carrega a página inicial do WordPress especificada nesta instância do Playground. | +| `mode` | `browser-full-screen` | Determina como a instância do WordPress é exibida: envolta em uma interface de navegador ou em largura total para uma experiência contínua. Aceita `browser-full-screen` ou `seamless`. | +| `lazy` | | Adia o carregamento dos assets do Playground até alguém clicar no botão "Executar". Não aceita valores. Se `lazy` for adicionado como parâmetro de URL, o carregamento será adiado. | +| `login` | `yes` | Faz login do usuário como admin. Aceita `yes` ou `no`. | +| `multisite` | `no` | Ativa o modo multisite do WordPress. Aceita `yes` ou `no`. | +| `import-site` | | Importa arquivos do site e banco de dados a partir de um arquivo ZIP especificado por uma URL. | +| `import-wxr` | | Importa conteúdo do site a partir de um arquivo WXR especificado por uma URL. Usa o plugin WordPress Importer, então o usuário admin padrão deve estar logado. | +| `site-slug` | | Seleciona qual site carregar do armazenamento do navegador. Se o site especificado não existir, o usuário será solicitado a salvar um novo site com o slug especificado. | +| `language` | `en_US` | Define o idioma da instância do WordPress. Deve ser usado em conjunto com `networking=yes`; caso contrário o WordPress não conseguirá baixar traduções. | +| `core-pr` | | Instala um PR específico do core em https://github.com/WordPress/wordpress-develop. Aceita o número do PR. Por exemplo, `core-pr=6883`. | +| `gutenberg-pr` | | Instala um PR específico do Gutenberg em https://github.com/WordPress/gutenberg. Aceita o número do PR. Por exemplo, `gutenberg-pr=65337`. | +| `gutenberg-branch` | | Instala um branch específico de https://github.com/WordPress/gutenberg. Aceita o nome do branch. Por exemplo, `gutenberg-branch=trunk`. | +| `page-title` | | Personaliza o título da aba do navegador. Útil para identificar diferentes instâncias do Playground ao trabalhar com várias abas. O parâmetro é preservado ao navegar entre sites. | +| `can-save` | | Por padrão o Playground pode ser salvo no computador ou no navegador do usuário. Para desativar a possibilidade de salvar, adicione `?can-save=no`, e as opções de salvar serão removidas da interface. | +| `mcp` | `no` | Inicia o bridge do servidor MCP (Model Context Protocol), permitindo que clientes MCP externos conectem e controlem a instância do Playground. Aceita `yes` ou `no`. | +| `mcp-port` | `7999` | Define a porta WebSocket usada pelo bridge MCP para comunicar com o servidor MCP. Deve ser usado junto com `mcp=yes`. Por exemplo, `mcp=yes&mcp-port=8080`. | +| `overlay` | | Abre uma sobreposição de interface ao carregar a página. Atualmente suporta `blueprints` para abrir a Galeria de Blueprints diretamente. Por exemplo, `?overlay=blueprints`. O parâmetro é removido da URL quando a sobreposição é fechada. | + + Por exemplo, o código a seguir incorpora um Playground com o plugin Gutenberg pré-instalado e abre o editor de posts: @@ -61,17 +80,23 @@ Por exemplo, o código a seguir incorpora um Playground com o plugin Gutenberg p :::info Política de CORS - + Para importar arquivos de uma URL, como um pacote zip de site, eles devem ser servidos com o cabeçalho `Access-Control-Allow-Origin` configurado. Para referência, veja: [Cross-Origin Resource Sharing (CORS)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#the_http_response_headers). ::: - + ## Opções de exportação para o GitHub - + Os seguintes parâmetros de consulta adicionais podem ser usados para pré-configurar o formulário de exportação para o GitHub: