Início / Documentação / Escaneamento R2

Escaneamento R2

Recurso Premium

O Escaneamento R2 é um recurso exclusivo da versão premium do Codirun R2 Media & Static CDN. Para utilizar esta funcionalidade, você precisa adquirir uma licença premium.

A funcionalidade de Escaneamento R2 permite examinar diretamente o conteúdo do seu bucket Cloudflare R2, identificar arquivos, importar arquivos existentes para o WordPress e sincronizar os registros locais com os arquivos reais armazenados no R2. Esta é uma ferramenta poderosa para gerenciamento avançado e solução de problemas, especialmente útil se você já tinha arquivos no R2 antes de instalar o plugin ou se realizou modificações diretas no bucket.

Visão Geral

O Escaneamento R2 oferece uma visão abrangente do seu bucket R2, permitindo:

  • Listar todos os arquivos presentes no bucket R2
  • Identificar arquivos que não estão registrados no WordPress
  • Importar arquivos existentes no R2 para a biblioteca de mídia do WordPress
  • Sincronizar registros locais com o conteúdo real do bucket
  • Identificar e corrigir inconsistências entre R2 e WordPress
  • Analisar o uso de espaço e distribuição de arquivos por tipo

Esta ferramenta é extremamente útil em vários cenários, como:

  • Migração para o plugin a partir de outro sistema que já usava R2
  • Recuperação após falha de banco de dados ou problemas com registros do WordPress
  • Auditoria de arquivos e uso de espaço no R2
  • Importação de arquivos adicionados manualmente ao R2
  • Identificação de arquivos órfãos que podem ser excluídos para economizar espaço

Importação de Arquivos

A ferramenta de importação permite buscar e trazer de volta para o WordPress imagens que você já tem no R2, mas que não estão registradas na biblioteca de mídia:

Filtragem por Formato

Você pode filtrar arquivos no R2 por formato:

  • Todas as Imagens: Exibe todas as imagens independente do formato
  • Formatos Padrão: Apenas JPG, PNG e GIF
  • Apenas WebP: Arquivos no formato moderno WebP
  • Apenas AVIF: Arquivos no formato mais recente AVIF

Após selecionar o formato, o plugin buscará os arquivos correspondentes no seu bucket R2, exibindo-os em uma grade visual para fácil seleção.

Processo de Importação

  1. Selecione os arquivos que deseja importar na grade de resultados
  2. Clique no botão "Importar Arquivos Selecionados"
  3. Os arquivos serão baixados temporariamente do R2 e importados para a biblioteca de mídia do WordPress
  4. Após a importação, os arquivos estarão disponíveis normalmente na sua biblioteca de mídia

Importante: Para buckets com muitas imagens, é recomendável fazer a importação em pequenos lotes para evitar timeout ou uso excessivo de memória.

Escaneamento Completo do Bucket

O escaneamento completo analisa todos os arquivos no seu bucket R2 e oferece estatísticas detalhadas:

Métodos de Escaneamento

  • Escaneamento Progressivo: Recomendado para buckets grandes, mostra o progresso em tempo real
  • Escaneamento Direto: Mais rápido para buckets pequenos, mas pode causar timeout em buckets grandes

Resultados do Escaneamento

O escaneamento fornece informações completas sobre o bucket:

  • Total de arquivos e espaço utilizado
  • Estatísticas de arquivos estáticos por extensão (JS, CSS, SVG, etc.)
  • Estatísticas de imagens por formato (JPG, PNG, WebP, AVIF)
  • Separação entre imagens originais e miniaturas

Sincronização de Registros

O plugin compara os arquivos encontrados no R2 com os registros locais do WordPress, identificando discrepâncias:

Tipos de Discrepâncias

  • Arquivos no R2 não registrados no WordPress: Arquivos que existem no bucket mas não têm registros correspondentes no WordPress
  • Registros no WordPress não encontrados no R2: Registros locais que apontam para arquivos inexistentes no R2

Opções de Sincronização

Para corrigir as discrepâncias encontradas, você pode:

  • Adicionar arquivos encontrados no R2 aos registros locais: Registra no WordPress os arquivos que estão no R2 mas não estão registrados
  • Remover dos registros locais arquivos que não existem no R2: Limpa registros órfãos que apontam para arquivos inexistentes

Atenção: A sincronização apenas atualiza os registros locais, não exclui arquivos físicos do R2. Para exclusão de arquivos, utilize a funcionalidade "Excluir Arquivos".

Dicas para Uso Eficiente

Para obter os melhores resultados com o Escaneamento R2:

  • Buckets grandes: Use o método progressivo e filtre por formato para melhor desempenho
  • Importação de imagens: Importe em lotes pequenos (até 50 arquivos por vez)
  • Sincronização: Mantenha ambas as opções de sincronização ativadas para garantir consistência completa
  • Organização: Use o filtro de arquivos para encontrar imagens específicas