Pular para o conteúdo principal

Dia do Contribuidor do WordCamp

O Dia do Contribuidor do WordCamp é um evento onde a comunidade WordPress se reúne para contribuir com o projeto WordPress. Este guia foca em como você pode contribuir com o projeto WordPress Playground ou como o Playground pode ajudá-lo a contribuir com o WordPress Core.

Quem pode contribuir?​

Alguns eventos terão uma mesa dedicada ao projeto. As mesas de contribuidores do WordPress Playground recebem todos os tipos de contribuições, não apenas de desenvolvedores. Seja você escritor, programador, testador, desenvolvedor de plugins ou temas, profissional de marketing, proprietário de site ou qualquer outro tipo de usuário, você é encorajado a contribuir.

Valorizamos contribuições diversas em várias áreas, incluindo construção de comunidade, testes, documentação e design.

Como contribuir com o projeto Playground​

Esta seção descreve como você pode contribuir diretamente com o projeto WordPress Playground e suas ferramentas associadas:

  • Documentação: Melhore nossa documentação aprimorando o conteúdo existente, desenvolvendo novos guias ou traduzindo materiais para diferentes idiomas.
  • Blueprints: Crie demonstrações de plugins para os plugins no repositório de Plugins do WordPress, ou desenvolva novos Blueprints para enriquecer nossa documentação do projeto.
  • Testes do ambiente Playground: Participe dos testes do próprio projeto WordPress Playground. Você pode fazer isso criando cuidadosamente novos issues que descrevam os problemas que você encontrou e sugerindo soluções práticas. Teste nossa instância web do WordPress (o site playground.wordpress.net), ou explore os vários aplicativos alimentados pelo Playground. Teste essas ferramentas, observe sua funcionalidade e forneça feedback detalhado.
  • Feedback do produto: Suas ideias são inestimáveis para melhorar a experiência do Playground. Isso inclui feedback geral sobre a instância web, o aplicativo e quaisquer ferramentas do lado do servidor.

Todos os feedbacks, incluindo issues reportados e resultados de testes, podem ser enviados através do nosso repositório GitHub.

Acompanhamento e engajamento contínuo​

Embora muitas tarefas sejam concluídas durante o evento, sua jornada de contribuição não precisa terminar aí. Você é bem-vindo para continuar trabalhando em seus issues ou pull requests após o Dia do Contribuidor. Antecipamos atividade contínua de contribuidores que assumem tarefas além do evento. Por favor, note que se um pull request não mostrar atividade por um mês, ele pode ser considerado abandonado e subsequentemente fechado.

Obtendo ajuda e mantendo-se engajado​

Durante o Dia do Contribuidor, você pode encontrar assistência direta e interagir conosco na mesa dedicada do Playground. Para suporte contínuo e interação com a comunidade, você pode se conectar conosco no canal #playground do WordPress Slack ou via GitHub.

Como usar o Playground no Dia do Contribuidor​

Agora vamos cobrir como o Playground pode ajudá-lo durante o Dia do Contribuidor. A extensão WordPress Playground para VS Code e @wp-playground/cli simplificam o processo de configuração de um ambiente WordPress local. O WordPress Playground alimenta ambos—sem necessidade de Docker, MySQL ou Apache.

Continue lendo para aprender como usar essas ferramentas para desenvolvimento local ao contribuir com o WordPress. Por favor, note que a extensão e o pacote NPM estão em desenvolvimento, e nem todos os times do Make WordPress são totalmente suportados.

Começando​

Extensão Playground para VS Code​

A extensão Playground para Visual Studio Code é um ambiente de desenvolvimento amigável e sem configuração.

  1. Abra o VS Code e navegue até a aba Extensões (Visualizar > Extensões).
  2. Na barra de pesquisa, digite WordPress Playground e clique em Instalar.
  3. Para interagir com o Playground, clique no novo ícone na Barra de Atividades e pressione o botão Iniciar Servidor WordPress.
  4. Uma nova aba será aberta no seu navegador em segundos.

Pacote NPM @wp-playground/cli​

@wp-playground/cli é uma ferramenta CLI que permite criar um site WordPress com um único comando. Não é necessário Docker, MySQL ou Apache.

Pré-requisitos​

@wp-playground/cli requer Node.js 20.18 ou mais recente e NPM. Se você ainda não fez isso, baixe e instale ambos antes de começar.

Dependendo do time do Make WordPress para o qual você contribui, você pode precisar de uma versão diferente do Node.js da que você tem instalada. Você pode usar o Node Version Manager (NVM) para alternar entre versões. Encontre o guia de instalação aqui.

Executando @wp-playground/cli​

Você não precisa instalar @wp-playground/cli no seu dispositivo para usá-lo. Navegue até o diretório do seu plugin ou tema e inicie @wp-playground/cli com os seguintes comandos:

cd my-plugin-or-theme-directory
npx @wp-playground/cli@latest server --auto-mount

Ideias para contribuidores​

Criar um Pull Request (PR) do Gutenberg​

  1. Faça um fork do repositório Gutenberg na sua conta GitHub.
  2. Então, clone o repositório "forkado" para baixar os arquivos.
  3. Instale as dependências necessárias e compile o código em modo de desenvolvimento.
git clone git@github.com:WordPress/gutenberg.git
cd gutenberg
npm install
npm run dev
info

Se você não tiver certeza sobre os passos listados acima, visite o Guia do Contribuidor do Projeto Gutenberg oficial. Note que neste caso, @wp-playground/cli substitui wp-env.

Abra uma nova aba do terminal, navegue até o diretório Gutenberg e inicie o WordPress usando @wp-playground/cli:

cd gutenberg
npx @wp-playground/cli@latest server --auto-mount

Quando estiver pronto, faça commit e push das suas alterações para o seu repositório "forkado" no GitHub e abra um Pull Request no repositório Gutenberg.

Testar um PR do Gutenberg​

  1. Para testar outros PRs do Gutenberg, faça checkout para a branch associada a ele.
  2. Faça pull das últimas alterações para garantir que sua cópia local esteja atualizada.
  3. Em seguida, instale as dependências necessárias, garantindo que seu ambiente de teste corresponda às últimas alterações.
  4. Finalmente, compile o código em modo de desenvolvimento.
# copy the branch-name from GitHub #
git checkout branch-name
git pull
npm install
npm run dev

# In a different terminal inside the Gutenberg directory *
npx @wp-playground/cli@latest server --auto-mount

Testar um PR do Gutenberg com Playground no navegador​

Você não precisa de um ambiente de desenvolvimento local para testar PRs do Gutenberg—use o Playground para fazer isso diretamente no navegador.

  1. Copie o ID do PR que você gostaria de testar (escolha um da lista de Pull Requests abertos).
  2. Abra o Visualizador de PRs do Gutenberg do Playground e cole o ID que você copiou.
  3. Assim que você clicar em Ir, o Playground verificará se o PR é válido e abrirá uma nova aba com o PR relevante, permitindo que você revise as mudanças propostas.

Traduzir Plugins WordPress com Playground no navegador​

Você pode traduzir Plugins WordPress suportados carregando o plugin que você deseja traduzir e usar a Tradução Inline. Se os desenvolvedores do plugin adicionaram a opção, você encontrará o link Traduzir ao Vivo na barra de ferramentas superior direita da visualização de tradução. Você pode ler mais sobre esta nova e empolgante opção nesta postagem do blog Polyglots.

Obtenha ajuda e contribua com o WordPress Playground​

Tem uma pergunta ou uma ideia para um novo recurso? Encontrou um bug? Algo não está funcionando como esperado? Estamos aqui para ajudar: