Solução de Problemas

Esta página contém soluções para problemas comuns que você pode encontrar ao usar o plugin Cloudflare R2 Media & Static CDN. Se você não encontrar a solução para seu problema aqui, não hesite em entrar em contato com nosso suporte.

Problemas de Instalação

O AWS SDK não está sendo reconhecido

Sintomas: Você recebe uma mensagem de erro informando que o AWS SDK não foi encontrado ou não está instalado corretamente.

Solução:

  1. Verifique se você instalou o AWS SDK corretamente no diretório do plugin.
  2. Certifique-se de que existe um arquivo 'autoload.php' na pasta vendor/ do plugin.
  3. Se a instalação automática falhou, tente instalar o SDK manualmente seguindo estas etapas:
    • Via FTP:
      1. Baixe o AWS SDK de https://github.com/aws/aws-sdk-php/releases
      2. Extraia o arquivo baixado
      3. Crie uma pasta 'vendor' dentro do diretório do plugin (wp-content/plugins/r2-assets-cdn/)
      4. Faça upload da pasta extraída para o diretório 'vendor'
      5. Certifique-se de que exista um arquivo 'autoload.php' em vendor/
    • Via SSH/Terminal:
      cd wp-content/plugins/r2-assets-cdn/
      composer require aws/aws-sdk-php
  4. Desative e reative o plugin após instalar o SDK.

Erro ao ativar o plugin

Sintomas: Ocorre um erro quando você tenta ativar o plugin ou o plugin é ativado mas não funciona corretamente.

Solução:

  1. Verifique se seu servidor atende aos requisitos mínimos (PHP 7.4+, WordPress 5.6+).
  2. Desative todos os outros plugins e reative-os um por um para identificar conflitos.
  3. Ative o modo de depuração do WordPress para obter mais informações sobre o erro:
    1. Edite o arquivo wp-config.php
    2. Encontre a linha define('WP_DEBUG', false);
    3. Altere para define('WP_DEBUG', true);
    4. Adicione também: define('WP_DEBUG_LOG', true);
    5. Tente ativar o plugin novamente e verifique o arquivo de log debug.log em wp-content/
  4. Se o problema persistir, tente reinstalar o plugin com uma cópia nova do arquivo.

O plugin está ativo mas não aparece no menu lateral

Sintomas: O plugin está ativado, mas o menu "Cloudflare R2 Media & Static CDN" não aparece no painel administrativo.

Solução:

  1. Verifique se você está logado como administrador, pois o menu só é visível para usuários com permissões de administrador.
  2. Tente limpar o cache do navegador e atualizar a página.
  3. Verifique se há conflitos com outros plugins que modificam o menu administrativo.
  4. Desative e reative o plugin.
  5. Se o problema persistir, verifique o arquivo debug.log para possíveis erros.

Problemas de Conexão

Erro de conexão com o R2

Sintomas: O teste de conexão falha ou você recebe mensagens de erro ao tentar enviar arquivos para o R2.

Solução:

  1. Verifique se as credenciais R2 estão corretas:
    • R2 Access Key
    • R2 Secret Key
    • Nome do bucket R2
    • URL do endpoint R2
  2. Confirme se o bucket R2 existe e está acessível.
  3. Verifique se o seu servidor pode fazer conexões externas (algumas hospedagens restringem isso).
  4. Certifique-se de que o token API R2 tem permissões de leitura e escrita.
  5. Verifique se há firewalls ou regras de segurança bloqueando conexões externas.

Arquivos não estão sendo servidos pelo CDN

Sintomas: O upload de arquivos para o R2 funciona, mas os arquivos não estão sendo servidos pelo CDN.

Solução:

  1. Verifique se o CDN está ativado nas configurações do plugin.
  2. Limpe o cache do site e do navegador.
  3. Verifique se os arquivos foram realmente enviados para o R2:
    • Acesse o painel da Cloudflare e verifique se os arquivos estão no bucket.
    • Confira as estatísticas de upload no plugin para ver se os arquivos foram registrados como enviados.
  4. Confirme se a URL do CDN está configurada corretamente e que é acessível.
  5. Verifique as permissões do bucket R2 (deve ser configurado como público).
  6. Se você está usando um domínio personalizado para o CDN, verifique se o DNS está configurado corretamente.

Tempo limite excedido durante upload

Sintomas: O processo de upload para o R2 falha com erros de tempo limite.

Solução:

  1. Reduza o tamanho do lote nas configurações do plugin:
    • Para arquivos estáticos, tente reduzir para 20-30 arquivos por lote.
    • Para imagens, tente reduzir para 10-15 imagens por lote.
  2. Aumente o tempo limite do PHP se você tiver acesso ao php.ini ou wp-config.php: set_time_limit(300); ou max_execution_time = 300
  3. Verifique a velocidade de upload da sua conexão com a internet.
  4. Desative temporariamente a otimização de imagens durante o upload inicial (você pode reprocessá-las depois).
  5. Se o problema persistir, tente realizar o upload em diferentes momentos do dia quando a rede estiver menos congestionada.

Problemas com Imagens

Imagens não estão sendo convertidas para WebP/AVIF

Sintomas: A otimização de imagens está ativada, mas as imagens não estão sendo convertidas para WebP ou AVIF.

Solução:

  1. Verifique se a otimização de imagens está ativada (recurso premium).
  2. Confirme se as opções de conversão para WebP e/ou AVIF estão marcadas nas configurações.
  3. Verifique se o servidor tem as bibliotecas necessárias:
    • GD com suporte a WebP
    • Imagick com suporte a WebP/AVIF
  4. Execute a ferramenta de verificação de ambiente no plugin para confirmar se todas as extensões necessárias estão disponíveis.
  5. Algumas imagens podem não ser compatíveis com a conversão. Tente com diferentes tipos de imagens.
  6. Se você está reprocessando imagens existentes, certifique-se de que selecionou a opção de criar versões WebP/AVIF.

Imagens quebradas após ativar o CDN

Sintomas: Após ativar o CDN para imagens, algumas ou todas as imagens aparecem quebradas no site.

Solução:

  1. Verifique se todas as imagens foram enviadas para o R2 antes de ativar o CDN:
    • Compare o número de imagens na biblioteca de mídia com o número de imagens enviadas nas estatísticas do plugin.
  2. Confirme se a URL do CDN está configurada corretamente.
  3. Verifique se o bucket R2 está configurado como público.
  4. Desative temporariamente o CDN para verificar se o problema está relacionado ao plugin:
    • Desative o CDN nas configurações do plugin.
    • Limpe qualquer cache de página.
    • Verifique se as imagens aparecem normalmente a partir do servidor WordPress.
  5. Verifique se há conflitos com outros plugins de otimização de imagem ou CDN.
  6. Inspecione as URLs das imagens quebradas no navegador (clique com botão direito > Inspecionar) para ver se há algum erro na URL.

Erros de memória durante otimização de imagens

Sintomas: Durante o processo de otimização de imagens, você recebe erros de memória do PHP.

Solução:

  1. Aumente o limite de memória do PHP:
    • Edite o arquivo wp-config.php e adicione: define('WP_MEMORY_LIMIT', '256M');
    • Se tiver acesso ao php.ini, aumente o valor de memory_limit: memory_limit = 256M
  2. Reduza o tamanho do lote nas configurações do plugin.
  3. Desative temporariamente formatos que exigem muita memória (como AVIF).
  4. Reduza a qualidade de otimização para imagens grandes.
  5. Processe as imagens em lotes menores ao longo do tempo.
  6. Se possível, otimize as imagens localmente antes de fazer upload para o WordPress.

Problemas de Desempenho

Upload de arquivos muito lento

Sintomas: O processo de upload para o R2 está funcionando, mas é extremamente lento.

Solução:

  1. Verifique a velocidade de upload da sua conexão de internet.
  2. Reduza o tamanho do lote se o seu servidor tiver recursos limitados.
  3. Verifique o uso de CPU e memória durante o upload (pode estar sobrecarregando o servidor).
  4. Desative temporariamente outros plugins intensivos em recursos.
  5. Tente realizar o upload em horários de menor tráfego.
  6. Se você está otimizando imagens durante o upload, considere desativar temporariamente essa opção e otimizá-las posteriormente.
  7. Verifique se há outras tarefas em segundo plano consumindo recursos do servidor.

Site mais lento após ativar o plugin

Sintomas: Após a ativação do plugin e configuração do CDN, o site parece mais lento do que antes.

Solução:

  1. Verifique se todos os arquivos foram realmente enviados para o R2 antes de ativar o CDN.
  2. Confirme se a URL do CDN está configurada corretamente.
  3. Limpe todos os caches (plugin de cache, navegador, etc.).
  4. Verifique se há conflitos com outros plugins de CDN ou otimização:
    • Desative temporariamente outros plugins de CDN ou otimização.
    • Verifique se há múltiplas substituições de URL ocorrendo simultaneamente.
  5. Utilize ferramentas como Google PageSpeed Insights, GTmetrix ou WebPageTest para identificar gargalos específicos.
  6. Verifique se o Cloudflare R2 está respondendo rapidamente (pode haver problemas regionais temporários).
  7. Compare o tempo de carregamento de arquivos diretamente do seu servidor e do CDN para identificar onde está o atraso.

Alto uso de CPU/memória durante operações do plugin

Sintomas: O servidor mostra alto uso de CPU ou memória durante operações como upload, escaneamento ou reprocessamento.

Solução:

  1. Reduza o tamanho do lote nas configurações do plugin.
  2. Aumentar os recursos do servidor, se possível.
  3. Agende operações intensivas para horários de baixo tráfego.
  4. Divida grandes operações em etapas menores.
  5. Desative temporariamente recursos que exigem muito processamento, como conversão para WebP/AVIF.
  6. Verifique se há outros processos ou plugins consumindo recursos simultaneamente.
  7. Considere usar a versão premium para acessar recursos de otimização mais eficientes.

Problemas de Licenciamento

Licença não é aceita

Sintomas: Ao tentar ativar sua licença premium, você recebe uma mensagem de erro informando que a licença é inválida.

Solução:

  1. Verifique se a chave de licença foi inserida corretamente (sem espaços extras ou caracteres inválidos).
  2. Confirme se o e-mail associado à licença está correto.
  3. Verifique se a licença já não está ativa em outro site (cada licença Single Site só pode ser usada em um site por vez).
  4. Certifique-se de que sua licença não expirou.
  5. Confirme se o seu site pode se conectar aos servidores de licenciamento (algumas configurações de firewall podem bloquear isso).
  6. Se o problema persistir, entre em contato com nosso suporte para verificar o status da sua licença.

Recursos premium não funcionam após ativação da licença

Sintomas: Sua licença está ativa, mas os recursos premium não estão disponíveis ou não funcionam corretamente.

Solução:

  1. Verifique o status da licença na aba de Licenciamento.
  2. Tente desativar e reativar a licença.
  3. Certifique-se de que você está usando a versão mais recente do plugin.
  4. Limpe o cache do WordPress e do navegador.
  5. Verifique se há conflitos com outros plugins.
  6. Em casos raros, pode ser necessário reinstalar o plugin (mantenha suas configurações salvando-as antes).