blog
WordPress

Instalar plugin no WordPress passo a passo sem derrubar o site

O passo a passo pelo painel, em cliques, e o que fazer quando o upload do .zip esbarra no limite do php.ini, quando aparece permission denied ou quando a tela fica branca depois de ativar.

JR · · 15 min de leitura · 2 tabelas · 2 blocos de código

Resposta curta: instalar um plugin pelo painel são cinco cliques: Plugins, Adicionar novo plugin, buscar, Instalar agora e Ativar. O que trava costuma ser outra coisa: .zip acima do `upload_max_filesize`, permission denied por dono errado ou tela branca, resolvida renomeando a pasta do plugin pelo cPanel.

Neste artigo
  1. O que um plugin faz no WordPress e por que cada um é uma peça a mais que pode falhar
  2. Os três preparativos que levam cinco minutos e evitam o prejuízo
  3. Os cinco cliques que instalam um plugin pelo painel
  4. A ronda de um minuto que confirma se o site continua de pé
  5. Site ficou branco depois de ativar: como desativar o plugin sem entrar no painel
  6. Ler o error_log do cPanel para saber qual arquivo derrubou o site
  7. Como atualizar e como remover um plugin sem deixar sobra
  8. A operação inteira em seis linhas

O que um plugin faz no WordPress e por que cada um é uma peça a mais que pode falhar

O WordPress é o programa que monta as páginas do seu site. Ele já vem com o básico: escrever textos, publicar páginas, colocar imagens.

Um plugin é um acessório que você encaixa nesse programa para ele fazer algo que não fazia. Formulário de contato, loja, galeria de fotos, backup automático. Pense em um carro de fábrica: ele anda sem nada instalado. Você adiciona um suporte de celular, um som melhor, um porta-malas de teto. Cada acessório resolve um problema e cada acessório é uma peça a mais que pode dar defeito.

É por isso que instalar plugin não é apertar um botão. É uma pequena operação com três tempos: o que você faz antes, o clique em si, e a conferência depois. Quem faz só o clique é quem escreve na internet que "o site sumiu depois que instalei".

A parte do painel neste guia segue a documentação oficial do WordPress sobre gerenciamento de plugins. O resto é organização da tarefa e tratamento de erro.

Os três preparativos que levam cinco minutos e evitam o prejuízo

Três preparativos. Nenhum leva mais de cinco minutos.

Backup no cPanel antes de mexer em qualquer plugin

Backup é uma cópia do seu site guardada em outro lugar. Se algo quebrar, você volta para a cópia e o site fica como estava.

No cPanel, que é o painel de controle da hospedagem (a tela onde você administra arquivos, e-mails e bancos de dados do seu plano), existe uma área de backup. Baixe a cópia antes de mexer em plugin. Se você nunca fez isso, o guia de backup no cPanel aqui no blog mostra a tela exata.

Backup feito antes vale mais que qualquer conhecimento técnico depois.

Anote a versão do WordPress e a data para saber o que mudou

Entre no painel de administração do seu site (o endereço costuma ser o seu domínio seguido de /wp-admin) e vá em Painel > Atualizações. A versão aparece escrita na tela. Anote em um bloco de notas, junto com a data.

Serve para duas coisas: saber se um plugin é compatível com a sua versão (a página do plugin informa "Testado até") e, se precisar de ajuda, poder dizer exatamente qual versão você usa.

Um plugin por vez deixa você com um único suspeito

Essa é a regra que mais economiza tempo. Instalou, ativou, conferiu o site, deu certo, só então vá para o próximo.

Se você ativar quatro plugins de uma vez e o site quebrar, você tem quatro suspeitos e nenhuma pista. Um por vez transforma um mistério em uma resposta imediata.

Os cinco cliques que instalam um plugin pelo painel

Esta é a forma recomendada: buscar no diretório oficial dentro do próprio painel, sem baixar arquivo nenhum para o computador. Diretório oficial é o catálogo gratuito de plugins mantido pelo próprio WordPress, já embutido no seu painel: você pesquisa e instala dali sem sair do site.

O que ter em mãos antes de começar

Plugins no menu da esquerda mostra o que já está instalado

No menu escuro da esquerda, clique em Plugins. Você verá a lista do que já está instalado. Um site novo geralmente já vem com um ou dois itens.

Adicionar novo plugin abre a busca no diretório oficial

No topo da tela, clique em Adicionar novo plugin. Abre uma vitrine com plugins em destaque, populares e recomendados.

Três dados do cartão do plugin que valem olhar antes de instalar

Use o campo de busca à direita. Você pode digitar o nome exato ("Contact Form 7", por exemplo) ou a função que quer ("formulário de contato").

Antes de clicar em instalar, olhe três informações no cartão do plugin: as estrelas de avaliação, o número de instalações ativas e a data da última atualização. Um plugin sem atualização há muito tempo é um acessório abandonado pelo fabricante.

Instalar agora baixa os arquivos e não liga nada ainda

Clique em Instalar agora. O botão muda de texto enquanto o WordPress baixa os arquivos. Nesse momento o plugin está no seu site, mas ainda desligado. É como a peça comprada e guardada na garagem.

Ativar põe o plugin em funcionamento e costuma criar um item de menu

Quando o botão virar Ativar, clique. Agora sim o plugin está em funcionamento. Quase sempre aparece uma mensagem de boas-vindas ou um novo item no menu da esquerda.

Se a sua hospedagem não permitir instalar pelo painel ou o plugin não estiver no diretório oficial, existe a opção Enviar plugin, na mesma tela, para subir um arquivo .zip que você recebeu do desenvolvedor. Só envie arquivo de origem conhecida. Plugin de origem desconhecida ou pirata é um risco conhecido de invasão: o arquivo pode vir com código escondido que você não tem como conferir.

Onde clicar O que você deve ver depois
Plugins Lista dos plugins já instalados, com o status de cada um
Adicionar novo plugin Vitrine com busca no diretório oficial
Instalar agora O botão muda para Ativar
Ativar Aviso de sucesso e, em geral, um novo item de menu
Plugins > Plugins instalados O plugin aparece na lista com fundo destacado e link Desativar

O envio do .zip falhou no upload_max_filesize: o que mexer e a saída rápida

Você escolhe o arquivo, clica em enviar e o WordPress responde que "o arquivo ultrapassa o limite definido em upload_max_filesize no php.ini". Não é plugin corrompido nem site quebrado. É o servidor recusando arquivo acima do tamanho máximo configurado.

Duas diretivas mandam nisso: upload_max_filesize, que define o tamanho máximo de um arquivo enviado, e post_max_size, que define o tamanho máximo do envio inteiro. A segunda precisa ser igual ou maior que a primeira, senão o limite menor vence. Em plano com cPanel, a tela costuma se chamar Seletor de PHP ou MultiPHP INI Editor, e você altera os dois valores por campo, sem editar arquivo.

Saída rápida enquanto isso: se o plugin existe no diretório oficial, instale pela busca do painel. O download acontece do servidor para o servidor e não passa pelo limite de upload. Os detalhes de qual diretiva mexer e em que ordem estão no guia sobre qual diretiva PHP mexer quando o upload do WordPress falha.

Permission denied ao instalar é dono de arquivo errado, não falta de 777

Outra mensagem comum: o WordPress diz que não conseguiu criar o diretório, pede dados de FTP do nada ou retorna "permission denied". Isso é questão de dono do arquivo, não de permissão frouxa.

O PHP roda como um usuário do sistema. Se as pastas de wp-content pertencerem a outro usuário (resíduo de uma migração feita como root, por exemplo), o PHP não consegue gravar ali e a instalação para. A correção é acertar o dono, não sair aplicando 777 em pasta. Permissão 777 deixa qualquer processo do servidor escrever no seu site e é um problema de segurança maior que o erro original. O caminho correto está em permission denied no WordPress e o dono, não o 777.

Os cinco cliques que instalam um pluginPluginsLista do que já está instaladoAdicionar novo pluginBusca no diretório oficialBuscarVeja estrelas, instalações e atualizaçãoInstalar agoraArquivos baixados, plugin ainda desligadoAtivarPlugin em funcionamento no site
Sequência da instalação pelo painel do WordPress, um plugin por vez.

A ronda de um minuto que confirma se o site continua de pé

O painel dizer "plugin ativado" não significa que o site está de pé. O painel e o site são duas telas diferentes.

Faça esta ronda de um minuto, sempre na mesma ordem:

  1. Abra o endereço do seu site em uma nova aba. A página inicial carregou?
  2. Clique em duas páginas internas, por exemplo a de contato e uma de conteúdo.
  3. Se o site tem formulário ou carrinho, teste um envio.
  4. Abra o site no celular. Alguns plugins mudam o layout apenas em telas pequenas.
  5. Volte ao painel e veja se apareceu algum aviso vermelho ou amarelo no topo.

Dica que evita um susto bobo: use uma janela anônima do navegador para ver o site. Para abrir mais rápido, o navegador guarda uma cópia das páginas que você já visitou, e essa cópia pode estar velha. Na janela anônima ele não usa essa cópia guardada, então você vê a página como um visitante que nunca entrou.

Se tudo passou, anote no bloco de notas: nome do plugin, data, deu certo. Esse registro de duas linhas é o que vai te salvar em três meses, quando o site apresentar um problema e você não lembrar o que mudou.

Site ficou branco depois de ativar: como desativar o plugin sem entrar no painel

Aqui está a situação que mais assusta iniciante. Você clicou em Ativar e o site virou uma página em branco. Ou pior: o painel também ficou branco e você não consegue mais desativar nada de dentro do WordPress.

Não há nada de irrecuperável nisso. O seu site continua inteiro no servidor. O que aconteceu é que um pedaço de código travou a montagem da página. E o WordPress tem um comportamento a seu favor: ele só liga um plugin cujos arquivos ele encontra. Se a pasta do plugin desaparecer do lugar de sempre, o WordPress desliga esse plugin sozinho e volta a carregar.

É isso que vamos usar. Sem terminal, sem comando, tudo por cliques no cPanel.

Se você não tem acesso ao cPanel, dá para fazer o mesmo por FTP, que é o programa que conecta o seu computador ao servidor para mexer em arquivos (o FileZilla é o mais usado e é gratuito). Conecte com o host, usuário e senha de FTP que a hospedagem forneceu, navegue até public_html/wp-content/plugins, clique com o botão direito na pasta do plugin e escolha Renomear. O efeito é idêntico ao do Gerenciador de Arquivos.

Abra o Gerenciador de Arquivos no cPanel

O Gerenciador de Arquivos é uma tela parecida com o explorador de arquivos do seu computador. Pastas à esquerda, conteúdo à direita.

O caminho public_html/wp-content/plugins e o que mora em cada pasta

O caminho é sempre o mesmo em uma instalação padrão:

public_html / wp-content / plugins

A pasta public_html é a raiz do site, o terreno onde o site mora. Dentro de wp-content fica tudo que foi adicionado por você: temas, imagens enviadas e plugins.

Como identificar a pasta do plugin que você acabou de ativar

Cada plugin tem sua própria pasta, com nome parecido com o nome do plugin. Como você instalou um por vez, você sabe exatamente qual é. Se ordenar a lista pela data de modificação, a pasta mais recente é a candidata óbvia.

Renomeie a pasta em vez de excluir, porque renomear tem volta

Clique com o botão direito sobre a pasta e escolha Renomear (ou selecione a pasta e use o botão Renomear na barra de cima). Acrescente um sufixo ao nome. Exemplo fictício: a pasta plugin-de-exemplo passa a se chamar plugin-de-exemplo-desativado.

Não exclua. Renomear é reversível, excluir não é.

O site volta na hora e o painel avisa que o plugin foi desativado

Abra o site e o painel novamente. O normal é o site voltar na hora. Ao entrar em Plugins, você verá um aviso dizendo que o plugin foi desativado porque o arquivo dele não foi encontrado. É exatamente o que você queria.

Se quiser tentar de novo mais tarde, volte a pasta ao nome original e ative o plugin com o backup em mãos. Se não quiser mais, aí sim exclua a pasta renomeada ou remova o plugin pelo painel.

Se continuar branco com a pasta renomeada, renomeie a pasta plugins inteira

Então o culpado não era esse plugin, ou não era só ele. Duas saídas:

Tela branca: como desativar o plugin sem o painelSite em branco após ativarPainel também pode não abrirAbra o Gerenciador de ArquivoscPanel, ou FTP se preferirpublic_html/wp-content/pluginsPasta mais recente é a suspeitaRenomeie a pasta do pluginRenomear tem volta, excluir nãoSite voltou?Sim: culpado achado. Não: renomeie pluginsConfira o error_logProcure a linha com Fatal error
Caminho de recuperação sem terminal, todo por cliques no cPanel.

Ler o error_log do cPanel para saber qual arquivo derrubou o site

Log é um caderno onde o servidor anota o que deu errado, com data e hora. Ele existe justamente para casos como tela branca.

No cPanel, há duas maneiras de olhar, ambas por clique:

As anotações são feias, mas você não precisa entender tudo. Procure três coisas: a data e hora mais recente, a palavra Fatal error e o caminho do arquivo. Exemplo fictício de uma linha, apenas para você reconhecer o formato:

[10-Sep-2026 14:02:11 UTC] PHP Fatal error: Uncaught Error: Call to undefined function funcao_de_exemplo() in /home/exemplo/public_html/wp-content/plugins/plugin-de-exemplo/loja.php:88

O que essa linha entrega: o horário, a informação de que foi um erro fatal (o que explica a tela branca) e, no fim, o endereço do arquivo, que aponta a pasta plugin-de-exemplo. Você acabou de identificar o culpado sem adivinhar.

Com essa linha copiada, você tem duas opções boas: pesquisar a mensagem na internet junto com o nome do plugin, ou abrir um atendimento com a hospedagem ou com o autor do plugin colando a linha. Chegar com o log é a diferença entre "meu site não abre" e um diagnóstico.

Como atualizar e como remover um plugin sem deixar sobra

Atualize com backup feito e fora do horário de movimento

Quando sai uma versão nova, o WordPress avisa em Plugins e em Painel > Atualizações, e você atualiza pelo painel, como descreve a documentação oficial.

Duas regras que valem tanto quanto o clique:

Depois de atualizar, repita a ronda de um minuto da seção anterior. Se quebrou, você já sabe o caminho da pasta e do log.

Plugin sem atualizar é risco de segurança, não economia de trabalho. Versão antiga é porta que já foi descrita publicamente para quem procura sites vulneráveis.

Remover tem duas etapas: desativar e só então excluir

Remover tem duas etapas, e é aqui que muita gente para no meio.

  1. Em Plugins, clique em Desativar. O plugin para de funcionar, mas os arquivos continuam no servidor.
  2. Depois de desativado, aparece o link Excluir. Clique nele e confirme. Aí sim os arquivos saem.

Plugin apenas desativado ocupa espaço e, se estiver desatualizado, continua sendo um arquivo desatualizado dentro do seu site. Se você não vai mais usar, exclua.

Ação O que muda no site Os arquivos saem do servidor?
Desativar O plugin para de funcionar Não
Excluir (depois de desativar) O plugin deixa de existir na lista Sim
Renomear a pasta pelo cPanel O WordPress desativa o plugin sozinho Não, ficam no lugar renomeado

Por que os dados do plugin continuam no banco depois de excluir

Um detalhe que ninguém conta para iniciante: excluir os arquivos não garante que os dados criados pelo plugin saiam do banco de dados.

O banco de dados é o arquivo-fichário do site, onde ficam textos, comentários e configurações. Muitos plugins guardam ali as suas preferências, em uma área chamada tabela de opções. Alguns limpam tudo na exclusão, outros deixam esses registros para trás de propósito, para o caso de você reinstalar e não querer reconfigurar nada.

O que fazer com isso sendo iniciante, na ordem de prudência:

A operação inteira em seis linhas

Guarde a operação em seis linhas. Ela não garante que nada vai quebrar, mas reduz muito a chance de derrubar o site instalando plugin e, quando quebrar, você sabe voltar atrás:

  1. Backup no cPanel e versão do WordPress anotada.
  2. Um plugin por vez, sempre.
  3. Plugins, Adicionar novo, buscar, Instalar agora, Ativar.
  4. Ronda de um minuto: home, duas páginas internas, celular, avisos do painel.
  5. Se ficou branco: cPanel, Gerenciador de Arquivos, public_html/wp-content/plugins, renomeie a pasta do plugin.
  6. Se quiser saber o motivo: abra o error_log e procure a linha mais recente com Fatal error.

Seu próximo passo, se você ainda não tem o site no ar, é a instalação do WordPress, que tem guia próprio aqui no blog. Se já tem, instale hoje um único plugin, aquele que resolve o seu problema mais óbvio, e faça a ronda de um minuto. A segunda instalação vai parecer rotina.

Se o que travou foi o envio do arquivo, continue em qual diretiva PHP mexer quando o upload do WordPress falha. Se o WordPress reclamou de permissão ou pediu FTP para instalar, o caminho é permission denied no WordPress e o dono, não o 777.

Referências

  1. Documentação oficial do WordPress — Manage Plugins. Consultado em 2026-09-16.
Leia também