
Às vezes, após instalar uma extensão em nossa loja OpenCart, podemos encontrar uma página em branco, e rapidamente percebemos que não sabemos onde procurar a solução.
O erro de página em branco no Opencart é um problema comum que os proprietários de sites Opencart podem enfrentar. Este erro pode ser identificado ao tentar acessar uma página e, em vez de carregar corretamente, uma página em branco é exibida em todo o site ou em uma visualização específica.
Quando encontramos uma página em branco no OpenCart, pode ser difícil saber qual é o verdadeiro problema por trás do erro. Hoje, vamos ensinar como identificar a causa.
Causas Possíveis do Erro de Página em Branco no OpenCart
- Problemas de Compatibilidade: Pode haver problemas de compatibilidade entre a versão do Opencart que você está usando e seu servidor web, banco de dados ou outros plugins.
- Erros de Código: Se houver erros no código do seu site, isso pode causar um erro de página em branco.
- Problemas de Permissão: Seu servidor web pode não ter as permissões adequadas para acessar os arquivos necessários para carregar a página da web. Problemas de Configuração: Se o seu site estiver mal configurado, pode causar um erro de página em branco.
[astra_custom_layout id=296]
Como Corrigir o Erro de Página em Branco no OpenCart?
Para corrigir esse erro, primeiro precisamos saber o que está acontecendo. Acessar uma página da web e encontrar uma “página em branco” que não exibe nenhuma informação útil não é muito útil. Isso pode acontecer porque muitos servidores têm a opção de exibir erros PHP desativada por padrão.
Para corrigir isso, podemos adicionar o seguinte código em /index.php se for um erro de frontend ou em /admin/index.php se for um erro de backend, para “forçar” o sistema a exibir erros:
error_reporting(E_ALL);
ini_set('display_errors', 'On');Este código será adicionado logo após "<?php" como neste exemplo. Na imagem a seguir, mostramos como fica, por favor, preste atenção às linhas 2 e 3.

Dessa forma, podemos obter informações detalhadas sobre o erro que causa a página em branco e corrigi-lo mais facilmente. É importante notar que esta solução deve ser usada apenas em ambientes de desenvolvimento e nunca em produção, pois mostrar erros pode revelar informações sensíveis sobre o servidor.
Após adicionar o código mencionado e atualizar o arquivo correspondente, é recomendável recarregar a URL que anteriormente exibia a "página em branco". Dessa forma, podemos ver o "erro real" e obter algumas pistas sobre o que está acontecendo em nosso site. Isso nos permitirá trabalhar para resolver o problema e melhorar a experiência do usuário. Normalmente, esses são erros como:
- Um ficheiro não está a ser carregado porque não está disponível no nosso sistema (controladores, modelos, vistas, ficheiros de idioma, bibliotecas externas…). Nesse caso, procuraríamos uma cópia de segurança do site para carregá-lo via FTP.
- Um erro sério na sintaxe do código PHP em um determinado arquivo carregado.
Não consegue ver as cores novamente?
Quão maravilhoso é recarregar a página repetidamente para continuar contemplando o belo e eterno branco! Mas não se preocupe, ainda temos algumas opções para pôr fim a este tedioso espetáculo monocromático:
- Vamos "limpar" nossas modificações clicando no botão laranja na seção "Extensões > Modificações". Se, após fazer isso, a página em branco desaparecer, sabemos que o erro vem de alguma modificação. A única solução restante é desativar todas as modificações e ativá-las uma a uma, atualizando as alterações do OCMOD e verificando quando começa a falhar.
- Se estivermos usando VQMOD, também podemos desativar todos os arquivos VQMOD renomeando a pasta /vqmod/xml para /vqmod/xml_ (adicionando um sublinhado à pasta “xml”). Da mesma forma, se virmos que agora está funcionando, é algum arquivo VQMOD que está “corrompendo” seu sistema.
Estamos confiantes de que, seguindo os passos indicados, você será capaz de resolver o erro de página em branco e ter seu site colorido e bonito novamente. Pelo menos, agora sabemos onde está aquele erro desconhecido e, portanto, sabemos qual é o inimigo a enfrentar. Não hesite em entre em contato conosco se você precisar de ajuda com questões relacionadas ao OpenCart.
