Você encontrou o plugin ou tema WordPress perfeito, mas há um porém: ele está disponível apenas no GitHub. Ao contrário do repositório oficial do WordPress, não há um botão mágico de "Instalar", o que pode ser intimidador para iniciantes.
A boa notícia é que baixar e instalar software do GitHub é, na verdade, bastante simples. Na WPBeginner, usamos frequentemente o GitHub para acessar ferramentas personalizadas e versões beta de plugins, então dominamos o processo.
Neste guia, mostraremos como instalar plugins e temas WordPress do GitHub passo a passo.

Resumo Rápido: Para instalar um plugin do GitHub, baixe o arquivo ZIP do repositório (verifique se há uma "Release" primeiro), vá para Plugins » Adicionar Novo no WordPress, selecione 'Enviar Plugin', escolha o arquivo ZIP e clique em 'Instalar Agora'.
- O que é GitHub?
- Por que alguns plugins e temas WordPress estão apenas no GitHub?
- Pros and Cons of Installing Plugins from GitHub
- Como Instalar Plugins e Temas do WordPress do GitHub
- Como Obter Atualizações para Plugins do WordPress Instalados do GitHub
- Bônus: Como Implantar Automaticamente Alterações de Temas do WordPress Usando GitHub
- Perguntas Frequentes sobre plugins do GitHub
- Recursos Adicionais de Desenvolvimento de Plugins e Temas do WordPress
O que é GitHub?
GitHub é um serviço de hospedagem baseado em nuvem para desenvolvimento de software e controle de versão usando Git. Ele permite que os desenvolvedores rastreiem alterações, salvem histórico e gerenciem versões de código em projetos.
Além da hospedagem, o GitHub oferece ferramentas práticas para colaboração e acompanhamento de projetos. Os usuários podem trabalhar juntos de forma eficiente, acompanhar desenvolvimentos e interagir com repositórios.
Na WPBeginner e em nossas empresas parceiras, usamos o GitHub para desenvolvimento. Vimos em primeira mão como ele ajuda equipes remotas como a nossa e aumenta a produtividade, garantindo que todo o código seja hospedado com segurança.

Por que alguns plugins e temas WordPress estão apenas no GitHub?
A maioria dos iniciantes instala plugins do diretório WordPress.org ou do site de um desenvolvedor. No entanto, você às vezes descobrirá que a ferramenta específica que precisa está disponível apenas no GitHub.
Existem várias razões pelas quais um desenvolvedor pode optar por hospedar seu trabalho exclusivamente nesta plataforma:
- Diretrizes Rigorosas do Diretório: O diretório oficial de plugins do WordPress tem regras rígidas. Alguns desenvolvedores preferem pular o processo de revisão e hospedar seu código sob seu próprio controle.
- Testes Beta: Desenvolvedores frequentemente usam o GitHub para compartilhar versões "beta" (inacabadas) de seu software. Isso permite que usuários avançados testem novos recursos antes que estejam disponíveis para o público em geral.
- Projetos Não Comerciais: Às vezes, um desenvolvedor cria uma ferramenta simples para seu próprio uso e a compartilha gratuitamente. Eles podem não ter tempo ou interesse em manter uma página de marketing ou um fórum de suporte oficial.
Embora esse ambiente aberto seja ótimo para inovação, também significa que esses plugins nem sempre têm as mesmas verificações de segurança que os que você encontrará no WordPress.org.
Prós e Contras de Instalar Plugins do GitHub
Baixar plugins do GitHub pode lhe dar acesso a ferramentas poderosas, mas não é para todos. Você deve ponderar os benefícios contra os riscos potenciais antes de instalá-los em um site ativo.
Aqui estão as principais vantagens e desvantagens.
👍 Prós de usar plugins do GitHub
- Acesso aos Últimos Recursos: Você pode frequentemente experimentar novos recursos e atualizações
- Contato Direto com o Desenvolvedor: Você pode relatar bugs ou sugerir recursos diretamente ao desenvolvedor usando a aba "Issues" no GitHub.
❌ Contras de usar plugins do GitHub
- Sem Revisão de Segurança: O diretório oficial de plugins do WordPress revisa o código para segurança. O GitHub não, então você deve confiar completamente no desenvolvedor.
- Instabilidade Potencial: O código no GitHub é frequentemente um trabalho em andamento. Ele pode conter bugs ou erros que podem quebrar seu site.
Por causa desses riscos, sempre recomendamos fazer um backup completo do seu site antes de instalar um plugin do GitHub. Você pode usar um plugin como o Duplicator para criar um ponto de restauração seguro.
Agora, vamos explorar os passos para instalar plugins e temas do WordPress a partir do GitHub.
Como Instalar Plugins e Temas do WordPress do GitHub
Instalar plugins do GitHub é semelhante a instalar um plugin do WordPress manualmente. No entanto, como essas ferramentas não são revisadas pela equipe do WordPress, você deve garantir que confia no desenvolvedor antes de instalá-las.
- Primeiro, vá para o repositório do plugin ou tema no GitHub.
- Procure por uma seção ‘Releases’ na barra lateral direita. É melhor baixar uma versão estável se houver uma disponível.
- Se não houver releases, clique no botão ‘Code’ e selecione ‘Download ZIP’. Observação: Isso baixa os arquivos de desenvolvimento, que podem ser instáveis.

- Vá para sua área de administração do WordPress e navegue até a página Plugins » Adicionar Plugin.
- Clique no botão ‘Upload Plugin’ na parte superior da tela.

- Clique no botão ‘Escolher arquivo’ e selecione o arquivo ZIP do seu computador.
- Clique em ‘Instalar Agora’. O WordPress fará o upload e descompactará o arquivo. Observação: O GitHub geralmente adiciona um sufixo como
-mainou-masterao nome da pasta (por exemplo,nome-do-plugin-main). Isso é normal e não afetará o funcionamento do plugin. - Assim que vir a mensagem de sucesso, clique em ‘Ativar’ para começar a usar o plugin em seu site WordPress.
Aviso: Se o plugin exibir um erro fatal após a ativação, ele pode exigir uma etapa de “build” (usando ferramentas como Composer ou NPM). Isso é comum em projetos avançados do GitHub e geralmente não é amigável para iniciantes. Verifique o arquivo README do repositório para obter instruções.
Como Obter Atualizações para Plugins do WordPress Instalados do GitHub
Por padrão, o WordPress não exibe atualizações automáticas para plugins baixados do GitHub. Para receber atualizações, o desenvolvedor deve habilitá-las especificamente.
Existem duas maneiras comuns de isso funcionar:
- Atualizações Integradas: Alguns plugins já incluem código que permite atualizações automáticas diretamente do GitHub. Você não precisa fazer nada extra.
- Plugin Git Updater: O desenvolvedor pode pedir para você instalar o plugin Git Updater (anteriormente GitHub Updater). Este plugin conecta seu site ao GitHub para verificar novas versões.
Recomendamos entrar em contato com o desenvolvedor no GitHub para perguntar sobre a política de atualização dele.
Bônus: Como Implantar Automaticamente Alterações de Temas do WordPress Usando GitHub
Se você é um desenvolvedor trabalhando em um tema personalizado, também pode implantar automaticamente suas alterações no GitHub.
Isso economiza tempo e garante que você tenha diferentes versões do seu tema salvas, caso precise reverter alterações no futuro.
Para mais detalhes, consulte nosso guia sobre como implantar automaticamente alterações de temas do WordPress usando GitHub e Deploy.
Perguntas Frequentes sobre plugins do GitHub
É seguro instalar plugins do GitHub?
Depende do desenvolvedor. Ao contrário do diretório de plugins do WordPress, o GitHub não revisa o código em busca de segurança. Você só deve instalar plugins de desenvolvedores de confiança ou de empresas conceituadas.
Por que o plugin não está no diretório do WordPress?
Desenvolvedores frequentemente usam o GitHub para testes beta ou para plugins que não atendem às diretrizes específicas do repositório oficial. Isso não significa necessariamente que o plugin é ruim, apenas que ele é distribuído de forma diferente.
Recursos Adicionais de Desenvolvimento de Plugins e Temas do WordPress
Você pode achar os seguintes recursos úteis para escolher temas e plugins do WordPress ou para iniciar sua própria jornada de desenvolvimento:
- É Seguro Usar Plugins Desatualizados do WordPress? (Explicado)
- Guia para Iniciantes: Como Escolher o Melhor Plugin do WordPress
- Temas Gratuitos vs. Premium para WordPress (Prós e Contras para Proprietários de Sites)
- Como Adicionar Conteúdo Fictício para Desenvolvimento de Temas no WordPress
Esperamos que este guia tenha ajudado você a instalar plugins ou temas do WordPress a partir do GitHub. Você também pode querer ver nosso guia sobre como codificar um site e nossas escolhas de especialistas para os melhores trechos de código para WordPress.
Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.
Dennis Muthomi
Para mim, eu sempre configuro um ambiente de staging ao testar plugins do GitHub. Isso me poupou tantas dores de cabeça! Posso verificar se tudo funciona corretamente antes de ir para o ar. Isso é especialmente importante com repositórios do GitHub menos conhecidos.
Suas dicas sobre verificar atualizações são certeiras – é exatamente assim que eu cuido dos sites dos meus clientes. Com certeza vou compartilhar isso com meus desenvolvedores juniores que estão apenas começando com coisas do GitHub e WordPress.
Jiří Vaněk
O GitHub ainda é um grande mistério para mim, mas estou tentando aos poucos desvendar seus mistérios e comandos. Estou interessado principalmente por causa das possibilidades de versionamento e também porque ocasionalmente há projetos muito interessantes aqui. E sim, como iniciante, ainda não entendo. Tutoriais como este são muito valiosos para mim, pois este não é o primeiro artigo sobre GitHub que estou lendo aqui. Quanto mais aprendo sobre isso, mais começo a gostar, porque mesmo no WordPress, pode-se sair da caixa, por assim dizer. Isso significa ir um pouco além dos repositórios oficiais do WordPress. E por causa disso, novamente tenho acesso a projetos interessantes. Obrigado por estes guias.
Moinuddin Waheed
Esta é uma ótima notícia que a vasta comunidade do WordPress sem conhecimento de código também pode usar o GitHub para baixar temas e plugins.
Eu pensava que Git e GitHub eram apenas para desenvolvedores em si. Mas podemos usar temas e plugins do WordPress baixados daqui.
Obrigado ao wpbeginner por este tutorial útil.
Às vezes, não encontramos plugins no repositório do WordPress e o Google os mostra no GitHub, então podemos acessá-los e testá-los facilmente em nossas máquinas locais.
Jiří Vaněk
Exato. O que também descobri é que você pode encontrar soluções para muitos problemas no GitHub. Várias vezes, enquanto trabalhava com o WordPress, encontrei um problema em um site estrangeiro e, no meu esforço para ajudar, acabei no GitHub. E lá, encontrei a solução. No entanto, às vezes era um pouco mais complicado para mim implementá-la. É por isso que esses artigos são muito significativos e têm grande potencial para mim, porque sinto que você pode encontrar coisas realmente interessantes no GitHub que geralmente não estão no repositório.
Ethan
Olá, os plugins e temas do GitHub são seguros para baixar sem malware e outros códigos maliciosos?
WPBeginner Support
Dependeria de quem é o código que você está baixando
Admin
Ismail
Olá, administrador,
Muito obrigado por este artigo e aprendo muito com este site. Hoje, quero baixar o Facebook Instant Articles do Github, e este artigo me ajuda a fazer isso. Mas tenho uma pergunta, se possível, por favor, me guie, pois sou novato.
Para o plugin FBIA do Diretório WP, preciso desinstalá-lo e instalar o plugin do Github depois? Espero que você possa me ajudar com isso. Obrigado pela sua ajuda a todas as pessoas.
WPBeginner Support
Se você estiver substituindo o plugin por uma versão do GitHub, normalmente seria melhor remover os arquivos antigos e depois substituí-los pelo plugin do GitHub.
Admin
sim
O WordPress está dizendo que preciso de um plano de negócios para adicionar plugins. Existe alguma maneira de contornar isso? Ou há alguma maneira de eu recuperar um post agendado e publicá-lo manualmente? Não consigo encontrar o post em lugar nenhum.
WPBeginner Support
Por favor, veja nosso guia sobre a diferença entre WordPress.org auto-hospedado vs blog gratuito WordPress.com.
Admin
Andy Fragen
Obrigado por mencionar o GitHub Updater. Ele funciona com plugins ou temas hospedados no GitHub, Bitbucket ou GitLab.
Como bônus, você pode usar o GitHub Updater para realizar uma instalação com um clique de quaisquer plugins ou temas do GitHub, BitBucket ou GitLab (repositórios públicos ou privados) usando apenas o URI do repositório, simplificando enormemente as instruções no artigo.
adolf witzeling
O GitHub é ótimo - para aprender também. Ganhei tanto conhecimento apenas olhando o código do GitHub. Obrigado por este post legal!
Gautam Doddamani
GitHub e StackOverflow são alguns dos meus sites favoritos para conferir scripts úteis que posso usar no meu blog. Eu mesmo estou usando um plugin do GitHub... mas não sabia sobre o atualizador do GitHub... obrigado, pessoal!
Morgan
Aqui está uma dica real:
Clique com o botão direito em "Download ZIP" > Copiar Endereço do Link
Plugins > Adicionar Novo > Enviar > Escolher Arquivo
Quando a janela aparecer para você encontrar seu arquivo zip, basta colar o URL e ele buscará o link. Não há necessidade de poluir seu computador com arquivos que você não precisa.
Andy Fragen
Na verdade, você pode fazer uma instalação com um clique usando o recurso de Instalação Remota do GitHub Updater. O benefício adicional é que o diretório do plugin/tema é renomeado corretamente.
Tracy
Os plugins encontrados no Github são mais "inseguros" do que os plugins que estão no repositório?
WPBeginner Support
Tracy, sim, há uma chance disso. No repositório de plugins do WordPress, os plugins passam por um processo básico de revisão e, como é uma comunidade maior, um plugin inseguro seria detectado muito mais rapidamente do que no GitHub.
Admin
Aaron
Artigo incrível, ouvi sua entrevista no Mixergy. Adoro como você usa FAQs para gerar conteúdo. Eu não tinha ideia de que seu tráfego era tão grande - muito legal ver seu crescimento através da criação de valor. Parabéns! –Aaron
Alfred Degens
Obrigado por este artigo!
Você pode me dizer onde encontrar plugins do WordPress no GitHub?
Existe alguma forma de pesquisar por esses plugins de código aberto no Github?
Eu tentei no Google, mas não encontrei nenhum plugin no Github.
Atenciosamente,
Alfred
WPBeginner Support
Tente pesquisar site:github.com Plugin WordPress
Admin