Reprocessamento de Imagens

A funcionalidade de Reprocessamento de Imagens permite atualizar imagens existentes no Cloudflare R2 com novas configurações de otimização ou formato, sem a necessidade de reenviar manualmente todas as imagens. Isso é especialmente útil quando você altera suas configurações de otimização ou deseja converter seu acervo de imagens para novos formatos como WebP ou AVIF.

Visão Geral

Existem vários cenários em que o reprocessamento de imagens é útil:

• Quando você altera suas configurações de otimização (por exemplo, mudando de otimização leve para balanceada).
• Quando você decide ativar a conversão para WebP ou AVIF após já ter enviado suas imagens para o R2.
• Quando você quer aplicar novas configurações de redimensionamento a imagens existentes.
• Quando novas versões de bibliotecas de otimização são disponibilizadas com algoritmos de compressão aprimorados.
• Quando você precisa corrigir problemas com imagens específicas que não foram adequadamente otimizadas.

Em vez de excluir todas as imagens e começar do zero, o reprocessamento permite aplicar suas novas configurações a imagens já enviadas, economizando tempo e largura de banda.

Página de Reprocessamento de Imagens

A página de Reprocessamento de Imagens oferece uma interface intuitiva para gerenciar o reprocessamento de seu acervo de imagens:

Opções de Reprocessamento

Antes de iniciar o reprocessamento, você pode configurar diversas opções para controlar quais imagens serão processadas e como:

Selecionar Escopo

• Todas as Imagens: Reprocessa todas as imagens existentes no R2.
• Imagens Específicas: Permite selecionar imagens individuais para reprocessamento.
• Filtrar por Data: Reprocessa apenas imagens adicionadas dentro de um intervalo de datas específico.
• Filtrar por Tamanho: Reprocessa apenas determinados tamanhos de imagem (original, miniaturas específicas, etc.).
• Filtrar por Formato: Reprocessa apenas imagens em formatos específicos (JPEG, PNG, etc.).

Selecionar Formato

• Todos os Formatos: Reprocessa tanto os formatos originais quanto formatos derivados (WebP, AVIF).
• Apenas Originais: Reprocessa apenas as imagens em seu formato original.
• Apenas WebP: Reprocessa ou cria apenas as versões WebP.
• Apenas AVIF: Reprocessa ou cria apenas as versões AVIF.

Opções Avançadas

• Forçar Reprocessamento: Se ativado, reprocessa todas as imagens selecionadas, mesmo que já tenham sido otimizadas anteriormente.
• Manter Versões Antigas: Se ativado, mantém as versões antigas além das novas versões reprocessadas.
• Aplicar Configurações Atuais: Usa as configurações atuais de otimização. Se desativado, permite definir configurações específicas para esta sessão de reprocessamento.
• Prioridade: Define a prioridade do reprocessamento (Alta, Normal, Baixa) para controlar o impacto no servidor.

Depois de selecionar as opções desejadas, clique em Iniciar Reprocessamento para começar.

Processo de Reprocessamento

O reprocessamento de imagens ocorre em várias etapas:

Etapa 1: Escaneamento e Análise

1. O plugin escaneia seu bucket R2 e/ou banco de dados WordPress para identificar imagens que correspondem aos critérios selecionados.
2. Analisa cada imagem para determinar se precisa ser reprocessada com base nas configurações atuais e nas opções selecionadas.
3. Gera uma lista de imagens a serem reprocessadas e estima o tempo necessário para concluir o processo.
4. Exibe um resumo com o número de imagens encontradas, espaço estimado a ser economizado e tempo estimado de processamento.

Etapa 2: Confirmação

Após a análise, você verá uma tela de confirmação com detalhes sobre as imagens a serem reprocessadas:

• Número total de imagens selecionadas para reprocessamento.
• Distribuição por formato (JPEG, PNG, GIF, etc.).
• Tamanho total estimado antes e depois do reprocessamento.
• Tempo estimado para conclusão do processo.

Nesta etapa, você pode revisar os detalhes e clicar em Confirmar e Iniciar para prosseguir ou Voltar para ajustar as opções.

Etapa 3: Processamento em Lote

1. O plugin baixa as imagens do R2 para o servidor WordPress em lotes pequenos.
2. Aplica as configurações de otimização a cada imagem.
3. Gera novas versões em formatos modernos (WebP, AVIF) se solicitado.
4. Envia as imagens reprocessadas de volta para o R2.
5. Atualiza os registros no banco de dados para refletir as novas versões.

Durante o processamento, você verá uma barra de progresso e estatísticas em tempo real:

• Imagens processadas vs. total.
• Tempo decorrido e tempo estimado restante.
• Economia de espaço acumulada.
• Taxa média de redução de tamanho.

Controles de Processamento

Durante o reprocessamento, você tem vários controles disponíveis:

• Pausar/Continuar: Pausa temporariamente o processo ou continua um processo pausado.
• Cancelar: Interrompe completamente o processo (as imagens já processadas permanecem atualizadas).
• Ajustar Velocidade: Controla a velocidade de reprocessamento para equilibrar entre velocidade e carga do servidor.
• Ver Detalhes: Exibe informações detalhadas sobre o lote atual em processamento.

Estratégias de Reprocessamento

Dependendo do tamanho da sua biblioteca de mídia e dos seus objetivos, diferentes estratégias de reprocessamento podem ser mais adequadas:

Reprocessamento Completo

Ideal quando você faz uma mudança significativa nas suas configurações de otimização ou ativa novos formatos:

• Prós: Garante que todas as imagens sejam processadas com as mesmas configurações.
• Contras: Pode levar muito tempo para bibliotecas grandes e consumir mais recursos do servidor.

Reprocessamento Seletivo

Ideal para situações específicas ou para grandes bibliotecas:

• Por Data: Reprocesse imagens mais recentes primeiro, depois imagens mais antigas em lotes.
• Por Uso: Priorize imagens usadas em páginas populares do seu site.
• Por Tamanho: Reprocesse primeiro imagens maiores para obter economia de espaço mais rápida.

Reprocessamento Incremental

Ideal para bibliotecas muito grandes ou servidores com recursos limitados:

• Processa um pequeno lote de imagens diariamente (por exemplo, 100 imagens por dia).
• Configura um cronograma automático para processar imagens regularmente sem intervenção manual.
• Distribui a carga ao longo do tempo para minimizar o impacto no desempenho do servidor.

Monitorando Resultados

Após concluir o reprocessamento, você pode analisar os resultados para verificar a eficácia das novas configurações:

Relatório de Conclusão

O plugin gera um relatório detalhado após cada sessão de reprocessamento:

• Resumo: Número total de imagens processadas, tempo total e economia de espaço.
• Detalhamento por Formato: Estatísticas de redução de tamanho para cada formato (JPEG, PNG, WebP, AVIF).
• Maiores Economias: Lista das imagens que tiveram as maiores reduções de tamanho.
• Problemas Encontrados: Lista de quaisquer imagens que não puderam ser processadas adequadamente, com detalhes sobre os erros.

Comparação Visual

Para verificar a qualidade das imagens reprocessadas:

1. Na biblioteca de mídia, selecione uma imagem reprocessada.
2. Na barra lateral direita, clique em "Comparar Versões".
3. Uma janela modal será aberta mostrando a versão anterior e a nova versão lado a lado.
4. Use as ferramentas de zoom e o controle deslizante para comparar detalhes específicos.

Solução de Problemas de Reprocessamento

Se você encontrar problemas durante o reprocessamento de imagens, aqui estão algumas soluções comuns:

Erros de Memória

Se ocorrerem erros de memória durante o reprocessamento:

• Reduza o tamanho do lote nas configurações (tente 5-10 imagens por lote).
• Aumente o intervalo entre lotes para dar ao servidor tempo para liberar memória.
• Filtre para processar apenas um tamanho de imagem por vez.
• Verifique se o limite de memória do PHP está configurado adequadamente (recomendado: 256MB ou mais).

Tempo Limite Esgotado

Se ocorrerem erros de timeout:

• Reduza o tamanho do lote e aumente o intervalo entre lotes.
• Verifique as configurações de timeout do seu servidor web e PHP.
• Use a opção de reprocessamento incremental com lotes menores.

Problemas com Imagens Específicas

Se algumas imagens não forem reprocessadas corretamente:

• Verifique o log de erros para detalhes específicos sobre as falhas.
• Tente reprocessar manualmente essas imagens com configurações diferentes.
• Verifique se as imagens originais não estão corrompidas ou em formatos não suportados.