Imagens

A funcionalidade de CDN para Imagens permite que você envie todas as imagens da sua biblioteca de mídia do WordPress para o Cloudflare R2 e as sirva a partir do CDN. Isso melhora significativamente o tempo de carregamento das páginas, reduz a carga do seu servidor e economiza largura de banda da sua hospedagem.

Visão Geral

Imagens geralmente representam a maior parte do tráfego de um site WordPress e podem consumir muitos recursos do servidor. Ao servir suas imagens a partir do Cloudflare R2, você aproveita a rede global da Cloudflare para entregar suas imagens mais rapidamente aos visitantes, independentemente da localização deles.

O plugin automatiza todo o processo de envio de imagens para o R2 e modifica as URLs no WordPress para apontar para o CDN. Esse processo é transparente para seus visitantes e não requer nenhuma modificação manual do código.

Página de Imagens

A página de Imagens no painel administrativo do plugin oferece uma visão completa do status do CDN para imagens e ferramentas para gerenciá-lo:

Status do CDN de Imagens

No topo da página, você encontrará um resumo do status atual:

• Status atual: Indica se o CDN para imagens está ativo ou inativo.
• Imagens Enviadas: Mostra o número total de imagens enviadas para o R2.
• Miniaturas Enviadas: Exibe o número de miniaturas enviadas, agrupadas por tamanho.
• Tamanho Total: O espaço total ocupado pelas imagens no R2.
• Último Upload: Data e hora do último processamento de imagens.

Configurações de Imagens

A seção de configurações permite personalizar o comportamento do CDN para imagens:

• Status do CDN: Ativa ou desativa o redirecionamento de URLs para imagens. Mesmo que desativado, as imagens permanecerão no R2.
• Tamanho do Lote: Define o número de imagens a serem processadas em cada lote durante o upload (recomendado: 20). Reduza esse valor se estiver enfrentando problemas de timeout ou memória.
• Intervalo entre Lotes: Tempo de espera (em segundos) entre o processamento de cada lote, para evitar sobrecarregar o servidor.
• Tamanhos de Miniatura: Define quais tamanhos de miniatura devem ser enviados:
  • Todas as miniaturas: Envia todas as miniaturas geradas pelo WordPress e temas.
  • Selecionar tamanhos específicos: Permite escolher quais tamanhos de miniatura enviar.
  • Apenas imagens originais: Envia apenas as imagens originais, sem miniaturas.
• Upload Automático de Miniaturas: Quando ativado, envia automaticamente as miniaturas para o R2 quando novas imagens são adicionadas à biblioteca de mídia.
• Incluir Imagens em Conteúdo: Se ativado, o plugin também procurará por imagens incorporadas no conteúdo de posts e páginas.
• Modificar URLs nos Conteúdos: Altera as URLs de imagens dentro do conteúdo de posts e páginas para apontar para o CDN.

Depois de ajustar as configurações, clique em Salvar Configurações para aplicar as alterações.

Upload de Imagens para R2

Antes de ativar o CDN, você precisa enviar suas imagens para o Cloudflare R2. O plugin automatiza esse processo:

Processo de Upload Inicial

1. Clique no botão Iniciar Upload de Imagens na página de Imagens.
2. O plugin primeiro escaneará sua biblioteca de mídia para identificar todas as imagens e suas miniaturas. Este processo pode levar alguns minutos, dependendo do tamanho da sua biblioteca.
3. Após o escaneamento, você verá uma lista das imagens encontradas e o plugin começará a enviá-las para o R2 em lotes.
4. O progresso do upload será exibido, mostrando:
   • Número de imagens processadas
   • Número de imagens restantes
   • Tempo estimado para conclusão
   • Status atual do lote em processamento
5. Você pode pausar o processo a qualquer momento clicando em Parar Upload.
6. Para continuar um upload pausado, clique em Continuar Upload.

Prioridade de Upload

Por padrão, o plugin prioriza o upload de imagens na seguinte ordem:

1. Imagens em posts/páginas recentes
2. Imagens em posts/páginas publicadas
3. Imagens em rascunhos
4. Outras imagens na biblioteca de mídia

Isso garante que as imagens mais importantes sejam enviadas primeiro, permitindo que você ative o CDN mais rapidamente.

Upload Automático

Além do upload manual inicial, o plugin gerencia automaticamente o envio de novas imagens para o R2:

• Imagens Novas: Quando você adiciona uma nova imagem à biblioteca de mídia, ela é automaticamente enviada para o R2 (se a opção Upload Automático estiver ativada).
• Miniaturas Recriadas: Se você usar plugins que regeneram miniaturas ou alterar os tamanhos de miniatura do seu tema, essas novas miniaturas também serão enviadas automaticamente para o R2.

Ativando o CDN para Imagens

Após concluir o upload inicial das imagens, você pode ativar o CDN para começar a servir suas imagens a partir do Cloudflare R2:

1. Na seção de configurações, defina Status do CDN como Ativo.
2. Clique em Salvar Configurações.
3. Limpe o cache do seu site, caso esteja usando um plugin de cache.

Após ativar o CDN, todas as URLs de imagens em seu site serão automaticamente modificadas para apontar para o CDN. Por exemplo:

# URL original:
https://seusite.com/wp-content/uploads/2025/04/imagem.jpg

# URL com CDN:
https://seu-bucket.r2.cloudflarestorage.com/wp-content/uploads/2025/04/imagem.jpg

Se você configurou um domínio personalizado para o CDN, a URL será modificada para usar esse domínio:

# URL com domínio personalizado:
https://cdn.seusite.com/wp-content/uploads/2025/04/imagem.jpg

Verificando o Funcionamento do CDN

Após ativar o CDN, é importante verificar se as imagens estão sendo corretamente servidas a partir do Cloudflare R2:

1. Visite seu site em uma janela anônima do navegador (para evitar interferência do cache do navegador).
2. Abra as ferramentas de desenvolvimento do navegador (F12 ou botão direito > Inspecionar).
3. Vá para a aba "Rede" (Network) e recarregue a página.
4. Filtre por tipos de arquivo como "image" ou "img".
5. Verifique se as URLs das imagens estão apontando para seu bucket R2 ou domínio personalizado do CDN.

Gerenciamento de Imagens

O plugin oferece várias ferramentas para gerenciar suas imagens no R2:

Status de Upload

Na biblioteca de mídia do WordPress, você verá um indicador de status para cada imagem:

• ✓ Enviada para R2: A imagem e todas as suas miniaturas foram enviadas com sucesso.
• ⚠ Parcialmente Enviada: Algumas miniaturas ainda não foram enviadas.
• ✗ Não Enviada: A imagem ainda não foi enviada para o R2.
• ? Status Desconhecido: O plugin não consegue determinar o status da imagem.

Envio Manual de Imagens Específicas

Você pode enviar manualmente imagens específicas para o R2:

1. Na biblioteca de mídia, selecione uma ou mais imagens.
2. No menu "Ações em Lote", selecione "Enviar para Cloudflare R2".
3. Clique em "Aplicar".
4. O plugin enviará essas imagens para o R2 e exibirá o resultado da operação.

Marcar como Enviado

Em alguns casos, você pode precisar marcar manualmente uma imagem como enviada (por exemplo, se você carregou a imagem diretamente para o R2 por outros meios):

1. Na biblioteca de mídia, selecione uma ou mais imagens.
2. No menu "Ações em Lote", selecione "Marcar como Enviado para R2".
3. Clique em "Aplicar".

Integração com a Biblioteca de Mídia

O plugin se integra perfeitamente à biblioteca de mídia do WordPress:

Upload Automático de Novas Imagens

Quando você faz upload de uma nova imagem para a biblioteca de mídia do WordPress, o plugin:

1. Detecta o upload da nova imagem
2. Aguarda o WordPress gerar todas as miniaturas
3. Envia a imagem original e suas miniaturas para o R2
4. Atualiza o status da imagem no banco de dados

Este processo acontece em segundo plano e não interfere com suas atividades normais de edição.

Exclusão de Imagens

Quando você exclui uma imagem da biblioteca de mídia, o plugin pode opcionalmente excluí-la também do R2:

• Exclusão Automática: Se ativado, o plugin excluirá automaticamente as imagens do R2 quando forem removidas da biblioteca de mídia do WordPress.
• Preservar no R2: Se desativado, as imagens permanecerão no R2 mesmo após serem excluídas do WordPress.