Neste artigo
Instalar plugins em massa com WP-CLI é executar um único comando no terminal que baixa, instala e ativa vários plugins de uma vez, sem abrir o wp-admin. O WP-CLI é a interface de linha de comando oficial do WordPress, mantida pela equipe do projeto, e troca a navegação manual por instruções diretas ao núcleo. Para quem cuida de mais de um site, isso muda a operação: o que levava vinte minutos de cliques vira um comando reproduzível. Este tutorial faz parte do guia os melhores plugins para WordPress e dos conteúdos de plugins WordPress da FULL, e cobre desde o comando base até a ativação em rede no multisite, com os erros que mais aparecem no caminho.
Primeiros passos: Visão geral do comando wp plugin install
O comando central é wp plugin install, que aceita um ou mais nomes de plugin na mesma linha e resolve cada download a partir do repositório WordPress.org. Em um teste simples, wp plugin install wordpress-seo wordfence wp-rocket --activate baixa os três plugins e os ativa em sequência, em poucos segundos. A tabela abaixo resume as quatro etapas do fluxo e o que validar em cada uma antes de seguir para o site seguinte.
| Etapa | Objetivo | Check de validação |
|---|---|---|
| Acessar o servidor | Abrir SSH na raiz do WordPress | wp core version retorna a versão sem erro |
| Listar os slugs | Reunir os nomes exatos do WordPress.org | Cada slug abre uma página em WordPress.org/plugins |
| Rodar o install | Baixar e ativar tudo em um comando | Saída mostra “Plugin installed successfully” |
| Conferir o estado | Validar versão e ativação de cada plugin | wp plugin list marca status active |
A lógica é sempre a mesma, mude o site ou o servidor. O slug é a chave: ele aparece na URL da página do plugin no diretório oficial e é o que o WP-CLI usa para localizar o pacote. Errar uma letra do slug é o motivo número um de falha, bem mais comum que problema de permissão.
Como instalar plugins em massa com WP-CLI: Passo a passo completo
Instalar plugins em massa com WP-CLI exige três comandos principais e leva menos de um minuto por site depois que o slug está mapeado. O ponto crítico é rodar tudo a partir da pasta raiz da instalação, onde mora o arquivo wp-config; fora dela, o WP-CLI aborta com “This does not seem to be a WordPress installation”.
Os passos abaixo são H3 dentro deste fluxo único, na ordem que a equipe da FULL usa para padronizar dezenas de sites. O fluxo é sempre o mesmo, mude o servidor que mude: acesso, lista de slugs e o comando de instalação.
Passo 1: Acesse o servidor via SSH
Conecte ao servidor por SSH e navegue até a raiz do WordPress com cd /caminho/do/site. Rode wp core version para confirmar que o WP-CLI enxerga a instalação. Se o comando devolver o número da versão, o ambiente está pronto; se reclamar de instalação, você está na pasta errada.
Passo 2: Monte a lista de slugs corretos
Abra cada plugin em WordPress.org/plugins e copie o slug da URL. Para um stack padrão, a lista costuma ser wordpress-seo wordfence wp-super-cache contact-form-7. Slugs separados por espaço entram todos no mesmo comando. Guarde essa lista em um arquivo de texto para reusar em outros sites.
Passo 3: Rode o comando de instalação em massa
Execute wp plugin install wordpress-seo wordfence wp-super-cache contact-form-7 --activate. O WP-CLI baixa cada pacote do WordPress.org, descompacta na pasta wp-content/plugins e, com --activate, liga cada plugin logo após o download. Para travar versões, acrescente --version=6.5 ao slug específico que precisa de uma release exata.
Por que a flag –force torna a instalação idempotente
Ao instalar plugins em massa com WP-CLI, a flag --force reinstala um plugin mesmo que ele já exista, sobrescrevendo a versão atual sem pedir confirmação. Isso torna o comando idempotente e seguro para rodar duas vezes, em vez de quebrar quando o plugin já está presente. É a diferença entre um script confiável e um processo manual.
Idempotência é a propriedade que garante que executar o mesmo comando de novo não quebra nada: rodar wp plugin install wordpress-seo --force num site que já tem o Yoast apenas reescreve os arquivos, sem duplicar a entrada nem corromper a ativação. Segundo o WP-CLI Handbook oficial mantido pela equipe do WordPress, que documenta cada flag do comando com exemplos reais, wp plugin install $(wp plugin list --field=name) --force reinstala todos os plugins ativos de uma vez, recurso útil para reparar um site após uma migração. Sem --force, o WP-CLI pula plugins já presentes e devolve um aviso, não um erro.
Como ativar em rede no WordPress multisite
Ao instalar plugins em massa com WP-CLI num multisite, a ativação em rede usa a flag --activate-network, que liga o plugin para todos os subsites de uma instalação multisite de uma só vez. Em uma rede com cinquenta lojas, wp plugin install woocommerce --activate-network instala e libera o WooCommerce para a rede inteira em um comando.
A diferença em relação ao --activate simples é o escopo: --activate liga só no site atual; --activate-network registra o plugin como ativo na rede. Para operações por subsite específico, o WP-CLI aceita --url=https://loja3.exemplo.com na frente de qualquer comando, mirando aquele subsite. Esse controle granular é o que faz o WP-CLI ser a ferramenta padrão de quem administra vários sites WordPress em escala. Um detalhe de campo: rede grande pede --activate-network no fim do provisionamento, nunca no meio, para evitar ativar um plugin antes de o subsite estar configurado.
Como automatizar instalar plugins em massa com WP-CLI via script
Um arquivo Bash com a sequência de comandos transforma a instalação em massa em rotina reproduzível, e roda em qualquer servidor com WP-CLI em segundos. Em vez de digitar os slugs toda vez, você salva um setup.sh com a linha wp plugin install e os plugins do seu stack, dá chmod +x setup.sh e executa em cada site novo.
A equipe da FULL vê no suporte que boa parte dos problemas de plugin nasce de instalações inconsistentes entre ambientes, e um script único elimina essa divergência. Para projetos com dependências versionadas, o WP-CLI integra com o Composer, que gerencia pacotes PHP de forma declarativa, mas para a maioria dos sites o script Bash já entrega o resultado. Antes de rodar em produção, teste o script em um ambiente de staging: assim você valida os slugs e a ordem de ativação sem risco. Reusar o mesmo arquivo em todos os sites mantém o ambiente idêntico e auditável.
Quando o WP-CLI agiliza a gestão de plugins na prática
Instalar plugins em massa com WP-CLI compensa a partir do segundo site sob sua gestão, e o ganho cresce de forma não-linear com o número de instalações. Quem cuida de um blog pessoal raramente precisa do terminal; já uma agência com trinta clientes economiza horas por mês ao padronizar a instalação via comando.
Quando o assunto é manter os plugins atualizados, o mesmo princípio vale para a atualização correta de plugins e para a desativação de plugins em lote, todos resolvidos por subcomandos de wp plugin. Listar tudo que está lento, por exemplo, ajuda a decidir o que remover antes de provisionar um site novo, tema que tratamos em encontrar plugins lentos no WordPress. O ponto de inflexão é a repetição: toda tarefa que você faria mais de duas vezes no painel vira um comando único no WP-CLI, com menos erro humano e log completo do que aconteceu.
Acelere a gestão dos seus sites com a plataforma FULL
Dominar o WP-CLI resolve a instalação, mas manter dezenas de sites com os mesmos plugins premium ativados e licenciados é outro custo. No plano PRO da plataforma FULL, por R$849, você ativa plugins premium como WP Rocket, Rank Math PRO e Elementor PRO em até 10 sites com um clique, o que dá R$85 por site.
Esse valor de R$85 por site contrasta com a soma das licenças avulsas, que passa fácil de R$1.500 por ano só nesses três plugins. A gente vê no suporte que o gargalo da maioria das agências não é instalar, é renovar e licenciar plugin a plugin em cada cliente. Conheça os planos da FULL e combine a agilidade do WP-CLI com licenças centralizadas.
Legenda: um único comando wp plugin install baixa e ativa vários plugins, o que reduz a instalação manual a segundos.
Perguntas frequentes sobre instalar plugins em massa com WP-CLI
Quantos plugins o comando wp plugin install aceita de uma vez?
Ao instalar plugins em massa com WP-CLI, o comando aceita quantos plugins você listar na mesma linha, sem limite fixo definido pela ferramenta. Na prática, você separa os slugs por espaço, como em wp plugin install yoast wordfence wp-rocket --activate, e o terminal baixa cada um em sequência. O limite real é a memória e o tempo de execução do PHP no servidor; para listas muito longas, um arquivo de script Bash evita timeout e mantém o log de cada instalação.
É possível instalar plugins em massa com WP-CLI sem ativar cada um?
Sim, dá para instalar plugins em massa com WP-CLI sem ativá-los: basta omitir a flag --activate do comando. Rodar wp plugin install yoast wordfence baixa e instala os dois plugins, mas deixa ambos desativados, prontos para ligar depois com wp plugin activate. Isso é útil quando você quer provisionar o site primeiro e ativar os plugins em uma janela controlada, evitando carga simultânea. A separação entre instalar e ativar é um dos motivos pelos quais o WP-CLI dá mais controle que o painel.
Por que o WP-CLI não encontra a minha instalação do WordPress?
Quase sempre porque o comando foi rodado fora da pasta raiz do site, onde fica o wp-config.php. O WP-CLI procura esse arquivo para identificar a instalação; sem ele, devolve “This does not seem to be a WordPress installation”. A correção é navegar até a raiz com cd antes de rodar qualquer comando, ou usar a flag --path=/caminho/do/site apontando para o diretório certo. Permissão de arquivo é a segunda causa mais comum.
Como instalar uma versão específica de um plugin pelo WP-CLI?
Use a flag --version colada ao comando, como em wp plugin install wordpress-seo --version=22.6. O WP-CLI busca exatamente aquela release no WordPress.org em vez da versão estável mais recente, o que é essencial para reproduzir um ambiente ou evitar uma atualização que quebrou compatibilidade. Combine com --force se precisar fazer downgrade de uma versão já instalada, já que sem ele o comando ignora plugins existentes.
O WP-CLI funciona em qualquer hospedagem WordPress?
Para instalar plugins em massa com WP-CLI, funciona em qualquer hospedagem que ofereça acesso SSH e permita executar o binário do WP-CLI, o que cobre a maioria dos planos VPS e dedicados. Hospedagens compartilhadas mais básicas às vezes bloqueiam o SSH ou limitam comandos, e aí o WP-CLI não roda. Antes de planejar a gestão por terminal, confirme com o provedor se o SSH está liberado; muitos painéis gerenciados já trazem o WP-CLI pré-instalado e prontos para uso imediato.
Próximos passos para padronizar seus sites com WP-CLI
O WP-CLI deixa de ser comando solto e vira rotina quando você salva os slugs do seu stack em um script e o reusa em cada projeto novo. Instalar plugins em massa com WP-CLI começa pelo básico testado aqui: acesse via SSH, monte a lista de slugs corretos e rode o wp plugin install com --activate. Da segunda instalação em diante, o ganho de tempo já justifica o aprendizado, e flags como --force e --activate-network cobrem os casos de reparo e multisite. Para continuar aprofundando a operação por terminal, o WP-CLI para gestão do WordPress mostra os outros fluxos essenciais além de plugins. E para reunir tutoriais, guias e reviews em um só lugar, o FULL Academy organiza o caminho completo de quem administra WordPress em escala.
