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/.
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.
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.