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.

Modos de Processamento

O plugin oferece dois modos de processamento para atender a diferentes necessidades:

Processamento em Segundo Plano

• Continua executando mesmo ao fechar a página
• Ideal para sites com muitas imagens
• Menor impacto no desempenho do site
• Pode ser pausado e retomado a qualquer momento

Processamento Normal

• Exibe atualizações em tempo real
• Você precisa manter a página aberta
• Melhor para conjuntos menores de imagens
• Mais adequado para monitoramento direto

Processo de Reprocessamento

O reprocessamento de imagens ocorre em várias etapas:

Etapa 1: Configuração

1. Selecione o modo de processamento (Normal ou Segundo Plano)
2. Configure as opções de conversão (WebP, AVIF)
3. Defina o tamanho do lote (número de imagens processadas por vez)
4. Inicie o reprocessamento

Etapa 2: Processamento

1. O plugin obtém a lista de imagens na biblioteca de mídia do WordPress
2. Processa as imagens em lotes, conforme o tamanho definido nas configurações
3. Reprocessa a imagem original e todas as miniaturas associadas
4. Aplica as configurações de otimização a cada imagem
5. Gera novas versões em formatos modernos (WebP, AVIF) se selecionado
6. Envia as imagens reprocessadas de volta para o R2
7. Atualiza os registros no banco de dados para refletir as novas versões

Etapa 3: Acompanhamento

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

• Imagens processadas vs. total
• Progresso geral em porcentagem
• Status atual (Executando/Pausado)

Controles de Processamento

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

• Continuar Reprocessamento: Processa o próximo lote de imagens.
• Pausar: Interrompe temporariamente o processo. Você pode continuar mais tarde.
• Parar Reprocessamento: Cancela completamente o processo. As imagens já processadas permanecem atualizadas.

Upload Manual de Imagens

Além do reprocessamento em lote, o plugin permite selecionar imagens específicas para enviar ao R2, em vez de processar toda a biblioteca.

Esta funcionalidade é útil quando:

• Você precisa atualizar apenas algumas imagens específicas
• Você quer testar novas configurações antes de aplicá-las em lote
• Você identificou problemas com imagens específicas

Para usar o upload manual:

1. Clique em "Selecionar Imagens" para abrir a biblioteca de mídia
2. Escolha as imagens que deseja reprocessar
3. Configure as opções de conversão (WebP, AVIF)
4. Clique em "Iniciar Upload das Imagens Selecionadas"

Configurações de Reprocessamento

Você pode personalizar o reprocessamento de imagens através das seguintes configurações:

• Tamanho do Lote: Número de imagens reprocessadas por lote (recomendado: 20)
• Forçar conversão para WebP: Gera versões WebP das imagens para reduzir o tamanho dos arquivos
• Forçar conversão para AVIF: Gera versões AVIF das imagens para compressão ainda maior

Estas configurações são acessíveis na seção "Configurações de Reprocessamento" na aba de Reprocessamento de Imagens.

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).
• Use o modo de processamento em segundo plano para reduzir o impacto no servidor.
• Verifique se o limite de memória do PHP está configurado adequadamente (recomendado: 256MB ou mais).

Processo Lento

Se o reprocessamento estiver muito lento:

• Reduza o tamanho do lote para diminuir a carga no servidor.
• Desative temporariamente a conversão para AVIF, pois requer mais recursos de processamento.
• Verifique se há outros processos intensivos rodando no servidor.

Imagens Não Aparecem Após Reprocessamento

Se as imagens não estiverem aparecendo corretamente após o reprocessamento:

• Verifique se o CDN está configurado corretamente nas configurações do plugin.
• Limpe o cache do seu site e do navegador.
• Verifique se as permissões no bucket R2 estão configuradas corretamente.