Como Instalar Plugins e Temas do WordPress do GitHub

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.

Instalando temas e plugins do WordPress do GitHub

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?

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.

O que é Github

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.

  1. Primeiro, vá para o repositório do plugin ou tema no GitHub.
  2. Procure por uma seção ‘Releases’ na barra lateral direita. É melhor baixar uma versão estável se houver uma disponível.
  3. 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.
Baixar arquivo zip do GitHub
  1. Vá para sua área de administração do WordPress e navegue até a página Plugins » Adicionar Plugin.
  2. Clique no botão ‘Upload Plugin’ na parte superior da tela.
Fazer upload de plugin
  1. Clique no botão ‘Escolher arquivo’ e selecione o arquivo ZIP do seu computador.
  2. Clique em ‘Instalar Agora’. O WordPress fará o upload e descompactará o arquivo. Observação: O GitHub geralmente adiciona um sufixo como -main ou -master ao nome da pasta (por exemplo, nome-do-plugin-main). Isso é normal e não afetará o funcionamento do plugin.
  3. 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:

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.

Aviso: Nosso conteúdo é apoiado pelos leitores. Isso significa que, se você clicar em alguns de nossos links, poderemos ganhar uma comissão. Veja como o WPBeginner é financiado, por que isso importa e como você pode nos apoiar. Aqui está nosso processo editorial.

O Kit de Ferramentas Definitivo para WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Interações do Leitor

20 CommentsLeave a Reply

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

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

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

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

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

    • 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

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

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

  7. O GitHub é ótimo - para aprender também. Ganhei tanto conhecimento apenas olhando o código do GitHub. Obrigado por este post legal!

  8. 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!

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

    • 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, 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

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

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

Deixe uma resposta

Obrigado por escolher deixar um comentário. Por favor, tenha em mente que todos os comentários são moderados de acordo com nossa política de comentários, e seu endereço de e-mail NÃO será publicado. Por favor, NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.