Perguntas Frequentes

Aqui você encontrará respostas para as perguntas mais comuns sobre o plugin Cloudflare R2 Media & Static CDN. Se você não encontrar a resposta que procura, não hesite em entrar em contato com nosso suporte.

Perguntas Gerais

O que é o Cloudflare R2 Media & Static CDN?

O Cloudflare R2 Media & Static CDN é um plugin para WordPress que otimiza seu site enviando arquivos estáticos (JS, CSS, SVG, fontes) e imagens para o serviço Cloudflare R2. O plugin altera automaticamente as URLs para apontar para o CDN, resultando em um site mais rápido e maior economia de largura de banda.

Qual a diferença entre Cloudflare R2 e Amazon S3?

Ambos são serviços de armazenamento de objetos em nuvem, mas o Cloudflare R2 tem duas vantagens principais: (1) não cobra taxas de saída de largura de banda, o que pode economizar muito dinheiro; e (2) entrega arquivos através da rede global da Cloudflare, que está presente em mais de 250 cidades em todo o mundo, proporcionando menor latência. A API do R2 é compatível com a do S3, o que facilita a migração.

Qual a diferença entre as versões gratuita e premium do plugin?

A versão gratuita oferece funcionalidades básicas para enviar arquivos estáticos e imagens para o R2 e servir esses arquivos através de CDN. A versão premium adiciona recursos avançados como otimização de imagens, conversão para WebP e AVIF, reprocessamento de imagens existentes, escaneamento R2, gerenciamento de arquivos, manutenção avançada e suporte prioritário. Para mais detalhes, visite nossa página de Licenciamento.

Quanto custa o plugin e qual é a forma de pagamento?

A versão básica do plugin é gratuita. A versão premium tem diferentes planos de licenciamento (Single Site, Multi-site, Developer e Agency) com pagamento anual. Os preços atuais podem ser consultados em nossa página de preços. Aceitamos pagamentos via cartão de crédito, PayPal e Pix (para clientes brasileiros).

Configuração e Instalação

Quais credenciais do Cloudflare R2 eu preciso?

Você precisará das seguintes credenciais para configurar o plugin:

  • R2 Access Key
  • R2 Secret Key
  • Nome do bucket R2
  • URL do endpoint R2 (formato: https://xxxxx.r2.cloudflarestorage.com)
  • URL do seu CDN (opcional, se você configurou um domínio personalizado)

Como posso obter minhas credenciais R2?

Para obter suas credenciais R2:

  1. Faça login no dashboard da Cloudflare
  2. No menu lateral, vá para R2 > Visão Geral
  3. Clique em Manage R2 API Tokens
  4. Clique em Create API Token
  5. Configure o token com permissões de Leitura e Escrita
  6. Após criar o token, você receberá o Access Key e Secret Key

Como criar um bucket R2?

Para criar um bucket R2:

  1. No dashboard da Cloudflare, vá para R2 > Buckets
  2. Clique em Create Bucket
  3. Digite um nome para o bucket, por exemplo: meu-site-cdn
  4. Selecione a opção de acesso público se deseja que os arquivos sejam acessíveis publicamente
  5. Clique em Create Bucket

Como instalar o AWS SDK manualmente?

Se a instalação automática do AWS SDK falhar, você pode instalá-lo manualmente:

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

Como configurar um domínio personalizado para o CDN?

Para configurar um domínio personalizado:

  1. No dashboard da Cloudflare, vá para R2 > Buckets
  2. Selecione seu bucket
  3. Vá para a aba Settings
  4. Clique em Add custom domain
  5. Siga as instruções para configurar um domínio personalizado
  6. Após configurar o domínio, atualize a URL do CDN nas configurações do plugin

Uso e Funcionalidades

O plugin suporta miniaturas de imagens?

Sim, o plugin pode enviar tanto as imagens originais quanto suas miniaturas para o R2. Nas configurações, você pode escolher quais tamanhos de miniaturas deseja enviar, podendo optar por todas as miniaturas, tamanhos específicos ou apenas as imagens originais.

O plugin faz upload automático de novas imagens?

Sim, o plugin pode ser configurado para enviar automaticamente novas imagens para o R2 quando são adicionadas à biblioteca de mídia do WordPress. Esta opção está disponível na aba "Imagens" e pode ser ativada ou desativada conforme sua preferência.

Quais formatos de imagem são suportados para otimização?

O plugin suporta otimização dos seguintes formatos de imagem: JPEG, PNG, GIF e WebP. Além disso, pode converter esses formatos para WebP e AVIF (na versão premium) para melhor desempenho e economia de largura de banda.

O plugin é compatível com plugins de cache?

Sim, o plugin é compatível com os plugins populares de cache de página como WP Rocket, W3 Total Cache, LiteSpeed Cache, WP Super Cache e outros. Recomendamos limpar o cache após ativar ou desativar o CDN para garantir que as URLs sejam atualizadas corretamente.

Posso usar o plugin sem um domínio personalizado do CDN?

Sim, você pode usar a URL padrão do bucket R2 (formato: xxxxx.r2.cloudflarestorage.com) como seu endpoint de CDN. No entanto, para melhor desempenho e branding, recomendamos configurar um domínio personalizado através do Cloudflare (por exemplo, cdn.seusite.com).

E se alguns navegadores não suportarem WebP ou AVIF?

O plugin utiliza o elemento HTML <picture> ou <img> com srcset para servir o formato de imagem mais adequado para cada navegador. Isso significa que navegadores modernos receberão WebP ou AVIF, enquanto navegadores mais antigos receberão o formato original (JPEG ou PNG). Você pode escolher o método de entrega nas configurações de otimização de imagem.

Desempenho e Otimização

Quanto o plugin pode melhorar a velocidade do meu site?

A melhoria de desempenho varia dependendo de vários fatores, como a qualidade da sua hospedagem atual, a quantidade de imagens e arquivos estáticos no site, e a localização geográfica dos seus visitantes. Em nossos testes, vimos melhorias de 20% a 50% nos tempos de carregamento de página e aumentos significativos na pontuação do Google PageSpeed Insights. Sites com muitas imagens e visitantes internacionais geralmente veem os maiores benefícios.

Qual nível de otimização de imagens é recomendado?

Recomendamos começar com o nível "Balanceado", que oferece um bom equilíbrio entre qualidade de imagem e redução de tamanho. Para a maioria dos sites, isso resultará em uma redução de 40-60% no tamanho das imagens sem perda perceptível de qualidade. Você pode ajustar o nível de otimização conforme necessário com base nos resultados e nas necessidades específicas do seu site.

Qual tamanho de lote é recomendado para uploads?

O tamanho de lote ideal depende dos recursos do seu servidor. Recomendamos:

  • Para arquivos estáticos: 50 arquivos por lote
  • Para imagens: 20 imagens por lote
Se você encontrar erros de tempo limite ou memória durante o processo de upload, reduza o tamanho do lote. Em servidores mais poderosos, você pode aumentar esses valores para acelerar o processo.

Qual a diferença de tamanho entre JPEG, WebP e AVIF?

Em média, comparando com arquivos JPEG de qualidade semelhante:

  • WebP é tipicamente 25-35% menor que JPEG
  • AVIF é tipicamente 40-50% menor que JPEG
AVIF oferece a melhor compressão, mas tem suporte limitado em navegadores mais antigos. WebP tem suporte mais amplo e ainda oferece economia significativa de tamanho. O plugin pode criar ambos os formatos para obter o melhor equilíbrio entre compatibilidade e desempenho.

Solução de Problemas

Por que algumas imagens não aparecem ou estão quebradas após ativar o CDN?

Imagens quebradas após ativar o CDN podem ocorrer por vários motivos:

  • As imagens não foram enviadas para o R2 antes de ativar o CDN
  • Permissões incorretas no bucket R2 (deve ser público)
  • Configurações incorretas de URL do CDN
  • Problemas com o cache do navegador ou de plugin de cache
Tente desativar temporariamente o CDN para verificar se as imagens funcionam normalmente a partir do servidor WordPress. Se funcionarem, o problema está relacionado ao CDN. Verifique as configurações e execute um teste de conexão com o R2.

Estou enfrentando erros de memória durante o upload ou otimização. O que fazer?

Erros de memória são comuns ao processar imagens grandes. Você pode resolver isso de várias maneiras:

  • Reduza o tamanho do lote nas configurações do plugin
  • Aumente o limite de memória do PHP no seu servidor (edite wp-config.php para adicionar: define('WP_MEMORY_LIMIT', '256M');)
  • Se você tem acesso ao php.ini, aumente os valores de memory_limit e max_execution_time
  • Processe as imagens em pequenos lotes distribuídos ao longo do tempo
  • Se estiver otimizando imagens, reduza a qualidade ou desative temporariamente formatos exigentes como AVIF

Existe algum conflito conhecido com outros plugins?

O plugin Cloudflare R2 Media & Static CDN é projetado para ser compatível com a maioria dos plugins WordPress, mas pode haver conflitos com:

  • Outros plugins de CDN que modificam URLs de mídia e arquivos estáticos
  • Alguns plugins de otimização de imagem que também servem WebP/AVIF
  • Plugins que modificam profundamente como o WordPress gerencia arquivos de mídia
Se você encontrar conflitos, tente desativar temporariamente esses plugins ou desativar funcionalidades sobrepostas. Em muitos casos, você pode usar nosso plugin junto com outros de otimização de imagem, desativando apenas os recursos de CDN nesses plugins.

O que fazer quando o upload de arquivos falha?

Se o upload de arquivos para o R2 falhar:

  • Verifique se suas credenciais R2 estão corretas
  • Confirme se o bucket existe e está acessível
  • Verifique se o usuário R2 tem permissões de escrita
  • Reduza o tamanho do lote nas configurações do plugin
  • Verifique os logs de erro do PHP para mensagens mais detalhadas
  • Teste a conexão com o R2 na aba Configurações Gerais
  • Certifique-se de que seu servidor permite conexões externas (algumas hospedagens restringem isso)
Se o problema persistir, consulte a seção Solução de Problemas para mais orientações.

Gerenciamento e Manutenção

O que acontece se eu desinstalar o plugin?

Se você desinstalar o plugin, os seguintes efeitos ocorrerão:

  • Suas imagens e arquivos estáticos permanecerão no Cloudflare R2
  • As URLs voltarão a apontar para seu servidor WordPress
  • Configurações e registros do plugin serão mantidos no banco de dados (a menos que você escolha a opção de remover dados durante a desinstalação)
  • Se você reinstalar o plugin, poderá continuar de onde parou
Você pode excluir manualmente os arquivos do R2 se desejar limpar completamente.

Como excluir arquivos do bucket R2?

Na versão premium do plugin, você pode excluir arquivos do bucket R2 de várias maneiras:

  • Exclusão manual: selecione arquivos específicos para excluir
  • Exclusão automática: configure o plugin para excluir automaticamente arquivos do R2 quando são removidos do WordPress
  • Exclusão em lote: exclua vários arquivos de uma vez com base em critérios como tipo, data ou tamanho
Na versão gratuita, você precisará excluir os arquivos manualmente através do painel da Cloudflare. Para mais detalhes, consulte a página Excluir Arquivos.

Como migrar o plugin para um novo domínio ou site?

Para migrar o plugin para um novo site:

  1. Instale o plugin no novo site
  2. Configure as mesmas credenciais R2 e bucket do site anterior
  3. Se você tem uma licença premium, desative-a no site antigo e ative-a no novo site
  4. Execute um escaneamento R2 no novo site para sincronizar os registros locais com os arquivos no bucket R2
Se você está mudando apenas o domínio do mesmo site, atualize a URL do CDN nas configurações do plugin para refletir o novo domínio.

O que acontece quando minha licença premium expira?

Quando sua licença premium expira:

  • Os recursos premium deixarão de funcionar (otimização de imagens, reprocessamento, escaneamento R2, etc.)
  • As funcionalidades básicas continuarão disponíveis (envio de arquivos para R2, CDN)
  • Todas as imagens e arquivos que já foram otimizados e enviados para o R2 continuarão funcionando normalmente
  • O acesso ao suporte premium será encerrado
Para restaurar o acesso aos recursos premium, basta renovar sua licença a qualquer momento.

Quais tarefas de manutenção são recomendadas?

Para manter o plugin funcionando de forma ideal, recomendamos as seguintes tarefas de manutenção periódicas:

  • Verificar regularmente o status do CDN e a sincronização de arquivos
  • Executar a ferramenta "Verificar Consistência" mensalmente para identificar discrepâncias entre os registros locais e os arquivos no R2
  • Limpar o cache do plugin periodicamente, especialmente após grandes atualizações de conteúdo
  • Verificar se há arquivos órfãos (existentes no R2 mas não no WordPress) e excluí-los se necessário
  • Atualizar o plugin para a versão mais recente quando disponível
  • Renovar sua licença premium antes da expiração para evitar interrupções
A versão premium inclui ferramentas adicionais de manutenção que facilitam essas tarefas.