Pular para o conteúdo principal

Contribuições de código

Como todos os projetos WordPress, o Playground usa o GitHub para gerenciar o código e rastrear problemas. O repositório principal está em https://github.com/WordPress/wordpress-playground e o repositório de Ferramentas do Playground está em https://github.com/WordPress/playground-tools/.

Contribua para as Ferramentas do Playground

Este guia inclui links para o repositório principal, mas todos os passos e opções se aplicam a ambos. Se você estiver interessado nos plugins ou nas ferramentas de desenvolvimento local, comece por aí.

Navegue pela lista de issues abertas para encontrar no que trabalhar. A etiqueta Good First Issue é um ponto de partida recomendado para contribuidores de primeira viagem.

Certifique-se de revisar os seguintes recursos antes de começar:

Contribuir com Pull Requests

Faça um fork do repositório do Playground e clone-o para sua máquina local. Para fazer isso, copie e cole estes comandos em seu terminal:

git clone -b trunk --single-branch --depth 1 --recurse-submodules

# substitua `SEU-NOME-DE-USUARIO-GITHUB` pelo seu nome de usuário do GitHub:
git@github.com:SEU-NOME-DE-USUARIO-GITHUB/wordpress-playground.git
cd wordpress-playground
npm install

Crie uma branch, faça as alterações e teste-a localmente executando o seguinte comando:

npm run dev

O Playground será aberto em uma nova aba do navegador e será atualizado automaticamente a cada alteração.

Quando estiver pronto, faça o commit das alterações e envie um Pull Request.

Formatação

Nós lidamos com a formatação de código e o linting automaticamente. Relaxe, digite e deixe as máquinas fazerem o trabalho.

Executando um Multisite local

O WordPress Multisite tem algumas restrições quando executado localmente. Se você planeja testar uma rede Multisite usando o passo enableMultisite do Playground, certifique-se de alterar a porta padrão do wp-now ou definir um domínio de teste local executado via HTTPS.

Para alterar a porta padrão do wp-now para a suportada pelo WordPress Multisite, execute-o usando a flag --port=80:

npx @wp-now/wp-now start --port=80

Existem algumas maneiras de configurar um domínio de teste local, incluindo a edição do seu arquivo hosts. Se você não tiver certeza de como fazer isso, sugerimos instalar o Laravel Valet e, em seguida, executar o seguinte comando:

valet proxy playground.test http://127.0.0.1:5400 --secure

Seu servidor de desenvolvimento agora está disponível em https://playground.test.

Depuração

Use o VS Code e o Chrome

Se você estiver usando o VS Code e tiver o Chrome instalado, poderá depurar o Playground no editor de código:

  • Abra a pasta do projeto no VS Code.
  • Selecione Executar > Iniciar Depuração no menu principal ou pressione F5/fn+F5.

Depurando o PHP

O Playground registra os erros do PHP no console do navegador após cada solicitação PHP.