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

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

João Rizzon · 2026-10-18 · WordPress

---

## 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](https://wordpress.org/documentation/article/manage-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

- O WordPress já instalado no seu domínio. Se ainda não está no ar, esse é o passo anterior e tem guia próprio aqui no blog.
- O endereço de acesso ao painel: normalmente `seusite.com.br/wp-admin`. Troque `seusite.com.br` pelo seu endereço. Abre uma tela pedindo usuário e senha.
- Um usuário com permissão de **administrador**. É o perfil que enxerga o menu **Plugins**. Se você entrou e não vê esse menu, sua conta é de outro tipo (autor ou editor, por exemplo) e quem criou o site precisa te dar acesso de administrador.
- Acesso ao cPanel da sua hospedagem, com usuário e senha em mãos. Você vai precisar dele para o backup e para o plano B da tela branca.

### 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](/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](/permission-denied-no-wordpress-e-o-dono-nao-o-777).

## 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:

- Abra o endereço do seu site em uma nova aba. A página inicial carregou?
- Clique em duas páginas internas, por exemplo a de contato e uma de conteúdo.
- Se o site tem formulário ou carrinho, teste um envio.
- Abra o site no celular. Alguns plugins mudam o layout apenas em telas pequenas.
- 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:

- Renomeie a pasta `plugins` inteira para algo como `plugins-off`. Isso desliga todos de uma vez. Site voltou? O problema está em algum plugin. Volte o nome da pasta e reative um a um pelo painel, conferindo o site entre cada ativação.
- Site ainda branco com todos os plugins desligados? O problema está em outro lugar, provavelmente no tema ou em um erro do servidor. Esse é o território do erro 500, que tem artigo próprio aqui no blog.

## 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:

- A área de **Erros** do painel, que mostra as últimas anotações do servidor.
- Um arquivo de texto chamado `error_log`, que aparece no Gerenciador de Arquivos, dentro de `public_html` ou na pasta onde o erro ocorreu. Clique sobre ele e escolha **Visualizar**.

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](https://wordpress.org/documentation/article/manage-plugins/).

Duas regras que valem tanto quanto o clique:

- Backup antes. Atualização também pode quebrar site.
- Atualize em horário de pouco movimento, não na sexta às 18h.

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.

- Em **Plugins**, clique em **Desativar**. O plugin para de funcionar, mas os arquivos continuam no servidor.
- 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:

- Não saia mexendo no banco de dados. Um clique errado ali quebra o site de um jeito bem mais chato que uma tela branca.
- Antes de excluir, veja se o próprio plugin tem uma opção de "remover todos os dados ao desinstalar" nas configurações dele. Vários têm.
- Se instalou e desinstalou muitos plugins ao longo de um ano e quer faxina, isso é tarefa para quem cuida do seu site, com backup do banco feito antes. Não é urgente e não é o que deixa seu site lento no primeiro mês de vida.

## 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:

- Backup no cPanel e versão do WordPress anotada.
- Um plugin por vez, sempre.
- Plugins, Adicionar novo, buscar, Instalar agora, Ativar.
- Ronda de um minuto: home, duas páginas internas, celular, avisos do painel.
- Se ficou branco: cPanel, Gerenciador de Arquivos, `public_html/wp-content/plugins`, renomeie a pasta do plugin.
- 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](/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](/permission-denied-no-wordpress-e-o-dono-nao-o-777).

