Uma das mais famosas características do WordPress é a possibilidade de instalação fácil dos mais diferentes plugins criados para rodar nos sites da plataforma. Contudo, há situações de erros ao instalar plugins WordPress. Ou seja, é possível que o procedimento de adição desses programas nos sites possa apresentar problemas. Problemas esses que serão apresentados neste texto, que se propõe a falar sobre, a apresentá-los e mostrar suas possíveis soluções.
Continue lendo
O que você vai ler
Garanta a Melhor Infraestrutura para WordPress
Soluções dedicadas para otimização, segurança e desempenho
O que são plugins WordPress?
Plugin é o nome dado a programas (softwares) feitos para acrescentar aos sites capacidades novas. Por exemplo, se uma loja virtual, um e-commerce, precisa receber pagamentos via cartões de crédito, então o administrador do site pode instalar um programa que execute essa tarefa e, assim, dê aos clientes essa opção de pagamento.
O WordPress possui milhares de plugins. Praticamente qualquer desenvolvedor pode criar um desses programas, seja para download e instalação gratuitos, seja para fins comerciais.
Há também aqueles plugins, por assim dizer, nativos à própria plataforma. Esse é o caso, por exemplo, do GiveWP, que dá ao site a capacidade de receber doações através da internet. Existe também o WooCommerce, que estrutura o site de modo que ele funcione como uma loja virtual.
Principais erros ao instalar plugins WordPress
Continuando na mesma linha de raciocínio do tópico anterior, dizíamos que o procedimento de instalação de um plugin WordPress pode apresentar falhas. Isso não é algo comum, mas quando acontece, impossibilita a instalação das aplicações.
Erro no IonCube PHP Loader e Versão Desatualizada
O ionCube PHP Loader é uma extensão fundamental para o funcionamento de softwares PHP profissionais. A função dele é decodificar scripts que foram criptografados pelo ionCube Encoder, uma medida de segurança para proteger o código-fonte e bloquear malwares.
Para que um plugin WordPress criptografado funcione, ele precisa encontrar o Loader instalado e ativo no servidor. Quando o processo de decodificação falha, o plugin não roda.
O erro clássico de instalação
falha mais comum ao instalar plugins premium (como a maioria dos desenvolvidos aqui na Link Nacional) ocorre quando o servidor não possui o Loader instalado. O WordPress exibe a seguinte mensagem fatal:
“Site error: the ionCube PHP Loader needs to be installed. This is a widely used PHP extension for running ionCube protected PHP code, website security and malware blocking. Please visit get-loader.ioncube.com for install assistance.”
Traduzindo: “O ionCube PHP Loader precisa ser instalado…”. Se você ver isso, significa que a extensão está ausente. Contudo, existe um segundo cenário muito comum: a extensão está instalada, mas desatualizada.
Como verificar a versão do IonCube Loader (Passo a Passo)
Muitas vezes o erro persiste porque a versão do Loader no seu servidor é antiga e incompatível com o plugin moderno que você está tentando usar. Para 2026, o ideal é estar rodando a versão 15.0.0 ou superior. Veja como identificar a sua versão atual criando um arquivo de diagnóstico simples:
- Crie o arquivo: No seu computador ou direto no gerenciador de arquivos da hospedagem, crie um arquivo de texto e renomeie-o para ioncube.php
- Adicione o código: Abra este arquivo e cole exatamente o seguinte código dentro dele:
phpinfo();
- Faça o Upload: Envie este arquivo para a pasta pública do seu site (geralmente chamada de public_html ou www) através do Gerenciador de Arquivos da hospedagem ou via FTP.
- Acesse no navegador: Digite o endereço do seu site seguido do nome do arquivo, por exemplo: https://seu-dominio.com/ioncube.php.
Uma tela com várias tabelas de configuração do PHP será exibida. Pressione Ctrl + F (ou Command + F no Mac) e pesquise por “ionCube Loader”. Você deve encontrar uma seção idêntica a esta: Verifique o campo Loader Version. Se a versão for inferior a 15.0.0, é necessário atualizar.
Como ativar ou atualizar o IonCube
Se a pesquisa não retornar nenhum resultado no arquivo que você criou, significa que a biblioteca não está habilitada na sua infraestrutura.
- Via Painel de Controle: Em painéis como cPanel ou DirectAdmin, muitas vezes existe a opção “Select PHP Version” ou “PHP Extensions”. Lá, você pode procurar por ioncube_loader e marcar a caixa para ativá-lo.
- Vídeo Tutorial: Preparamos um vídeo explicando como realizar essa ativação através do painel de controle da hospedagem: Assistir tutorial no YouTube.
Caso não consiga ativar ou atualizar, entre em contato imediatamente com o suporte da sua hospedagem atual. Se precisar de um ambiente otimizado e já configurado com as versões mais recentes, considere migrar seu site para um dos planos da Link Nacional.
A pasta de destino já existe
Um outro erro que você pode ter que enfrentar se manifesta através de uma mensagem cujo conteúdo diz que a pasta destino do plugin já existe; isto é, a pasta onde ficará guardado o arquivo em que foi escrito o código do plugin a ser instalado.
Em síntese, isso acontece quando, ao pesquisar por um determinado plugin dentro painel administrativo do WordPress e clicar no botão Instalar agora, você recebe a seguinte mensagem:
“Instalação falhou: a pasta de destino já existe.”
Quando este erro aparece é porque há realmente uma pasta do plugin a ser instalado entre as demais pastas de plugins do seu site. De modo que, se você acessar o painel de controle do seu site, entrar no gerenciador de arquivos e em seguida na pasta que amazena os plugins, você encontrará a pasta do plugin a ser instalado.
Nesse caso, toda a solução consiste basicamente em excluir esta pasta. Depois, tentar novamente instalar o plugin dentro do painel WordPress.
Para facilitar a compreensão do que deve ser feito, deixamos abaixo um vídeo do nosso canal que demonstra a solução em mais detalhes.
Versão do PHP
A versão da linguagem PHP, através da qual o WordPress funciona, também pode ser uma causa de erros na hora de instalar um plugin. Isso acontece porque essa linguagem de programação recebe, de tempos em tempos, novas atualizações, novas versões, que melhoram os sistemas e os deixam mais seguros.
Pois bem, o WordPress é um sistema feito em PHP, ou seja, a linguagem de programação através do qual ele funciona é o PHP. Isso implica que se o PHP recebe uma nova versão, o WordPress do seu site também precisa ser atualizado para esta nova versão, a fim de que você possa desfrutar dos benefícios que ela traz.
Olhando agora para os plugins WordPress, em geral eles são desenvolvidos para funcionar nas versões mais atuais do PHP. E é neste ponto que aparece o erro na hora de instalar um novo plugin no site: pois se o plugin que você deseja usar exige que o PHP do WordPress esteja em uma determinada versão (por exemplo na versão 8.1), mas a versão atual do PHP funcionando no seu WordPress é uma mais antiga (7.2), então fatalmente você receberá uma mensagem de erro e a instalação não acontecerá.
A solução deste erro passa por atualizar o PHP do seu WordPress, de preferência para a versão mais atual. Desse modo, a versão PHP do seu WordPress estará compatível com a versão exigida pelo plugin. E, assim, você poderá instalá-lo e usá-lo sem problemas.
Para realizar essa alteração na versão PHP do seu WordPress você tem duas alternativas: entrando em contato conosco e solicitando este procedimento ou você mesmo pode realizá-lo seguindo os passos do vídeo a seguir.
Soluções WordPress
Depois de aprender sobre os principais erros que podem aparecer ao tentar instalar um plugin WordPress, conheça as demais soluções que oferecemos para sites feitos nessa plataforma. Pois, somos especialistas em WordPress e, além do suporte para a correção de erros como esses de instalação dos plugins, também realizamos outros serviços: criação e hospedagem de sites, desenvolvimento de plugins, manutenção e muitos outros. Conte com as nossas soluções para WordPress!
Garanta a Melhor Experiência com WordPress
Soluções completas em criação, manutenção, e otimização com suporte especializado
