Principais conclusões:
- A utilização do GitHub com o WordPress permite um controlo de versões eficiente, crucial para gerir alterações ao código e colaborar eficazmente, especialmente em equipas distribuídas.
- A integração do WordPress com o GitHub envolve a criação de um repositório, o envio de ficheiros a partir de um ambiente local ou em tempo real e a sincronização das alterações entre os dois.
- Embora o GitHub seja excelente para o controlo de versões, não é um alojamento web. Continuas a precisar de um fornecedor de alojamento separado para o teu site WordPress.
Com cada vez mais pessoas a contribuir para projectos de código aberto, um controlo de versões eficiente é fundamental para evitar confusões e fornecer a melhor (e mais recente) versão aos utilizadores.
As equipas distribuídas globalmente tornaram-se rapidamente a forma como o desenvolvimento do WordPress é hoje em dia, com um controlo de versões adequado e processos de acesso ao código vitais para o funcionamento da equipa. Com o lançamento de diferentes plataformas Git, como o GitHub e o BitBucket, o fluxo de trabalho de desenvolvimento do WordPress tornou-se muito mais fácil.
Embora a ideia de controlo de versões tenha décadas, com ferramentas populares como o Git disponíveis há algum tempo, a ideia e a implementação do controlo de versões através do Git ainda é um pouco difícil para os utilizadores. Este artigo descreve as vantagens de usar o GitHub e como integrar o WordPress e o GitHub para obter um fluxo de trabalho de desenvolvimento perfeito.
Vantagens de usar o GitHub com o WordPress
O GitHub é uma ferramenta de repositório para programadores que mantêm o seu código online, público ou privado, para o resto dos outros utilizadores. Permite que os programadores partilhem o seu código com outros e inspira-os a colaborar em projectos de todos os tipos. Então, quais são as vantagens do GitHub? Para te convenceres da eficácia deste site, encontrarás abaixo as suas principais vantagens.
O GitHub permite-te:
- Mantém um registo das versões;
- Tem várias cópias de segurança;
- Partilha o teu trabalho mais facilmente;
- Facilita a colaboração da equipa;
- Cria relações sociais;
- Constrói o teu perfil pessoal.
Como utilizar o WordPress e o GitHub?
Depois de receber muitas perguntas dos utilizadores, decidi criar este guia definitivo do GitHub para WordPress que te vai ajudar a gerir sistematicamente os teus projectos WordPress.
Para cobrir a maior parte do terreno, abordei dois cenários principais no desenvolvimento do WordPress:
- Quando tiveres um sítio WordPress ativo num servidor de alojamento ativo e quiseres enviar os ficheiros diretamente para o repositório GitHub (isto ajuda os programadores a colaborar sem esforço), criarei um ambiente de desenvolvimento e implementarei as alterações no sítio ativo.
- Quando tens um ambiente local e queres enviar ficheiros WordPress para o repositório GitHub.
Implementação do GitHub com 1 clique para WordPress
Sincroniza os repositórios do WordPress a partir do GitHub em segundos
Implantação automática para encenação/produção
Ganchos Git pré-configurados e resolução de conflitos
WordPress e GitHub: Ambiente em direto
Presumo que tenhas um site WordPress no teu servidor ao vivo. No meu caso, o meu site WordPress está alojado no Cloudways.
- Passo 1: Cria um repositório no GitHub
- Passo 2: Transfere os ficheiros do site WordPress em direto para o Repositório GitHub
- Passo 3: Instala o Git
- Passo 4: Puxa para a Pasta Local a partir do Repositório GitHub
- Passo 5: Constrói o ambiente de desenvolvimento na máquina local
- Passo 6: Liga o Sublime ao GitHub
- Passo 7: Faz push do local para o GitHub
- Passo 8: Liga o GitHub ao Ambiente em Direto
- Etapa 9: puxa as alterações para um ambiente ativo do GitHub
Passo 1: Cria um repositório no GitHub
Inicia sessão no GitHub e cria um repositório seguindo esta ligação.
Dá um nome ao teu repositório (no meu caso, é GitHub). Podes adicionar uma descrição e um controlo de acesso (selecionei Público) e clicar em Criar repositório.
Passo 2: Transfere os ficheiros do site WordPress em direto para o Repositório GitHub
Depois de criares um novo repositório, tens de fazer push de todos os teus ficheiros e pastas do WordPress do servidor ativo para o novo repositório do GitHub.
Como mencionei anteriormente, utilizarei a plataforma Cloudways para demonstrar o ambiente ao vivo.
Vou iniciar o Terminal SSH do servidor. Se és um cliente da Cloudways, deves estar familiarizado com o terminal SSH, uma interface de linha de comando (CLI) através da qual podes manipular os ficheiros da tua aplicação.
Para iniciar o Terminal SSH, deves navegar para o Painel de Gerenciamento do Servidor Cloudways → Credenciais Mestre → Iniciar Terminal SSH e colar as Credenciais Mestre do servidor (nome de usuário e senha).
Em seguida, executa os seguintes comandos.
cd applications/xxxxxx/public_html (xxxxxx é o nome da pasta da tua aplicação WordPress).
Este é o caminho da tua pasta WordPress. Utilizando o caminho correto, também podes enviar uma pasta específica, como wp-content ou themes folder/files.
git init
Isto inicializa o repositório Git vazio.
git add .
Este comando adiciona todos os ficheiros ao repositório local do GitHub e prepara-os para o primeiro commit.
git checkout -b master
Muda para o ramo principal.
git commit -m "primeira submissão"
Confirma as alterações que foram controladas e prepara-as para o envio para o repositório do GitHub.
Se vires a mensagem “Please tell me who you are”, tens de executar estes comandos:
git config --global user.email "[email protected]" git config --global user.name "O teu nome"
Substitui o e-mail e o nome pelo teu.
git remote add origin URL do repositório remoto
O URL do teu repositório GitHub para onde todos os ficheiros serão enviados. Copia o URL remoto HTTPS e cola-o no URL do repositório remoto.
No meu caso, o comando completo será:
git remote add origin https://github.com/farhanayub/GitHub.git
git push origin master
Este comando irá finalmente enviar todos os ficheiros para o repositório GitHub no ramo principal.
Nota: Terás de introduzir o teu nome de utilizador e a tua palavra-passe do GitHub.
Se vires algum erro, utiliza o seguinte comando e repete todos os comandos em sequência.
rm -rf .git/
Nota: Se tiveres um repositório público, uma boa prática é eliminar o wp-config.php do repositório GitHub porque contém credenciais da tua aplicação WordPress. Podes sempre editá-lo diretamente no site ativo.
Em seguida, verifica o teu repositório GitHub, e pronto! Enviaste com sucesso os teus ficheiros WordPress.
Passo 3: Instala o Git
Agora, podes puxar os teus ficheiros do GitHub para o teu PC local; tens de transferir e instalar o Git no teu sistema local.
Passo 4: Puxa para a Pasta Local a partir do Repositório GitHub
Depois de instalar o Git, vamos começar a puxar ficheiros e pastas para uma pasta local.
Cria uma pasta, entra nela e clica com o botão direito do rato → Git Bash Here. Vai abrir uma janela (semelhante à linha de comandos), onde podes introduzir comandos Git para ligar esta pasta ao repositório online do GitHub.
Introduz os seguintes comandos Git, um a um.
git init git add . git remote add origin https://github.com/farhanayub/GitHub.git /* Não te esqueças de substituir o URL pelo teu próprio URL. */ git pull origin master
Demorará algum tempo, dependendo da velocidade da tua ligação e do tamanho do teu repositório WordPress.
Quando o processo terminar, vai para a tua pasta local do WordPress. Podes ver que todos os ficheiros do repositório do GitHub foram extraídos com êxito.
Passo 5: Constrói o ambiente de desenvolvimento na máquina local
Agora, vamos criar um ambiente de desenvolvimento para o WordPress e o GitHub na máquina local. Vou instalar o Sublime Text e um pacote do GitHub conhecido como GitSavvy.
- Instala o Sublime Text;
Estou a utilizar o Sublime Text como editor de código. Tens de transferir e instalar a versão mais recente do editor Sublime Text. - Instalar o pacote do GitHub para o Sublime Text Editor;
Encontrarás muitas ferramentas do GitHub para o Sublime Text. Estou a utilizar o GitSavvy, um pacote popular.
O GitSavvy tem uma lista completa de comandos do GitHub que te podem ajudar a gerir os teus processos Push e Pull. Para instalar o pacote, abre a paleta de comandos premindo CTRL+SHIFT+P ou navega até Ferramentas → Paleta de comandos.
Aparecerá uma nova janela pop-up, pedindo-te para executares uma tarefa. Tens de instalar o Controlo de Pacotes, que te permitirá adicionar diferentes pacotes do Sublime Text. Procura por Install Package e carrega em enter.
Dentro de alguns segundos, verás um novo popup com uma lista completa de pacotes disponíveis. Agora, procura e instala o GitSavvy.
Após a instalação bem sucedida do pacote GitSavvy, será aberto um novo separador com uma mensagem de boas-vindas da equipa GitSavvy.
Nota: Sugiro que leias isto na íntegra para compreenderes bem os princípios básicos do GitSavvy. Também podes obter ajuda no Sublime Text, premindo
Passo 6: Liga o Sublime Text ao GitHub
Em seguida, tens de ligar o Sublime Text ao GitHub, para que possas enviar facilmente as alterações do ambiente local para o repositório do WordPress no GitHub.
Abre a pasta local do WordPress no Sublime Text, indo a File → Open Folder.
Para testar este ambiente, vou editar o ficheiro wp-login.php e adicionar echo “Hello World!”; no topo do ficheiro, logo abaixo de <?php e Guardá-lo.
Depois, inicializa o GitHub no Sublime Text abrindo a paleta de comandos, procura status e prime enter, onde diz git: status.
Este comando irá comparar a pasta local com a versão do repositório GitHub e informar-te-á do nome dos ficheiros que alteraste.
Podes ver que o wp-login.php está em modo unstaged. Podes fazer muito com este ficheiro seguindo os comandos instruídos. Mas primeiro, tens de preparar este ficheiro, submetê-lo e depois enviá-lo para o repositório do GitHub.
Carrega em S para preparar este ficheiro e verifica o estado através do comando git: status. Verás que o ficheiro foi movido para o modo staged.
Para submeter esta alteração, carrega em c. Abre-se um novo separador que descreve as minhas alterações no ficheiro wp-login.php. Escreve “my commit” no topo do ficheiro e prime CTRL+ENTER para submeter o commit.
Nota: Pode pedir o teu nome e e-mail para que a autorização possa ser submetida em teu nome.
Escala automática dos teus projectos orientados para o GitHub
Lida com picos de tráfego dos pipelines de CI/CD
✓ NGINX + PHP 8.3 para GitHub Actions
Armazenamento em cache do Redis para compilações mais rápidas
Passo 7: Faz push do local para o GitHub
Preciso de informar o Sublime Text sobre o repositório para o qual vou enviar a alteração. Usa o comando git: remote add para definir o URL remoto.
Quando estiveres ligado ao repositório do GitHub, utiliza git: push para fazer push das alterações.
Seleciona a origem e o nome do ramo master.
Nota: Se não tiveres iniciado sessão na tua conta GitHub, poderá ser-te pedido que inicies sessão.
Passo 8: Liga o GitHub ao Ambiente em Direto
Depois de ligares o Sublime Text ao GitHub, tens de iniciar sessão na tua conta Cloudways e entrar na aplicação WordPress. No painel esquerdo do painel, vai para Deployment via Git e toca em Generate SSH Keys.
Clica em VIEW SSH KEY e transfere as chaves SSH.
Volta ao repositório GitHub, navega para Settings → Deploy Keys → Add Deploy Key, define o título e introduz as chaves SSH descarregadas.
Como podes ver, marquei a caixa de verificação onde diz Permitir acesso de escrita porque vou trocar as alterações.
No teu repositório GitHub, navega até ao separador Código, copia a Chave SSH e certifica-te de que seleccionaste a opção utilizar SSH.
Volta para a Plataforma Cloudways, que diz Implantação via Git. Cola a chave SSH no campo Endereço remoto do Git, clica em Autenticar e escolhe a ramificação do seu repositório Git (estou usando master).
O caminho de implantação é deixado vazio porque vou conectar a pasta public_html do aplicativo WordPress com o repositório do GitHub. Agora toca em Start Deployment para conectar a plataforma Cloudways com o GitHub.
Quando estiveres pronto, receberás uma notificação no canto superior direito do ecrã.
Etapa 9: puxa as alterações para um ambiente ativo do GitHub
Tudo está configurado e funcionando bem. Precisamos puxar as alterações do repositório do GitHub para um site WordPress no Cloudways.
A partir da plataforma Cloudways, entra na tua aplicação e depois navega para Application Management → Deployment via Git; carrega no botão Pull.
Bingo!
Todas as alterações foram actualizadas no site ativo. Vê como estão.
Porque é que o Pull não é automatizado?
Puxar todas as alterações pode parecer um incómodo porque tens de o fazer manualmente. O motivo é evitar pushs indesejados para o repositório do GitHub que podem acontecer por engano. É aconselhável fazer um pedido Pull apenas quando estiveres confiante o suficiente para aplicar as alterações no site ativo.
Todo o processo do ambiente de produção pode parecer complexo. No entanto, depois de tudo estar corretamente configurado, só tens de fazer alterações na pasta WordPress local utilizando o editor Sublime Text, fazer push para o GitHub e fazer Pull no site em direto.
WordPress e GitHub: Ambiente local
Este é o segundo caso em que estás a trabalhar na tua máquina local e queres enviar os teus ficheiros WordPress para o repositório GitHub.
Aqui, parto do princípio de que tens uma configuração local pronta (se não tiveres, aqui está um guia completo que te ajudará a fazê-lo).
Por isso, vamos lá começar!
- Passo 1: Transfere e instala o Git
- Passo 2: Inicia sessão no GitHub e cria um novo repositório
- Passo 3: Transfere os ficheiros WordPress do ambiente local para o GitHub
- Passo 4: Verifica o repositório do GitHub
Passo 1: Transfere e instala o Git
Primeiro, tens de transferir e instalar o Git na tua máquina local. Escolhe a versão que é compatível com o teu sistema operativo.
Passo 2: Inicia sessão no GitHub e cria um novo repositório
Depois de instalares o Git, inicia sessão na tua conta GitHub → Respostories → Novo.
Em seguida, tens de preencher os campos e clicar em Criar repositório.
Passo 3: Transfere os ficheiros WordPress do ambiente local para o GitHub
Vou enviar os ficheiros do tema WordPress local (o tema Twenty Twenty) para o repositório GitHub.
Vai para a pasta do tema WordPress, clica com o botão direito do rato para ver o menu de contexto e clica em Git Bash Here.
Aparece uma linha de comandos e tudo o que tens de fazer é utilizar os seguintes comandos.
git init
git add .
git commit -m "primeira submissão"
git remote add origin https://github.com/farhanayub/MyWordPress.git
Podes copiar o teu URL a partir daqui:
git push -u origin master
Passo 4: Verifica o Repositório GitHub
Agora, vai ao GitHub e actualiza a página do repositório. Como podes ver, todos os ficheiros do tema (o Twenty Twenty) foram enviados com êxito para este repositório do GitHub.
Concentra-te no código, não nos servidores
Acesso SSH para sincronização local-to-live
Preparação gratuita para testes de ramos do GitHub
Suporte 24/7 para questões relacionadas com o Git
Resumo
O GitHub para WordPress é útil se estiveres a trabalhar nos teus projectos ou numa equipa. A integração perfeita torna mais fácil para ti e para os membros da tua equipa colaborarem em tempo real. Podes acompanhar e testar todas as tuas alterações de código antes de as enviares para o teu WordPress. Discuti dois cenários de trabalho com um ambiente ao vivo e um ambiente local do WordPress e do GitHub. Se tiveres alguma dúvida, não hesites em perguntar nos comentários abaixo. Além disso, podes aprender tudo sobre a clonagem de um repositório GitHub utilizando a Cloudways Api.
Perguntas frequentes
Q. Quais são os melhores plug-ins do GitHub para WordPress?
De seguida, apresentamos-te os melhores e mais populares plugins do GitHub para WordPress:
- Incorporar GitHub
- Sincronização do GitHub do WordPress
- Atualizador Git
Q. Como é que crio um repositório WordPress no GitHub?
Criar um repositório WordPress no GitHub é bastante simples:
- Inscreve-te/entra numa conta GitHub e cria um novo repositório
- Dá um nome ao teu repositório, como por exemplo WordPress
- Transfere os ficheiros do teu site WordPress para o repositório do GitHub
Q. Como posso implementar o WordPress no GitHub?
Segue os quatro passos para implementar um site WordPress no GitHub.
- Primeiro, transfere e instala o Git no teu ambiente de trabalho
- Inicia sessão no GitHub e cria um novo repositório
- Em seguida, envia os ficheiros WordPress do ambiente local para o GitHub
- Verifica o repositório GitHub
Q. Há alguma consideração de segurança ao integrar o WordPress com o GitHub?
Para uma integração segura do WordPress-GitHub, considera as seguintes indicações:
- Confidencialidade dos dados sensíveis.
- Permissões de ficheiro corretas.
- Segurança de plugins e temas.
- Revisão rigorosa do código.
- Comunicações encriptadas.
- Faz cópias de segurança regulares.
Q. Qual é o processo de sincronização de alterações entre o WordPress e o GitHub?
Considera as indicações abaixo para sincronizar as alterações entre o WordPress e o GitHub:
- Inicia o Git no teu WordPress.
- Liga o teu repositório WordPress ao GitHub.
- Envia os ficheiros do WordPress para o GitHub.
- Implementa actualizações no teu site WordPress.
- Vai buscar alterações do GitHub para o teu WordPress.
- Resolve os conflitos.
P) Posso utilizar o GitHub com o WordPress?
A) Sim, podes utilizar o GitHub com o WordPress para controlo de versões, colaboração e gestão de código. Podes armazenar o teu tema, plugin ou mesmo todo o projeto WordPress num repositório do GitHub.
P) Posso alojar o meu site WordPress no GitHub gratuitamente?
A) Não, o GitHub não foi concebido para alojar sites dinâmicos como o WordPress. Só pode hospedar sites estáticos (por exemplo, usando o GitHub Pages). Para um site WordPress, vais precisar de um serviço de alojamento web separado.
P) Como alojar um site WordPress no GitHub?
A) Não podes alojar um site WordPress completo no GitHub devido à sua natureza dinâmica. No entanto, podes usar o GitHub para controlar a versão do teu tema WordPress, plugins ou activos estáticos e depois implementá-los num fornecedor de alojamento adequado.
P) O GitHub é semelhante ao WordPress?
A) Não, o GitHub e o WordPress têm objectivos diferentes. O GitHub é uma plataforma para colaboração de código e controlo de versões, enquanto o WordPress é um sistema de gestão de conteúdos (CMS) para construir e gerir sítios Web
Mansoor Ahmed Khan
Estou no marketing de conteúdo desde 2014 e ainda me divirto a criar histórias que ressoam com o público-alvo e geram resultados. Na Cloudways by DigitalOcean (uma empresa líder de alojamento na nuvem, aliás!), lidero uma equipa de sonho de criadores de conteúdos. Juntos, fazemos brainstorming, escrevemos e produzimos conteúdos fantásticos em todos os canais: blogues, redes sociais, e-mails, o que quiseres! Podes contactar-me em [email protected].
