From dd3df77c19f8ae49380f8f2da6107fe494d93bca Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Thu, 10 Jul 2025 13:07:25 +0100 Subject: [PATCH 1/9] Adding the resources page in portuguese --- .../current/main/resources.md | 142 ++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md new file mode 100644 index 0000000000..5e40eb5cd1 --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md @@ -0,0 +1,142 @@ +--- +title: Links e Recursos +slug: /resources +--- + + + +# Links e Recursos + + + +:::tip + +Existe um conjunto de redirecionamentos para facilitar o acesso a algumas das ferramentas relacionadas ao Playground: + + +::: + + + +## Links frequentemente procurados + + + +- [Demonstração](https://playground.wordpress.net/) +- [Repositório no Github](https://github.com/WordPress/wordpress-playground) +- [Documentação](https://wordpress.github.io/wordpress-playground/) +- [Repositório das ferramentas do Playground](https://github.com/WordPress/playground-tools) + + + +## Aplicações construídas com o WordPress Playground + + + +- [Demonstração oficial](https://playground.wordpress.net/) e a aplicação de [vitrine](https://developer.wordpress.org/playground) – instale um tema, experimente um plugin, crie algumas páginas, exporte o que você construiu +- [wp-now](https://www.npmjs.com/package/%40wp-now/wp-now) – uma ferramenta CLI para ambientes de desenvolvimento WordPress instantâneos +- [WordPress Playground para VS Code](https://marketplace.visualstudio.com/items?itemName=WordPressPlayground.wordpress-playground) +- Traduções ao vivo: [Aplicação](https://translate.wordpress.org/projects/wp-plugins/friends/dev/pl/default/playground/), [anúncio](https://make.wordpress.org/polyglots/2023/04/19/wp-translation-playground/), [mais detalhes](https://make.wordpress.org/polyglots/2023/05/08/translate-live-updates-to-the-translation-playground/) +- [Bloco de código interativo](https://wordpress.org/plugins/interactive-code-block/) que alimenta o [tutorial do Processador de Tags HTML](https://adamadam.blog/2023/02/16/how-to-modify-html-in-a-php-wordpress-plugin-using-the-new-tag-processor-api/) e o [tutorial da API JS do Playground](https://adamadam.blog/2023/04/12/interactive-intro-to-wordpress-playground-public-api/) +- [Visualizador de Pull Requests do Gutenberg](https://playground.wordpress.net/gutenberg.html) +- [Demonstração ao vivo do plugin de notificações](https://johnhooks.io/playground-experiment/) +- [REPL do GraphQL](https://www.wpgraphql.com/2023/06/15/announcing-the-wpgraphql-repl) +- [Blocknotes](https://twitter.com/adamzielin/status/1669478239771799552) – o primeiro aplicativo para iOS a rodar WordPress no seu celular +- [Incorporador do Playground](https://joost.blog/embedded-playground/) para incorporar exemplos do Playground na documentação do WordPress.org usando shortcodes +- [Demonstrações de plugins no wp.org](https://gist.github.com/adamziel/0fe3ffc1fb5202a907a87d055ee37135) – um script de usuário que adiciona uma aba "demo" às páginas de plugins no WordPress.org +- [Visualizador de Pull Requests do WordPress](https://playground.wordpress.net/wordpress.html) +- [Sincronização entre dois Playgrounds](https://playground.wordpress.net/demos/sync.html) +- [Viagem no Tempo](https://playground.wordpress.net/demos/time-traveling.html) +- [WP-CLI](https://playground.wordpress.net/demos/wp-cli.html) +- [Implementação de Blueprints em PHP](https://playground.wordpress.net/demos/php-blueprints.html) + + + +## Materiais de leitura + + + +- [Crie experiências WordPress no navegador com WordPress Playground e WebAssembly](https://web.dev/wordpress-playground/) +- [WordPress Playground em developer.wordpress.org](https://developer.wordpress.org/playground) +- [Demonstrações técnicas de WordPress no navegador: Desenvolvimento WordPress com WordPress Playground](https://make.wordpress.org/core/2023/04/13/in-browser-wordpress-tech-demos-wordpress-development-with-wordpress-playground/) +- [Anúncio inicial em make.wordpress.org](https://make.wordpress.org/core/2022/09/23/client-side-webassembly-wordpress-with-no-server/) +- [Discussão no Hackernews](https://news.ycombinator.com/item?id=32960560) + + + +## Vídeos + + + +- Vídeos do Developer Hours: [Região das Américas (23 de maio de 2023)](https://wordpress.tv/2023/05/23/developer-hours-wordpress-playground-americas/), [Região APAC/EMEA (24 de maio de 2023)](https://wordpress.tv/2023/05/24/developer-hours-wordpress-playground-apac-emea/) +- [Playground no State of the Word (em inglês)](https://youtu.be/VeigCZuxnfY?t=2912) +- [Playground no WCEU 2023 (em inglês)](https://www.youtube.com/watch?v=e-CwouzTGp4&t=26946s) +- [Playground no WordCamp Gliwice (em polonês)](https://www.youtube.com/watch?v=AUHklF9GdL8&list=PLiCne9CeL82_hGuJOAJlsc84WxVDSH-c9&index=4) +- [Assista "WordPress Playground: a ferramenta definitiva de aprendizado, teste e ensino para WordPress"](https://www.youtube.com/watch?v=dN_LaenY8bI) por Anne McCarthy +- [WordPress Playground para desenvolvedores (em inglês)](https://wordpress.tv/2024/12/16/wordpress-playground-for-developers/) +- [Create a demo with Playground no WC Asia (em inglês)](https://wordpress.tv/2025/04/30/create-a-demo-with-playground/) por Birgit Pauli-Haack From 510391ff5e82449c1a98c1d315debc0a0be698e6 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Thu, 10 Jul 2025 13:08:13 +0100 Subject: [PATCH 2/9] Adding Webinstance page in Portuguese --- .../current/main/web-instance.md | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md new file mode 100644 index 0000000000..c1bceb4c5b --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md @@ -0,0 +1,65 @@ +--- +title: Playground web instance +slug: /web-instance +--- + +# WordPress Playground web instance + +[https://playground.wordpress.net/](https://playground.wordpress.net/) is a versatile web tool that allows developers to run WordPress in a browser without needing a server. This environment is particularly useful for testing plugins, themes, and other WordPress features quickly and efficiently. + +Some key features: + +- **Browser-based**: No need for a local server setup. +- **Instant Setup**: Run WordPress with a single click. +- **Testing Environment**: Ideal for testing plugins and themes. + +Via [Query Params](/developers/apis/query-api/) we can directly load in the Playground instance things such as a specific version of WordPress, a theme, a plugin or a more complex setup via blueprints (check [here](/quick-start-guide#try-a-block-a-theme-or-a-plugin) some examples). + +From the Playground website there are also available some toolbars to customize your playground instance and to provide quick access to some resources and utilities. + +![Playground Toolbar Snapshot](./_assets/toolbar.png) + +## Customize Playground + +![snapshot of customize playground window at playground instance](./_assets/customize-playground.png) + +The options available from the "Customize Playground" window correpond to the following [Query API options](/developers/apis/query-api#available-options): + +- `php` +- `php-extension-bundle` +- `networking` +- `wp` + +:::tip + +You need to activate "Network access" to be able to browse for [plugins](https://w.org/plugins) and [themes](https://w.org/themes) from your WordPress instance. +::: + +## Playground Options Menu + +![options menu at playground instance snapshot](./_assets/options.png) + +This menu contains links to some Playground resources and tools: + +- **Reset Site**: - It will wipe out all data and reload the page with a new site. +- **Report error**: If you have any issue with WP Playground you can report it using the form available from this option. You can help resolve issues with Playground by sharing the error details with development team behind Playground. +- **Download as zip**: It creates a `.zip` with the setup of the Playground instance including any themes or plugins installed. This `.zip` won't include content and database changes. +- **Restore from zip**: It allows you to recreate a Playground instance using any `.zip` generated with the "Download as zip" option +- **Import from Github**: This option allows you to import plugins, themes, and wp-content directories directly from your public GitHub repositories. To enable this feature, connect your GitHub account with WordPress Playground. + +- **Export Pull Request to GitHub**: This option allows you to export WordPress plugins, themes, and entire wp-content directories as pull requests to any public GitHub repository. Check [here](https://www.youtube.com/watch?v=gKrij8V3nK0&t=2488s) a demo of using this option. + +- **View Logs**: This option will take you to modal that will show any error logs for Playground, WordPress and PHP. + +- **Edit the blueprint**: This option will open the current blueprint used for the Playground instance in the [Blueprints Builder tool](https://playground.wordpress.net/builder/builder.html). From this tool you'll be able to edit the blueprint online and run a new Playground instance with your edited version of the blueprint. + + + +[![snapshot of Builder mode of WordPress Playground](./_assets/builder-mode.png)](https://playground.wordpress.net/builder/builder.html) + +:::caution + +The site at https://playground.wordpress.net is there to support the community, but there are no guarantees it will continue to work if the traffic grows significantly. + +If you need certain availability, you should [host your own WordPress Playground](/developers/architecture/host-your-own-playground). +::: From c90fd34e390813b5b192d1809e277534d00b8534 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Fri, 11 Jul 2025 11:33:33 +0100 Subject: [PATCH 3/9] updating resource pages --- .../current/main/resources.md | 50 ++++++++++++++++--- 1 file changed, 43 insertions(+), 7 deletions(-) diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md index 5e40eb5cd1..167a8d0a1b 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/resources.md @@ -126,17 +126,53 @@ Existe um conjunto de redirecionamentos para facilitar o acesso a algumas das fe ## Vídeos -- Vídeos do Developer Hours: [Região das Américas (23 de maio de 2023)](https://wordpress.tv/2023/05/23/developer-hours-wordpress-playground-americas/), [Região APAC/EMEA (24 de maio de 2023)](https://wordpress.tv/2023/05/24/developer-hours-wordpress-playground-apac-emea/) +- Vídeos do Developer Hours: + - [Região das Américas, 23 de maio de 2023 (em inglês)](https://wordpress.tv/2023/05/23/developer-hours-wordpress-playground-americas/) + - [Região APAC/EMEA, 24 de maio de 2023 (em inglês)](https://wordpress.tv/2023/05/24/developer-hours-wordpress-playground-apac-emea/) + - [Criando Blueprints do WordPress Playground para Testes e Demos, 28 de maio de 2024 (em inglês)](https://wordpress.tv/2024/05/28/developer-hours-creating-wordpress-playground-blueprints-for-testing-and-demos/) por Birgit Pauli-Haack & Nick Diego + - [Developer Hours: Tudo que você precisa saber sobre o WordPress Playground, 17 de dezembro de 2024 (em inglês)](https://wordpress.tv/2024/12/17/developer-hours-everything-you-need-to-know-about-wordpress-playground/) por Nick Diego & Ryan Welcher - [Playground no State of the Word (em inglês)](https://youtu.be/VeigCZuxnfY?t=2912) - [Playground no WCEU 2023 (em inglês)](https://www.youtube.com/watch?v=e-CwouzTGp4&t=26946s) -- [Playground no WordCamp Gliwice (em polonês)](https://www.youtube.com/watch?v=AUHklF9GdL8&list=PLiCne9CeL82_hGuJOAJlsc84WxVDSH-c9&index=4) -- [Assista "WordPress Playground: a ferramenta definitiva de aprendizado, teste e ensino para WordPress"](https://www.youtube.com/watch?v=dN_LaenY8bI) por Anne McCarthy -- [WordPress Playground para desenvolvedores (em inglês)](https://wordpress.tv/2024/12/16/wordpress-playground-for-developers/) -- [Create a demo with Playground no WC Asia (em inglês)](https://wordpress.tv/2025/04/30/create-a-demo-with-playground/) por Birgit Pauli-Haack +- [Assista "WordPress Playground: a ferramenta definitiva de aprendizado, teste e ensino para WordPress" (em inglês)](https://www.youtube.com/watch?v=dN_LaenY8bI) por Anne McCarthy +- [WordPress Playground para desenvolvedores (em inglês)](https://wordpress.tv/2024/12/16/wordpress-playground-for-developers/) por Berislav Grgicak e Jonathan Bossenger +- [WordPress Playground Block code editor theme support (em inglês)](https://wordpress.tv/2024/10/05/wordpress-playground-block-code-editor-theme-support/) por Jonathan Bossenger +- [WordPress Playground – use WordPress sem servidor no WCEU 2024 (em inglês)](https://wordpress.tv/2024/07/03/wordpress-playground-use-wordpress-without-a-server/) por Adam Zielinski +- [Code, Test, Repeat: Acelerando o Desenvolvimento com WordPress Playground no WordCamp Larissa 2024 (em inglês)](https://wordpress.tv/2024/12/13/code-test-repeat-accelerating-development-with-wordpress-playground/) por Uros Tasic +- [Liberando dados com WordPress Playground em uma extensão de navegador no WordCamp Netherlands 2024 (em inglês)](https://wordpress.tv/2024/12/24/liberating-data-with-wordpress-playground-in-a-browser-extension/) por Alex Kirk +- [Além do Playground: WordPress como Ferramenta e Construtor de Produtos no WCUS 2024 (em inglês)](https://wordpress.tv/2024/10/10/beyond-the-playground-wordpress-as-a-tool-and-product-builder/) por Dennis Snell +- [Crie uma demo com Playground no WC Asia 2025 (em inglês)](https://wordpress.tv/2025/04/30/create-a-demo-with-playground/) por Birgit Pauli-Haack +- [Dissecando o WordPress Playground no WordCamp Nepal 2025 (em inglês)](https://wordpress.tv/2025/04/30/dissecting-wordpress-playground/) por Sakar Upadhyaya Khatiwada +- [Construindo Testes Automatizados com WordPress Playground no WCEU 2025 (em inglês)](https://wordpress.tv/2025/06/07/building-automated-tests-with-wordpress-playground/) por Berislav Grgicak +- [Do Zero à Demo: Dominando Blueprints do WordPress Playground no WCEU 2025 (em inglês)](https://wordpress.tv/2025/06/07/from-zero-to-demo-mastering-wordpress-playground-blueprints/) por Birgit Pauli-Haack +- [Playground no WordCamp Gliwice (em polonês)](https://www.youtube.com/watch?v=AUHklF9GdL8&list=PLiCne9CeL82_hGuJOAJlsc84WxVDSH-c9&index=4) por Adam Zielinski +- [WordPress Playground no WordCamp Wrocław 2024 (em polonês)](https://wordpress.tv/2024/12/02/wordpress-playground-przelom-w-wordpressie-2/) por Adam Zielinski +- [WordPress Playground no WordCamp Gdynia 2025 (em polonês)](https://wordpress.tv/2025/04/21/wordpress-playground/) por Magdalena Paciorek +- [Descobrindo o Playground, a ferramenta de demonstração (em espanhol)](https://wordpress.tv/2024/08/09/descubriendo-playground-la-herramienta-para-hacer-demos/) por Alex Cuadra +- [WordPress Playground: Instalação completa e funcional do WordPress (em espanhol)](https://wordpress.tv/2024/02/07/wordpress-playground-instalacion-completa-y-funcional-de-wordpress/) por Fernando García Rebolledo +- [Playground: Um WordPress descartável dentro do seu navegador no WordCamp Madrid 2025 (em espanhol)](https://wordpress.tv/2025/03/09/playground-un-wordpress-de-usar-y-tirar-dentro-de-tu-navegador/) por Álvaro Gómez Velasco From 218fdf2326e8199600cda4052789323c403a1bef Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:46:21 +0100 Subject: [PATCH 4/9] adding translation to web instance page --- .../current/main/web-instance.md | 154 +++++++++++++++--- 1 file changed, 130 insertions(+), 24 deletions(-) diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md index c1bceb4c5b..12564911a9 100644 --- a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/web-instance.md @@ -3,63 +3,169 @@ title: Playground web instance slug: /web-instance --- + -![Playground Toolbar Snapshot](./_assets/toolbar.png) +# Instância web do WordPress Playground +[https://playground.wordpress.net/](https://playground.wordpress.net/) é uma ferramenta web versátil que permite aos desenvolvedores executar WordPress em um navegador sem precisar de um servidor. Este ambiente é particularmente útil para testar plugins, temas e outros recursos do WordPress de forma rápida e eficiente. + +Algumas características principais: + +- **Baseado em navegador**: Não requer configuração de servidor local. +- **Configuração instantânea**: Execute WordPress com um único clique. +- **Ambiente de teste**: Ideal para testar plugins e temas. + +A [API de Parâmetros de Consulta](/developers/apis/query-api/) permite carregar diretamente configurações específicas em uma instância do Playground. Isso inclui definir uma versão específica do WordPress, tema ou plugin. Você também pode definir configurações mais complexas usando blueprints (veja [exemplos aqui](/quick-start-guide#try-a-block-a-theme-or-a-plugin)). + +No site do Playground, algumas barras de ferramentas também estão disponíveis para personalizar sua instância do Playground e fornecer acesso rápido a alguns recursos e utilitários. + + + +![Captura da Barra de Ferramentas do Playground](@site/static/img/about/toolbar-playground.webp) + + -- `php` -- `php-extension-bundle` -- `networking` -- `wp` +## Personalizar Playground -:::tip +Na barra de ferramentas, você encontrará: -You need to activate "Network access" to be able to browse for [plugins](https://w.org/plugins) and [themes](https://w.org/themes) from your WordPress instance. -::: +- **Configurações do Playground**: Um painel para configurar sua instância atual, como versões do PHP e WordPress. +- **Gerenciador do Playground**: Este painel permite gerenciar instâncias do WordPress Playground, permitindo salvar, importar e exportá-las. + + + +### Configurações do Playground + +![captura da janela de personalizar Playground na instância do Playground](@site/static/img/about/playground-settings-panel.webp) + +As opções disponíveis no **Painel de Configurações do Playground** correspondem às seguintes [opções da API de Consulta](/developers/apis/query-api#available-options): + +- `language`: Define o idioma da instância WordPress. +- `multisite`: Habilita o suporte ao WordPress multisite. +- `networking`: Concede acesso à rede, permitindo buscas do diretório de plugins do WordPress e APIs internas do WordPress. +- `php`: Especifica a versão do PHP para a instância. +- `wp`: Define a versão do WordPress. + + + +## Gerenciador do Playground -## Playground Options Menu +![Painel de configurações do Playground permite aos usuários gerenciar múltiplas instâncias](@site/static/img/about/playground-manager-panel.webp) -![options menu at playground instance snapshot](./_assets/options.png) +Este painel permite aos usuários gerenciar instâncias do Playground. Ele exibe uma lista de Playgrounds salvos e fornece acesso às configurações do Playground atual, junto com um **Botão Salvar** para armazenar suas configurações localmente no seu navegador para recarregamento posterior. -This menu contains links to some Playground resources and tools: + + +![Botão Salvar Playground](@site/static/img/about/playground-manager-save-instance.webp) + +Uma vez que você clicar em salvar, uma instância será armazenada com um nome gerado para ser revisitada a qualquer momento. O Gerenciador do Playground também tem opções para exportar (menu Ações adicionais) e importar (menu Ações de importação) instâncias do WordPress Playground: + + + +### Menu de ações adicionais -- **View Logs**: This option will take you to modal that will show any error logs for Playground, WordPress and PHP. +![Menu de Ações Adicionais](@site/static/img/about/playground-manager-additional-actions.webp) -- **Edit the blueprint**: This option will open the current blueprint used for the Playground instance in the [Blueprints Builder tool](https://playground.wordpress.net/builder/builder.html). From this tool you'll be able to edit the blueprint online and run a new Playground instance with your edited version of the blueprint. +- **Exportar Pull Request para GitHub**: Esta opção permite exportar plugins WordPress, temas e diretórios wp-content inteiros como pull requests para qualquer repositório GitHub público. Confira [aqui](https://www.youtube.com/watch?v=gKrij8V3nK0&t=2488s) uma demonstração do uso desta opção. +- **Baixar como zip**: Cria um `.zip` com a configuração da instância do Playground, incluindo quaisquer temas ou plugins instalados. Este `.zip` não incluirá conteúdo e alterações do banco de dados. +- **Reportar erro**: Se você tiver algum problema com o WP Playground, pode reportá-lo usando o formulário disponível nesta opção. Você pode ajudar a resolver problemas com o Playground compartilhando os detalhes do erro com a equipe de desenvolvimento por trás do Playground. +- **Ver Blueprint**: Esta opção abrirá o blueprint atual usado para a instância do Playground na [ferramenta Construtor de Blueprints](https://playground.wordpress.net/builder/builder.html). A partir desta ferramenta, você poderá editar o blueprint online e executar uma nova instância do Playground com sua versão editada do blueprint. + + + + +[![captura do modo Construtor do WordPress Playground](@site/static/img/about/blueprint-builder.webp)](https://playground.wordpress.net/builder/builder.html) + + + +### Menu de ações de importação + +![Menu de Ações de Importação](@site/static/img/about/playground-manager-import-actions.webp) + +- **Importar de zip**: Permite recriar uma instância do Playground usando qualquer `.zip` gerado com a opção "Baixar como zip". +- **Visualizar um PR do Gutenberg**: Permite que testadores executem branches do repositório Gutenberg para testar pull requests instantaneamente. +- **Importar do GitHub**: Esta opção permite importar plugins, temas e diretórios wp-content diretamente dos seus repositórios GitHub públicos. Para habilitar este recurso, conecte sua conta GitHub com o WordPress Playground. + + + +:::caution + +O site em https://playground.wordpress.net está lá para apoiar a comunidade, mas não há garantias de que continuará funcionando se o tráfego crescer significativamente. + +Se você precisa de certa disponibilidade, deve [hospedar seu próprio WordPress Playground](/developers/architecture/host-your-own-playground). + +::: From f7505e4402a94d6992eae190664bb27ba4451299 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:47:03 +0100 Subject: [PATCH 5/9] adding translation for plugin developers page guide --- .../main/guides/for-plugin-developers.md | 433 ++++++++++++++++++ 1 file changed, 433 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-plugin-developers.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-plugin-developers.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-plugin-developers.md new file mode 100644 index 0000000000..bcd3a3aaf2 --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-plugin-developers.md @@ -0,0 +1,433 @@ +--- +title: Playground for Plugin Developers +slug: /guides/for-plugin-developers +description: WordPress Playground for Plugin Developers +--- + + + +O WordPress Playground é uma ferramenta inovadora que permite aos desenvolvedores de plugins construir, testar e exibir seus plugins diretamente em um ambiente de navegador. + +Este guia mostrará como usar o WordPress Playground para melhorar seu fluxo de trabalho de desenvolvimento de plugins, criar demonstrações ao vivo para exibir seu plugin e simplificar seus testes e revisão de plugins. + + + +:::info + +Descubra como [Construir](/about/build), [Testar](/about/test) e [Lançar](/about/launch) seus produtos com o WordPress Playground na seção [Sobre o Playground](/about). + +::: + + + +## Iniciando uma instância do Playground com um plugin + + + +### Plugin no diretório de temas do WordPress + + + +Com o WordPress Playground, você pode iniciar rapidamente uma instalação do WordPress com quase qualquer plugin disponível no [Diretório de Plugins do WordPress](https://wordpress.org/plugins/) instalado e ativado. Tudo que você precisa fazer é adicionar o [parâmetro de consulta](/developers/apis/query-api) `plugin` à [URL do Playground](https://playground.wordpress.net) e usar o slug do plugin do diretório WordPress como valor. Por exemplo: https://playground.wordpress.net/?plugin=create-block-theme + + + +:::tip +Você pode instalar e ativar vários plugins via parâmetros de consulta repetindo o parâmetro `plugin` para cada plugin que deseja ser instalado e ativado na instância do Playground. Por exemplo: https://playground.wordpress.net/?plugin=gutenberg&plugin=akismet&plugin=wordpress-seo. +::: + + + +Você também pode carregar qualquer plugin do diretório de plugins do WordPress definindo o passo [`installPlugin`](/blueprints/steps#InstallPluginStep) de um [Blueprint](/blueprints/getting-started) passado para a instância do Playground. + +```json +{ + "landingPage": "/wp-admin/plugins.php", + "login": true, + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "wordpress.org/plugins", + "slug": "gutenberg" + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/plugins.php%22,%22login%22:true,%22steps%22:[{%22step%22:%22installPlugin%22,%22pluginData%22:{%22resource%22:%22wordpress.org/plugins%22,%22slug%22:%22gutenberg%22}}]}) + + + +Os Blueprints podem ser passados para uma instância do Playground [de várias maneiras](/blueprints/using-blueprints). + + + +### Plugin em um repositório GitHub + + + +Um plugin armazenado em um repositório GitHub também pode ser carregado em uma instância do Playground via Blueprints. + + + +Com a propriedade `pluginData` do [passo blueprint `installPlugin`](/blueprints/steps#installPlugin), você pode definir um [recurso `url`](/blueprints/steps/resources#urlreference) que aponta para a localização do arquivo `.zip` contendo o plugin que você deseja carregar na instância do Playground. + + + +Para evitar problemas de CORS, o projeto Playground fornece um [proxy GitHub](https://github-proxy.com/) que permite gerar um `.zip` de um repositório (ou mesmo uma pasta dentro de um repo) contendo seu plugin. + + + +:::info +O [proxy GitHub](https://github-proxy.com/) é uma ferramenta incrivelmente útil para carregar plugins de repositórios GitHub, pois permite carregar um plugin de uma branch específica, um diretório específico, um commit específico ou um PR específico. +::: + + + +Por exemplo, o seguinte `blueprint.json` instala um plugin de um repositório GitHub aproveitando a ferramenta https://github-proxy.com: + +```json +{ + "landingPage": "/wp-admin/admin.php?page=add-media-from-third-party-service", + "login": true, + "steps": [ + { + "step": "installPlugin", + "pluginData": { + "resource": "url", + "url": "https://github-proxy.com/proxy/?repo=wptrainingteam/devblog-dataviews-plugin" + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/admin.php?page=add-media-from-third-party-service%22,%22login%22:true,%22steps%22:[{%22step%22:%22installPlugin%22,%22pluginData%22:{%22resource%22:%22url%22,%22url%22:%22https://github-proxy.com/proxy/?repo=wptrainingteam/devblog-dataviews-plugin%22}}]}) + + + +### Plugin de código em um arquivo ou gist no GitHub + + + +Combinando os passos [`writeFile`](/blueprints/steps#WriteFileStep) e [`activatePlugin`](/blueprints/steps#activatePlugin), você também pode iniciar uma instância do WP Playground com um plugin construído dinamicamente a partir de código armazenado em um gist ou [um arquivo no GitHub](https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/custom-post/books.php): + +```json +{ + "landingPage": "/wp-admin/plugins.php", + "login": true, + "steps": [ + { + "step": "login" + }, + { + "step": "writeFile", + "path": "/wordpress/wp-content/plugins/cpt-books.php", + "data": { + "resource": "url", + "url": "https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/custom-post/books.php" + } + }, + { + "step": "activatePlugin", + "pluginPath": "cpt-books.php" + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/plugins.php%22,%22login%22:true,%22steps%22:[{%22step%22:%22login%22},{%22step%22:%22writeFile%22,%22path%22:%22/wordpress/wp-content/plugins/cpt-books.php%22,%22data%22:{%22resource%22:%22url%22,%22url%22:%22https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/custom-post/books.php%22}},{%22step%22:%22activatePlugin%22,%22pluginPath%22:%22cpt-books.php%22}]}) + + + +:::info + +O exemplo [Instalar plugin de um gist](https://playground.wordpress.net/builder/builder.html?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-plugin-from-gist/blueprint.json#{%22meta%22:{%22title%22:%22Install%20plugin%20from%20a%20gist%22,%22author%22:%22zieladam%22,%22description%22:%22Install%20and%20activate%20a%20WordPress%20plugin%20from%20a%20.php%20file%20stored%20in%20a%20gist.%22,%22categories%22:[%22plugins%22]},%22landingPage%22:%22/wp-admin/plugins.php%22,%22preferredVersions%22:{%22wp%22:%22beta%22,%22php%22:%228.0%22},%22steps%22:[{%22step%22:%22login%22},{%22step%22:%22writeFile%22,%22path%22:%22/wordpress/wp-content/plugins/0-plugin.php%22,%22data%22:{%22resource%22:%22url%22,%22url%22:%22https://gist.githubusercontent.com/ndiego/456b74b243d86c97cda89264c68cbdee/raw/ff00cf25e6eebe4f5a4eaecff10286f71e65340b/block-hooks-demo.php%22}},{%22step%22:%22activatePlugin%22,%22pluginName%22:%22Block%20Hooks%20Demo%22,%22pluginPath%22:%220-plugin.php%22}]}) na [Galeria de Blueprints](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md) mostra como carregar um plugin de código em um gist + +::: + + + +## Configurando uma demonstração para seu plugin com Blueprints + + + +Ao fornecer um link para uma instância do WordPress Playground com alguns plugins ativados, você também pode querer personalizar a configuração inicial para essa instância do Playground usando esses plugins. Com os [Blueprints](/blueprints/getting-started) do Playground, você pode carregar/ativar plugins e configurar a instância do Playground. + + + +:::tip + +Algumas ferramentas e recursos úteis fornecidos pelo projeto Playground para trabalhar com blueprints são: + +- Verifique a [Galeria de Blueprints](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md) para explorar exemplos de código reais de uso do WordPress Playground para iniciar um site WordPress com várias configurações. +- A ferramenta [Biblioteca de Passos do WordPress Playground](https://akirk.github.io/playground-step-library/#) fornece uma interface visual para arrastar ou clicar nos passos para criar um blueprint para o WordPress Playground. Você também pode criar seus próprios passos! +- A ferramenta [Construtor de Blueprints](https://playground.wordpress.net/builder/builder.html) permite editar seu blueprint online e executá-lo diretamente em uma instância do Playground. + +::: + + + +Através de propriedades e [`steps`](/blueprints/steps) no Blueprint, você pode configurar a configuração inicial da instância do Playground, fornecendo aos seus plugins o conteúdo e a configuração necessários para exibir os recursos e funcionalidades convincentes do seu plugin. + + + +:::info + +Uma ótima demonstração com o WordPress Playground pode exigir que você carregue conteúdo padrão para seu plugin e tema, incluindo imagens e outros recursos. Confira o guia [Fornecendo conteúdo para sua demonstração](/guides/providing-content-for-your-demo) para saber mais sobre isso. + +::: + +### `plugins` + + + +Se seu plugin tem dependências de outros plugins, você pode usar a abreviação `plugins` para instalar o seu junto com quaisquer outros plugins necessários. + + + +```json +{ + "landingPage": "/wp-admin/plugins.php", + "plugins": ["gutenberg", "sql-buddy", "create-block-theme"], + "login": true +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/plugins.php%22,%22plugins%22:[%22gutenberg%22,%22sql-buddy%22,%22create-block-theme%22],%22login%22:true}) + +### `landingPage` + + + +Se seu plugin tem uma visualização de configurações ou assistente de integração, você pode usar a abreviação `landingPage` para redirecionar automaticamente para qualquer página na instância do Playground ao carregar. + +```json +{ + "landingPage": "/wp-admin/admin.php?page=my-custom-gutenberg-app", + "login": true, + "plugins": ["https://raw.githubusercontent.com/WordPress/block-development-examples/deploy/zips/data-basics-59c8f8.zip"] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/admin.php?page=my-custom-gutenberg-app%22,%22login%22:true,%22plugins%22:[%22https://raw.githubusercontent.com/WordPress/block-development-examples/deploy/zips/data-basics-59c8f8.zip%22]}) + +### `writeFile` + + + +Com o [passo `writeFile`](/blueprints/steps#writeFile), você pode criar qualquer arquivo de plugin dinamicamente, referenciando código de um arquivo \*.php armazenado no GitHub ou Gist. + + + +Aqui está um exemplo de um **[plugin que gera Custom Post Types](https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/custom-post/books.php)**, colocado na pasta `mu-plugins` para garantir que o código seja executado automaticamente ao carregar: + +```json +{ + "landingPage": "/wp-admin/", + "login": true, + "steps": [ + { + "step": "writeFile", + "path": "/wordpress/wp-content/mu-plugins/books.php", + "data": { + "resource": "url", + "url": "https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/custom-post/books.php" + } + } + ] +} +``` + + + +## Desenvolvimento de Plugins + + + +### Desenvolvimento e teste local de plugins com o Playground + + + +A partir de uma pasta de plugins em seu ambiente de desenvolvimento local, você pode carregar rapidamente uma instância do Playground localmente com esse plugin carregado e ativado. + + + +Use o comando [`@wp-playground/cli`](/developers/local-development/wp-playground-cli) do diretório raiz do seu plugin usando seu programa de linha de comando preferido. + + + +Com o IDE [Visual Studio Code](https://code.visualstudio.com/), você também pode usar a [extensão do Visual Studio Code](/developers/local-development/vscode-extension) enquanto trabalha no diretório raiz do seu plugin. + + + +Por exemplo: + +```bash +git clone git@github.com:wptrainingteam/devblog-dataviews-plugin.git +cd devblog-dataviews-plugin +npx @wp-playground/cli server --auto-mount +``` + + + +### Veja suas alterações locais em uma instância do Playground e crie PRs diretamente em um repo GitHub com suas alterações + + + +Com o Google Chrome, você pode sincronizar uma instância do Playground com o código do seu plugin local e o repo GitHub do seu plugin. Com essa conexão, você pode: + + + +- Ver ao vivo (na instância do Playground) suas alterações locais +- Criar PRs no repo GitHub com suas alterações + + + +Aqui está uma pequena demonstração deste fluxo de trabalho em ação: + + +

+ + + +:::info + +Confira [Sobre o Playground > Construir > Sincronizar sua instância do playground com uma pasta local e criar Pull Requests do Github](/about/build#synchronize-your-playground-instance-with-a-local-folder-and-create-github-pull-requests) para mais informações. + +::: From d7a2ad20176acd655cca5e42219cf4d526e17cd8 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:47:23 +0100 Subject: [PATCH 6/9] adding translation for theme developers guide --- .../main/guides/for-theme-developers.md | 482 ++++++++++++++++++ 1 file changed, 482 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-theme-developers.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-theme-developers.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-theme-developers.md new file mode 100644 index 0000000000..2d1571fa3f --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/for-theme-developers.md @@ -0,0 +1,482 @@ +--- +title: Playground for Theme Developers +slug: /guides/for-theme-developers +description: WordPress Playground for Theme Developers +--- + + + +O WordPress Playground é uma ferramenta inovadora que permite aos desenvolvedores de temas construir, testar e exibir seus temas diretamente em um ambiente de navegador. + +Este guia mostrará como usar o WordPress Playground para melhorar seu fluxo de trabalho de desenvolvimento de temas, criar demonstrações ao vivo para exibir seu tema e simplificar o processo de revisão de temas. + + + +:::info + +Descubra como [Construir](/about/build), [Testar](/about/test) e [Lançar](/about/launch) seus produtos com o WordPress Playground na seção [Sobre o Playground](/about) + +::: + + + +## Iniciando uma instância do Playground com um tema + + + +### Temas no diretório de temas do WordPress + + + +Com o WordPress Playground, você pode iniciar rapidamente uma instalação do WordPress usando qualquer tema disponível no [Diretório de Temas do WordPress](https://wordpress.org/themes/). Simplesmente passe o [parâmetro de consulta](/developers/apis/query-api) `theme` para a [URL do Playground](https://playground.wordpress.net) assim: https://playground.wordpress.net/?theme=disco. + + + +Você também pode carregar qualquer tema do diretório de temas do WordPress definindo o passo [`installTheme`](/blueprints/steps#InstallThemeStep) de um [Blueprint](/blueprints/getting-started) passado para a instância do Playground. + +```json +{ + "steps": [ + { + "step": "installTheme", + "themeData": { + "resource": "wordpress.org/themes", + "slug": "twentytwenty" + }, + "options": { + "activate": true, + "importStarterContent": true + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22steps%22:[{%22step%22:%22installTheme%22,%22themeData%22:{%22resource%22:%22wordpress.org/themes%22,%22slug%22:%22twentytwenty%22},%22options%22:{%22activate%22:true,%22importStarterContent%22:true}}]}) + + + +### Temas em um repositório GitHub + + + +Um tema armazenado em um repositório GitHub também pode ser carregado em uma instância do Playground com Blueprints. + + + +Na propriedade `themeData` do [passo blueprint `installTheme`](/blueprints/steps#InstallThemeStep), você pode definir um [recurso `url`](/blueprints/steps/resources#urlreference) que aponta para a localização do arquivo `.zip` contendo o tema que você deseja carregar na instância do Playground. + + + +Para evitar problemas de CORS, o projeto Playground fornece um [proxy GitHub](https://github-proxy.com/) que permite gerar um `.zip` de um repositório (ou mesmo uma pasta dentro de um repo) contendo seu tema. + + + +:::tip +O [proxy GitHub](https://github-proxy.com/) é uma ferramenta incrivelmente útil para carregar temas de repositórios GitHub, pois permite carregar um tema de uma branch específica, um diretório específico, um commit específico ou um PR específico. +::: + + + +Por exemplo, o seguinte `blueprint.json` instala um tema de um repositório GitHub aproveitando a ferramenta https://github-proxy.com: + +```json +{ + "steps": [ + { + "step": "installTheme", + "themeData": { + "resource": "url", + "url": "https://github-proxy.com/proxy/?repo=Automattic/themes&branch=trunk&directory=assembler" + }, + "options": { + "activate": true + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22steps%22:[{%22step%22:%22installTheme%22,%22themeData%22:{%22resource%22:%22url%22,%22url%22:%22https://github-proxy.com/proxy/?repo=Automattic/themes&branch=trunk&directory=assembler%22},%22options%22:{%22activate%22:true}}]}) + + + +Um blueprint pode ser passado para uma instância do Playground [de várias maneiras](/blueprints/using-blueprints). + + + +## Configurando um tema de demonstração com Blueprints + + + +Ao fornecer um link para uma instância do WordPress Playground com um tema específico ativado, você também pode querer personalizar a configuração inicial para esse tema. Com os [Blueprints](/blueprints/getting-started) do Playground, você pode carregar, ativar e configurar um tema. + + + +:::tip + +Algumas ferramentas e recursos úteis fornecidos pelo projeto Playground para trabalhar com blueprints são: + +- Verifique a [Galeria de Blueprints](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md) para explorar exemplos de código reais de uso do WordPress Playground para iniciar um site WordPress com várias configurações. +- A ferramenta [Biblioteca de Passos do WordPress Playground](https://akirk.github.io/playground-step-library/#) fornece uma interface visual para arrastar ou clicar nos passos para criar um blueprint para o WordPress Playground. Você também pode criar seus próprios passos! +- A ferramenta [Construtor de Blueprints](https://playground.wordpress.net/builder/builder.html) permite editar seu blueprint online e executá-lo diretamente em uma instância do Playground. + +::: + + + +Através de propriedades e [`steps`](/blueprints/steps) no blueprint, você pode configurar a configuração inicial do seu tema na instância do Playground. + + + +:::info + +Para fornecer uma boa demonstração do seu tema via Playground, você pode querer carregá-lo com conteúdo padrão que destaque os recursos do seu tema. Confira o guia [Fornecendo conteúdo para sua demonstração](/guides/providing-content-for-your-demo) para saber mais sobre isso. + +::: + + + +### `resetData` + + + +Com o passo [`resetData`](/blueprints/steps#resetData), você pode remover o conteúdo padrão de uma instalação do WordPress para importar seu próprio conteúdo. + +```json +"steps": [ + ..., + { + "step": "resetData" + }, + ... +] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L16) + + + +### `writeFile` + + + +Com o passo [`writeFile`](/blueprints/steps#resetData), você pode escrever dados em um arquivo em um caminho especificado. Você pode querer usar este passo para escrever código PHP personalizado em um arquivo PHP dentro da pasta `mu-plugins` da instância WordPress do Playground, para que o código seja executado automaticamente quando a instância WordPress for carregada. +Uma das coisas que você pode fazer através deste passo é habilitar permalinks bonitos para sua instância do Playground: + +```json +"steps": [ + ..., + { + "step": "writeFile", + "path": "/wordpress/wp-content/mu-plugins/rewrite.php", + "data": "set_permalink_structure('/%postname%/'); $wp_rewrite->flush_rules(); } );" + }, + ... +] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L19) + + + +### `updateUserMeta` + + + +Com o passo [`updateUserMeta`](/blueprints/steps#updateUserMeta), você pode atualizar qualquer metadado de usuário. Por exemplo, você pode atualizar os metadados do usuário `admin` padrão de qualquer instalação do WordPress: + +```json +"steps": [ + ..., + { + "step": "updateUserMeta", + "meta": { + "first_name": "John", + "last_name": "Doe", + "admin_color": "modern" + }, + "userId": 1 + }, + ... +] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L24) + + + +### `setSiteOptions` + + + +Com o passo [`setSiteOptions`](/blueprints/steps#setSiteOptions), você pode definir [opções do site](https://developer.wordpress.org/apis/options/#available-options-by-category) como o nome do site, descrição ou página para usar para posts. + +```json +"steps": [ + ..., + { + "step": "setSiteOptions", + "options": { + "blogname": "Rich Tabor", + "blogdescription": "Multidisciplinary maker specializing in the intersection of product, design and engineering. Making WordPress.", + "show_on_front": "page", + "page_on_front": 6, + "page_for_posts": 2 + } + }, + ... +] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L50) + + + +Há também uma abreviação [`siteOptions`](/blueprints/steps/shorthands#siteoptions) que pode ser usada em vez do passo `setSiteOptions`. + + + +### `plugins` + + + +Com a abreviação [`plugins`](/blueprints/steps/shorthands#plugins), você pode definir uma lista de plugins que deseja que sejam instalados e ativados com seu tema na instância do Playground. + + + +```json +"plugins": ["todo-list-block", "markdown-comment-block"] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L60) + + + +Você também pode usar o passo [`installPlugin`](/blueprints/steps#installPlugin) para instalar e ativar plugins para sua instância do Playground, mas a forma abreviada é recomendada. + + + +### `login` + + + +Com a abreviação [`login`](/blueprints/steps/shorthands#login), você pode iniciar sua instância do Playground com o usuário admin logado. + + + +```json + "login": true, +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L10) + + + +Você também pode usar o passo [`login`](/blueprints/steps#login) para iniciar sua instância do Playground logado com qualquer usuário específico. + + + +:::tip + +Os exemplos ["Stylish Press"](https://github.com/WordPress/blueprints/tree/trunk/blueprints/stylish-press) e ["Carregando, ativando e configurando um tema de um repositório GitHub"](https://github.com/WordPress/blueprints/tree/trunk/blueprints/install-activate-setup-theme-from-gh-repo) da [Galeria de Blueprints](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md) são ótimas referências para carregar, ativar, importar conteúdo e configurar um tema de blocos em uma instância do Playground. + +::: + + + +## Desenvolvimento de temas + + + +### Desenvolvimento e teste local de temas com o Playground + + + +A partir da pasta raiz do código de um tema de blocos, você pode carregar rapidamente uma instância do Playground localmente com esse tema carregado e ativado. Você pode fazer isso iniciando, em um diretório de tema, o comando [`@wp-playground/cli`](/developers/local-development/wp-playground-cli) do seu programa de linha de comando preferido ou a [extensão do Visual Studio Code](/developers/local-development/vscode-extension) do IDE [Visual Studio Code](https://code.visualstudio.com/). + + + +Por exemplo: + +``` +git clone git@github.com:WordPress/community-themes.git +cd community-themes/blue-note +npx @wp-playground/cli server --auto-mount +``` + + + +### Projete seu tema usando a interface do WordPress e salve suas alterações como Pull Requests + + + +Você pode conectar sua instância do Playground a um repositório GitHub e criar um Pull Request com as alterações que você fez através da interface do WordPress na instância do Playground, aproveitando o plugin [Create Block Theme](https://wordpress.org/plugins/create-block-theme/). Você também pode fazer alterações nesse tema e exportar um zip. + + + +Observe que você precisará do plugin [Create Block Theme](https://wordpress.org/plugins/create-block-theme/) instalado e ativado na instância do Playground para usar este fluxo de trabalho. + + + +

+ + + +:::tip + +Confira [Sobre o Playground > Construir > Salvar alterações feitas em um Tema de Blocos e criar Pull Requests do GitHub](/about/build#save-changes-done-on-a-block-theme-and-create-github-pull-requests) para mais informações. + +::: From e8ca8e58593790eac1701e5a0078db5989545822 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:47:47 +0100 Subject: [PATCH 7/9] adding translation for guides home page --- .../current/main/guides/index.md | 56 +++++++++++++++++++ 1 file changed, 56 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/index.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/index.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/index.md new file mode 100644 index 0000000000..65ce5a4af6 --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/index.md @@ -0,0 +1,56 @@ +--- +title: 📖 Guides +slug: /guides +description: WordPress Playground Guides +sidebar_class_name: navbar-build-item +--- + + + +# Guias + +Nesta seção apresentamos uma seleção de guias que ajudarão você a trabalhar com e a entender melhor uma variedade de tópicos relacionados ao WordPress Playground. + + + +## [Como enviar um site WordPress real em um aplicativo iOS nativo via Playground?](/guides/wordpress-native-ios-app) + +Confira "Blocknotes", o primeiro aplicativo a executar WordPress nativamente no iOS via WordPress Playground. Ele mostra o potencial para integração web móvel perfeita usando WebAssembly e o editor de blocos do WordPress. + + + +## [Fornecendo conteúdo para sua demonstração com WordPress Playground](/guides/providing-content-for-your-demo) + +Para fornecer uma boa demonstração do seu tema ou plugin via Playground, você pode querer carregá-lo com conteúdo padrão que destaque os recursos do seu produto. Confira este guia para aprender como fazer isso. + + + +## [WordPress Playground para Desenvolvedores de Temas](/guides/for-theme-developers) + +Este guia mostrará as configurações essenciais para criar completamente uma demonstração de tema usando WordPress Playground e como você pode aproveitá-lo durante o estágio de construção. + + + +## [WordPress Playground para Desenvolvedores de Plugins](/guides/for-plugin-developers) + +Este guia mostrará as configurações básicas para exibir seu plugin usando WordPress Playground e como usá-lo enquanto desenvolve seu plugin. From 414ca50629376579342c502015df86e79de13c81 Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:48:33 +0100 Subject: [PATCH 8/9] Adding translation for the guide providing content page --- .../guides/providing-content-for-your-demo.md | 288 ++++++++++++++++++ 1 file changed, 288 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md new file mode 100644 index 0000000000..e01e06f21b --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/providing-content-for-your-demo.md @@ -0,0 +1,288 @@ +--- +title: Providing content for your demo with Playground +slug: /guides/providing-content-for-your-demo +description: Providing content for your demo with WordPress Playground +--- + + + +Uma das coisas que você pode querer fazer para fornecer uma boa demonstração com o WordPress Playground é carregar conteúdo padrão para destacar melhor os recursos do seu plugin ou tema. Este conteúdo padrão pode incluir imagens ou outros recursos. + +Existem vários [passos de blueprint](/blueprints/steps) e estratégias que você pode usar para importar conteúdo (ou gerá-lo) na instância do Playground: + +## `importWxr` + + + +Com o passo [`importWxr`](/blueprints/steps#importWxr), você pode importar seu próprio conteúdo via um arquivo `.xml` previamente [exportado de uma instalação WordPress existente](https://wordpress.org/documentation/article/tools-export-screen/): + +```json +"steps": [ + ..., + { + "step": "importWxr", + "file": { + "resource": "url", + "url": "https://raw.githubusercontent.com/WordPress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint-content.xml" + } + }, + ... +] +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/?blueprint-url=https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json)   [   Ver blueprint.json   ](https://github.com/WordPress/blueprints/blob/eb6da7dfa295a095eea2e424c0ae83a219803a8d/blueprints/install-activate-setup-theme-from-gh-repo/blueprint.json#L43) + +:::info +Para incluir imagens no seu conteúdo importado, uma boa abordagem é fazer upload das imagens para seu repo GitHub e substituir o caminho delas no arquivo `.xml` exportado usando o formato de URL: `https://raw.githubusercontent.com/{repo}/{branch}/{image_path}`. + +```html + +
+ +
+ +``` + +::: + + + +É recomendado fazer upload do seu arquivo `.xml` exportado e quaisquer recursos referenciados (como imagens) para o mesmo diretório do seu `blueprint.json` no seu repositório GitHub. + +## `importWordPressFiles` + + + +Com o passo [`importWordPressFiles`](/blueprints/steps#importWordPressFiles), você pode importar seus próprios arquivos WordPress de nível superior de um arquivo `.zip` fornecido para a pasta raiz da instância. Por exemplo, se um arquivo `.zip` contém os diretórios `wp-content` e `wp-includes`, eles substituirão os diretórios correspondentes na pasta raiz do Playground. + +Este arquivo `zip` pode ser criado a partir de qualquer instância do Playground com a opção "Download as zip" no [Menu de Opções do Playground](/web-instance#playground-options-menu). + +Você pode preparar uma demonstração para seu tema ou plugin WordPress (incluindo imagens e outros recursos) em uma instância do Playground e depois exportar um snapshot dessa demonstração para um arquivo `.zip`. Este arquivo pode ser importado posteriormente usando o passo `importWordPressFiles`. + +```json +{ + "landingPage": "/", + "login": true, + "steps": [ + { + "step": "importWordPressFiles", + "wordPressFilesZip": { + "resource": "url", + "url": "https://raw.githubusercontent.com/adamziel/playground-sites/main/playground-for-site-builders/playground.zip" + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/%22,%22login%22:true,%22steps%22:[{%22step%22:%22importWordPressFiles%22,%22wordPressFilesZip%22:{%22resource%22:%22url%22,%22url%22:%22https://raw.githubusercontent.com/adamziel/playground-sites/main/playground-for-site-builders/playground.zip%22}}]}) + +## `importThemeStarterContent` + + + +[Alguns temas têm conteúdo inicial](https://make.wordpress.org/core/2016/11/30/starter-content-for-themes-in-4-7/) que pode ser publicado para destacar os recursos de um tema. + +Com o passo [`importThemeStarterContent`](/blueprints/steps#importThemeStarterContent), você pode publicar o conteúdo inicial de qualquer tema, mesmo que esse tema não seja o ativado na instância do Playground. + +```json + +"steps": [ + { + "step": "installTheme", + "themeData": { + "resource": "wordpress.org/themes", + "slug": "twentytwenty" + } + }, + { + "step": "installTheme", + "themeData": { + "resource": "wordpress.org/themes", + "slug": "twentytwentyone" + }, + "options": { + "activate": true + } + }, + { + "step": "importThemeStarterContent", + "themeSlug": "twentytwenty" + } + ] + +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22steps%22:[{%22step%22:%22installTheme%22,%22themeData%22:{%22resource%22:%22wordpress.org/themes%22,%22slug%22:%22twentytwenty%22}},{%22step%22:%22installTheme%22,%22themeData%22:{%22resource%22:%22wordpress.org/themes%22,%22slug%22:%22twentytwentyone%22},%22options%22:{%22activate%22:true}},{%22step%22:%22importThemeStarterContent%22,%22themeSlug%22:%22twentytwenty%22}]}) + + + +Você também pode publicar o conteúdo inicial de um tema ao instalá-lo com o passo [`installTheme`](/blueprints/steps#installTheme) definindo como `true` sua opção `importStarterContent`: + +```json +{ + "steps": [ + { + "step": "installTheme", + "themeData": { + "resource": "wordpress.org/themes", + "slug": "twentytwenty" + }, + "options": { + "activate": true, + "importStarterContent": true + } + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22steps%22:[{%22step%22:%22installTheme%22,%22themeData%22:{%22resource%22:%22wordpress.org/themes%22,%22slug%22:%22twentytwenty%22},%22options%22:{%22activate%22:true,%22importStarterContent%22:true}}]}) + +## `wp-cli` + + + +Outra maneira de gerar conteúdo para seu tema ou plugin é através do passo `wp-cli` que permite executar [comandos WP-CLI](https://developer.wordpress.org/cli/commands/) como [`wp post generate`](https://developer.wordpress.org/cli/commands/post/generate/): + +```json +{ + "landingPage": "/wp-admin/edit.php", + "login": true, + "steps": [ + { + "step": "wp-cli", + "command": "wp post generate --count=20 --post_type=post --post_date=1999-01-04" + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22landingPage%22:%22/wp-admin/edit.php%22,%22login%22:true,%22steps%22:[{%22step%22:%22wp-cli%22,%22command%22:%22wp%20post%20generate%20--count=20%20--post_type=post%20--post_date=1999-01-04%22}]}) + + + +Você também pode usar o passo `wp-cli` em combinação com o passo `writeFile` para criar posts baseados em conteúdo existente e importar imagens para a instância do Playground: + +```json +{ + "$schema": "https://playground.wordpress.net/blueprint-schema.json", + "landingPage": "/?p=4", + "login": true, + "steps": [ + { + "step": "writeFile", + "path": "/wordpress/wp-content/postcontent.md", + "data": { + "resource": "url", + "url": "https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/postcontent.md" + } + }, + { + "step": "wp-cli", + "command": "wp post create --post_title='Welcome to Playground' --post_status='published' /wordpress/wp-content/postcontent.md" + }, + { + "step": "writeFile", + "path": "/wordpress/wp-content/Select-storage-method.png", + "data": { + "resource": "url", + "url": "https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/Select-storage-method.png" + } + }, + { + "step": "wp-cli", + "command": "wp media import wordpress/wp-content/Select-storage-method.png --post_id=4 --title='Select your storage method' --featured_image" + } + ] +} +``` + + + +[   Executar Blueprint   ](https://playground.wordpress.net/builder/builder.html#{%22$schema%22:%22https://playground.wordpress.net/blueprint-schema.json%22,%22meta%22:{%22title%22:%22Use%20wp-cli%20to%20add%20a%20post%20with%20image%22,%22description%22:%22Use%20wp-cli%20to%20create%20a%20post%20from%20text%20file%20with%20block%20markup%20and%20a%20featured%20image%22,%22author%22:%22bph%22,%22categories%22:[%22Content%22,%22wpcli%22]},%22landingPage%22:%22/?p=4%22,%22login%22:true,%22steps%22:[{%22step%22:%22writeFile%22,%22path%22:%22/wordpress/wp-content/postcontent.md%22,%22data%22:{%22resource%22:%22url%22,%22url%22:%22https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/postcontent.md%22}},{%22step%22:%22wp-cli%22,%22command%22:%22wp%20post%20create%20--post_title='Welcome%20to%20Playground'%20--post_status='published'%20/wordpress/wp-content/postcontent.md%22},{%22step%22:%22writeFile%22,%22path%22:%22/wordpress/wp-content/Select-storage-method.png%22,%22data%22:{%22resource%22:%22url%22,%22url%22:%22https://raw.githubusercontent.com/wordpress/blueprints/trunk/blueprints/wpcli-post-with-image/Select-storage-method.png%22}},{%22step%22:%22wp-cli%22,%22command%22:%22wp%20media%20import%20wordpress/wp-content/Select-storage-method.png%20--post_id=4%20--title='Select%20your%20storage%20method'%20--featured_image%22}]}) + + + +:::tip + +Confira o exemplo ["Usar wp-cli para adicionar um post com imagem"](https://github.com/WordPress/blueprints/tree/trunk/blueprints/wpcli-post-with-image) da [Galeria de Blueprints](https://github.com/WordPress/blueprints/blob/trunk/GALLERY.md) para ver o exemplo completo mostrando a conexão entre o conteúdo e a imagem destacada. + +## `runPHP` + + + +Com o [passo `runPHP`](https://wordpress.github.io/wordpress-playground/blueprints/steps#runPHP), você pode executar qualquer código PHP que precise para inserir informações na sua instalação WordPress, por exemplo, usando a [função `wp_insert_post`](https://developer.wordpress.org/reference/functions/wp_insert_post/). + +```json +{ + "landingPage": "/wp-admin/edit.php", + "login": true, + "steps": [ + { + "step": "runPHP", + "code": " 'Simple post from PHP', 'post_content' => '

This is a simple post inserted with wp_insert_post

', 'post_author' => 1, 'post_status' => 'publish')); ?>" + } + ] +} +``` + + + +[   Executar Blueprint   ]() From d9ff6cdbe416af5486b9a86337377f557b6e36aa Mon Sep 17 00:00:00 2001 From: Fellyph Cintra Date: Tue, 5 Aug 2025 11:48:58 +0100 Subject: [PATCH 9/9] Adding translation for native ios app page --- .../main/guides/wordpress-native-ios-app.md | 97 +++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/wordpress-native-ios-app.md diff --git a/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/wordpress-native-ios-app.md b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/wordpress-native-ios-app.md new file mode 100644 index 0000000000..7bb44709f4 --- /dev/null +++ b/packages/docs/site/i18n/pt-BR/docusaurus-plugin-content-docs/current/main/guides/wordpress-native-ios-app.md @@ -0,0 +1,97 @@ +--- +title: Playground in native iOS apps +slug: /guides/wordpress-native-ios-app +description: WordPress Playground in native iOS apps +--- + + + +## Como enviar um site WordPress real em um aplicativo iOS nativo via Playground? + +Blocknotes é o primeiro aplicativo iOS que executou WordPress nativamente em dispositivos iOS aproveitando o WordPress Playground. Desenvolvido por [Ella van Durpe](https://profiles.wordpress.org/ellatrix/), uma committer principal do WordPress, Blocknotes representa um salto significativo nas capacidades dos aplicativos móveis ao utilizar WebAssembly para executar WordPress sem a necessidade de um servidor PHP tradicional. + +Este estudo de caso explora os recursos, implementação técnica e implicações potenciais do Blocknotes para o futuro do desenvolvimento móvel e web. + +**Importante!** A versão atual do Blocknotes não está mais executando WordPress Playground. Desde o lançamento inicial, o aplicativo foi reescrito para usar apenas o editor de blocos do WordPress sem o resto do WordPress. Este estudo de caso cobre as versões iniciais do Blocknotes que abriram um mundo inteiro de novas possibilidades para o WordPress. + + + +## Recursos do Blocknotes + +Blocknotes permite aos usuários criar e editar notas usando o editor de blocos do WordPress. As notas são automaticamente salvas como arquivos HTML no iCloud Drive do usuário e sincronizadas perfeitamente entre dispositivos. + + + +## Implementação Técnica + +Blocknotes operava como uma WebView executando uma página HTML onde uma versão WebAssembly do PHP estava executando WordPress. Essa página HTML foi empacotada como um iOS nativo via [Capacitor](https://capacitorjs.com/). Esta configuração permitiu que o WordPress funcionasse em ambientes tradicionalmente não suportados. + +No [repositório GitHub do Blocknotes](https://github.com/blocknotes-org/blocknotes/tree/e08535883332be9a45a0c75b750c54a4e17f6748), você pode revisar o último lançamento baseado no Playground. Aqui estão as partes mais importantes: + +- [Uma build do WordPress](https://github.com/blocknotes-org/blocknotes/blob/e08535883332be9a45a0c75b750c54a4e17f6748/src/js/wp-6.2.data) (empacotada como um arquivo `.data`). +- [Recursos estáticos do WordPress](https://github.com/blocknotes-org/blocknotes/tree/e08535883332be9a45a0c75b750c54a4e17f6748/public). +- [Uma build WebAssembly do PHP](https://github.com/blocknotes-org/blocknotes/tree/e08535883332be9a45a0c75b750c54a4e17f6748/node_modules/%40php-wasm/web) (via [@php-wasm/web](https://npmjs.com/package/@php-wasm/web)). +- [Um web worker executando PHP e WordPress](https://github.com/blocknotes-org/blocknotes/blob/e08535883332be9a45a0c75b750c54a4e17f6748/src/js/worker.js). +- Plugin WordPress [Hypernotes](https://wordpress.com/plugins/hypernotes) ([instalado aqui](https://github.com/blocknotes-org/blocknotes/blob/e08535883332be9a45a0c75b750c54a4e17f6748/src/js/index.js#L160)) para transformar wp-admin em um aplicativo de anotações. +- Uma camada para [carregar posts do WordPress de arquivos iOS](https://github.com/blocknotes-org/blocknotes/blob/e08535883332be9a45a0c75b750c54a4e17f6748/src/js/index.js#L39) e [salvar alterações como arquivos iOS](https://github.com/blocknotes-org/blocknotes/blob/e08535883332be9a45a0c75b750c54a4e17f6748/src/js/save-data.js). + + + +## Construindo seu próprio aplicativo iOS com WordPress Playground + +Embora Blocknotes tenha provado que lançar um aplicativo iOS baseado em WordPress é possível, esta ainda é uma área altamente exploratória. Não há fluxos de trabalho, bibliotecas ou bases de conhecimento estabelecidas. + +A melhor documentação que temos é o repositório do Blocknotes. Use-o como referência e ponto de partida para explorar seu novo aplicativo. Revise os componentes-chave como a build WebAssembly do PHP, a integração do editor de blocos do WordPress e como os web workers são utilizados para executar WordPress eficientemente. Ao dissecar esses elementos, você pode obter insights sobre como construir seu próprio aplicativo iOS com WordPress Playground, expandindo os limites do que é possível com aplicações web móveis. + +Conforme você navega neste espaço inovador, compartilhe suas descobertas e desafios com a equipe do Playground e a comunidade WordPress mais ampla. Publicar seus aprendizados não apenas ajudará no seu desenvolvimento, mas também contribuirá para uma base de conhecimento coletiva, impulsionando o futuro do WordPress no mobile. + + + +## Potencial e o futuro + +Blocknotes abre caminho para uma nova geração de aplicações que são mais acessíveis, flexíveis e poderosas. + +Uma vez que os fluxos de trabalho de construção de aplicativos amadureçam, podemos ver pipelines automatizados para empacotar sites do Playground como aplicativos iOS. Isso tornaria extremamente fácil executar o mesmo código base no servidor, no navegador e como um aplicativo móvel. + +Trabalhando juntos e compartilhando nossas descobertas, podemos expandir os limites do que é possível com WordPress e desenvolvimento de aplicativos móveis.