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:
- Faça login no dashboard da Cloudflare
- No menu lateral, vá para R2 > Visão Geral
- Clique em Manage R2 API Tokens
- Clique em Create API Token
- Configure o token com permissões de Leitura e Escrita
- Após criar o token, você receberá o Access Key e Secret Key
Como criar um bucket R2?
Para criar um bucket R2:
- No dashboard da Cloudflare, vá para R2 > Buckets
- Clique em Create Bucket
- Digite um nome para o bucket, por exemplo:
meu-site-cdn
- Selecione a opção de acesso público se deseja que os arquivos sejam acessíveis publicamente
- 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:
- Baixe o AWS SDK de https://github.com/aws/aws-sdk-php/releases
- Extraia o arquivo baixado
- Crie uma pasta 'vendor' dentro do diretório do plugin (
wp-content/plugins/r2-assets-cdn/
) - Faça upload da pasta extraída para o diretório 'vendor'
- 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:
- No dashboard da Cloudflare, vá para R2 > Buckets
- Selecione seu bucket
- Vá para a aba Settings
- Clique em Add custom domain
- Siga as instruções para configurar um domínio personalizado
- 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
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
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
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
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)
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
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
Como migrar o plugin para um novo domínio ou site?
Para migrar o plugin para um novo site:
- Instale o plugin no novo site
- Configure as mesmas credenciais R2 e bucket do site anterior
- Se você tem uma licença premium, desative-a no site antigo e ative-a no novo site
- Execute um escaneamento R2 no novo site para sincronizar os registros locais com os arquivos no bucket R2
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
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