Escaneamento R2

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

Página de Escaneamento R2

A página de Escaneamento R2 oferece uma interface intuitiva para interagir com seu bucket R2:

Iniciar Escaneamento

Para começar a explorar o conteúdo do seu bucket R2:

1. Clique no botão Iniciar Escaneamento.
2. Configure as opções de escaneamento:
   • Profundidade: Escolha entre escaneamento rápido (apenas metadados) ou completo (também verifica conteúdo).
   • Escopo: Escaneie todo o bucket ou apenas pastas específicas.
   • Filtros: Limite o escaneamento por tipo de arquivo, tamanho ou data de upload.
   • Comparação: Ative para comparar automaticamente os resultados com registros locais.
3. Clique em Iniciar para começar o escaneamento.

O plugin iniciará o escaneamento do bucket R2, exibindo o progresso em tempo real. Dependendo do tamanho do bucket e das opções selecionadas, este processo pode levar de alguns minutos a várias horas.

Resultados do Escaneamento

Após a conclusão do escaneamento, você verá um relatório detalhado:

• Visão Geral: Resumo do conteúdo do bucket, incluindo número total de arquivos, espaço usado e distribuição por tipo de arquivo.
• Estrutura do Bucket: Visualização hierárquica da estrutura de pastas do bucket.
• Lista de Arquivos: Tabela detalhada de todos os arquivos encontrados, com informações como tamanho, tipo, data de upload e status no WordPress.
• Análise de Comparação: Se a opção de comparação foi ativada, mostra a relação entre os arquivos encontrados e os registros locais do WordPress.

A lista de arquivos é interativa e permite várias ações:

• Visualizar detalhes completos de cada arquivo
• Visualizar prévia de imagens e outros arquivos compatíveis
• Filtrar e ordenar a lista por diversos critérios
• Selecionar arquivos para ações em lote
• Baixar arquivos diretamente do R2

Sincronização de Registros

Uma das principais funcionalidades do Escaneamento R2 é a capacidade de sincronizar os registros locais do WordPress com o conteúdo real do bucket R2:

Análise de Sincronização

Após um escaneamento com a opção de comparação ativada, você verá uma análise de sincronização com estas categorias:

• Sincronizados: Arquivos que existem tanto no R2 quanto nos registros do WordPress, com metadados correspondentes.
• Apenas no R2: Arquivos encontrados no bucket R2, mas sem registros correspondentes no WordPress.
• Apenas no WordPress: Registros locais que apontam para arquivos não encontrados no R2.
• Metadados Diferentes: Arquivos que existem em ambos os lugares, mas com discrepâncias nos metadados (tamanho, hash, etc.).

Opções de Sincronização

O plugin oferece várias opções para resolver as discrepâncias identificadas:

1. Clique no botão Sincronizar Registros.
2. Selecione quais categorias de discrepância você deseja resolver:
   • Importar para WordPress: Cria registros locais para arquivos encontrados apenas no R2.
   • Enviar para R2: Envia para o R2 arquivos que existem apenas no WordPress.
   • Atualizar Metadados: Corrige discrepâncias de metadados entre R2 e WordPress.
   • Remover Registros Órfãos: Exclui registros locais que apontam para arquivos inexistentes no R2.
   • Limpar R2: Remove do R2 arquivos que não têm registros correspondentes no WordPress.
3. Configure opções adicionais para cada categoria, como manipulação de miniaturas ou versões alternativas.
4. Clique em Iniciar Sincronização para aplicar as ações selecionadas.

Importação de Arquivos do R2

Uma funcionalidade poderosa do Escaneamento R2 é a capacidade de importar arquivos existentes no R2 para a biblioteca de mídia do WordPress:

Processo de Importação

1. Após o escaneamento, selecione os arquivos que deseja importar na lista de "Apenas no R2".
2. Clique no botão Importar para WordPress.
3. Configure as opções de importação:
   • Detecção de Imagens: Ativa a detecção automática de dimensões e outros metadados de imagem.
   • Geração de Miniaturas: Gera automaticamente miniaturas WordPress para imagens importadas.
   • Associação a Posts: Tenta associar os arquivos importados a posts/páginas existentes com base nos nomes de arquivo.
   • Importar Estrutura: Mantém a estrutura de pastas original durante a importação.
4. Clique em Iniciar Importação para começar o processo.

O plugin processará os arquivos selecionados em lotes, baixando-os temporariamente do R2 (quando necessário para gerar miniaturas), criando registros na biblioteca de mídia do WordPress e associando os arquivos aos registros correspondentes no plugin.

Importação Inteligente

O plugin tenta identificar automaticamente informações importantes durante a importação:

• Detecção de Miniaturas: Identifica grupos de arquivos que parecem ser uma imagem original e suas miniaturas com base em padrões de nome.
• Reconhecimento de Formato: Identifica versões alternativas do mesmo arquivo em diferentes formatos (WebP, AVIF, etc.).
• Extração de Metadados: Extrai informações como título, legenda e descrição de metadados incorporados nos arquivos.
• Organização em Pastas: Sugere uma organização lógica baseada na estrutura de pastas do R2.

Você pode revisar e ajustar estas detecções automáticas antes de finalizar a importação.

Análise Avançada do Bucket

Além das funcionalidades básicas de escaneamento e sincronização, o plugin oferece ferramentas para análise detalhada do conteúdo do seu bucket R2:

Distribuição de Armazenamento

Visualize como seu espaço de armazenamento está sendo utilizado:

• Por Tipo de Arquivo: Gráfico mostrando a distribuição de espaço entre diferentes tipos de arquivo (imagens, JS, CSS, etc.).
• Por Formato de Imagem: Para buckets com muitas imagens, mostra a distribuição entre JPEG, PNG, WebP, AVIF, etc.
• Por Tamanho: Identifica os maiores arquivos e pastas que consomem mais espaço.
• Por Data: Analisa o crescimento do uso de armazenamento ao longo do tempo.

Análise de Redundância

Identifica oportunidades para otimizar o armazenamento:

• Arquivos Duplicados: Encontra arquivos idênticos armazenados em diferentes locais.
• Versões Similares: Identifica imagens muito similares que podem ser consolidadas.
• Arquivos Temporários: Detecta arquivos temporários ou parciais que podem ser removidos.
• Conteúdo Redundante: Analisa se há excesso de versões alternativas do mesmo conteúdo.

Verificação de Integridade

Verifica a integridade dos arquivos no bucket:

• Verificação de Checksums: Garante que os arquivos não foram corrompidos.
• Validação de Formato: Verifica se os arquivos correspondem realmente ao tipo declarado.
• Verificação de Links: Identifica referências quebradas entre arquivos relacionados.
• Verificação de Permissões: Garante que as permissões de acesso estão configuradas corretamente.

Ações em Lote no R2

O Escaneamento R2 permite realizar várias ações em lote diretamente nos arquivos do bucket:

Operações Disponíveis

• Download em Lote: Baixa múltiplos arquivos selecionados em um arquivo ZIP.
• Migrar Arquivos: Move arquivos entre pastas ou para outro bucket.
• Atualizar Metadados: Modifica metadados como tipo de conteúdo, cabeçalhos de cache, etc.
• Definir ACL: Atualiza permissões de acesso para arquivos selecionados.
• Regenerar URLs: Atualiza URLs no WordPress para arquivos selecionados (útil após reorganização).
• Exclusão em Lote: Remove múltiplos arquivos selecionados do bucket R2.

Para executar uma ação em lote:

1. Na lista de arquivos, selecione os arquivos desejados usando as caixas de seleção.
2. No menu suspenso "Ações em Lote", selecione a operação desejada.
3. Configure quaisquer opções específicas para a operação selecionada.
4. Clique em "Aplicar" para executar a ação nos arquivos selecionados.

Escaneamento Programado

Para manter seus registros consistentemente sincronizados, você pode configurar escaneamentos automáticos:

Configuração de Escaneamento Automático

1. Na página de Escaneamento R2, localize a seção "Escaneamento Programado".
2. Ative a opção Habilitar Escaneamento Automático.
3. Configure as opções:
   • Frequência: Defina com que frequência o escaneamento deve ocorrer (diário, semanal, mensal).
   • Escopo: Configure um escaneamento completo ou limitado a áreas específicas.
   • Sincronização Automática: Se ativado, aplica automaticamente ações de sincronização com base em regras predefinidas.
   • Notificações: Receba relatórios por e-mail após cada escaneamento automático.
4. Clique em Salvar Configurações para aplicar as alterações.