Configurações Gerais

A página de Configurações Gerais é o local onde você configura as informações básicas necessárias para conectar o plugin ao Cloudflare R2. Essas configurações são essenciais para o funcionamento do plugin e devem ser definidas antes de utilizar qualquer outra funcionalidade.

Configurações de Credenciais R2

Esta seção permite configurar as informações de acesso à sua conta Cloudflare R2:

Campos Disponíveis

• R2 Access Key: Sua chave de acesso R2 da Cloudflare, necessária para autenticar solicitações ao serviço.
• R2 Secret Key: Sua chave secreta R2 da Cloudflare, utilizada em conjunto com a Access Key para autenticação segura.
• R2 Bucket: O nome do bucket R2 onde os arquivos serão armazenados. Você pode usar um bucket existente ou criar um novo especificamente para o plugin.
• R2 Endpoint URL: A URL do endpoint R2, que geralmente segue o formato: https://xxxxx.r2.cloudflarestorage.com.
• CDN URL: (Opcional) A URL do seu CDN personalizado, se você tiver configurado um domínio personalizado para servir os arquivos. Se não for especificado, o plugin usará a URL padrão do bucket.

Segurança de Credenciais

Teste de Conexão

Após configurar suas credenciais, é importante verificar se a conexão com o Cloudflare R2 está funcionando corretamente:

1. Clique no botão Testar Conexão com R2 na parte inferior da página de configurações.
2. O plugin tentará se conectar ao seu bucket R2 usando as credenciais fornecidas.
3. Se a conexão for bem-sucedida, você verá uma mensagem verde confirmando que o plugin conseguiu se comunicar com o bucket R2.
4. Se ocorrer algum erro, você verá uma mensagem vermelha indicando o problema específico. Os erros comuns incluem credenciais incorretas, bucket inexistente ou problemas de conectividade de rede.

Configurações Avançadas

Além das configurações básicas, a página também oferece opções avançadas para personalizar o comportamento do plugin:

Configurações de URL

• Estrutura de URL: Define como as URLs dos arquivos serão formatadas. Você pode escolher entre:
  • Padrão: Mantém a mesma estrutura de pastas do WordPress.
  • Personalizada: Permite definir um prefixo personalizado para as URLs.
• Prefixo de URL: Se a estrutura personalizada for selecionada, você pode definir um prefixo para todas as URLs (por exemplo, "media" para agrupar todos os arquivos em uma pasta media/).
• Usar datas na estrutura de URL: Se ativado, mantém a estrutura de ano/mês nas URLs (por exemplo, 2025/04/).

Configurações de Cache

• Tempo de Cache: Define por quanto tempo os arquivos serão armazenados em cache pelos navegadores e pelo CDN (em segundos).
• Cabeçalhos Cache-Control: Permite personalizar os cabeçalhos HTTP Cache-Control enviados com os arquivos.
• Invalidação Automática de Cache: Se ativado, o plugin tentará invalidar o cache do CDN quando arquivos forem atualizados.

Configurações de Upload

• Tamanho Máximo de Chunk: Define o tamanho máximo (em MB) para cada chunk durante uploads multipartes. Útil para otimizar o envio de arquivos grandes.
• Tentar Upload Novamente: Número de tentativas para reenviar um arquivo caso ocorra algum erro durante o upload.
• Tempo Limite de Conexão: Tempo máximo (em segundos) que o plugin aguardará por uma resposta do R2 antes de considerar a conexão como falha.

Verificação do Ambiente

O plugin inclui uma ferramenta de verificação de compatibilidade para garantir que seu ambiente atenda a todos os requisitos necessários:

1. Na página de Configurações Gerais, localize a seção Verificação de Compatibilidade.
2. Clique no botão Verificar Ambiente.
3. O plugin realizará uma série de verificações, incluindo:
   • Versão do PHP (mínimo 7.4)
   • Versão do WordPress (mínimo 5.6)
   • Instalação do AWS SDK
   • Extensões PHP necessárias (curl, json, etc.)
   • Permissões de diretório
   • Comunicação com o Cloudflare R2
4. Se algum problema for encontrado, o plugin fornecerá instruções sobre como resolvê-lo.

Configurações de Notificações

O plugin pode enviar notificações sobre eventos importantes, como falhas de upload ou erros de conexão:

• Notificações por E-mail: Se ativado, o plugin enviará e-mails para o administrador quando ocorrerem eventos importantes.
• Eventos para Notificar: Permite selecionar quais tipos de eventos devem gerar notificações (erros críticos, avisos, informações).
• E-mail do Destinatário: Por padrão, usa o e-mail do administrador do WordPress, mas você pode especificar um e-mail diferente.

Salvando as Configurações

Após fazer todas as alterações desejadas nas configurações, não se esqueça de clicar no botão Salvar Configurações Gerais na parte inferior da página. As alterações só serão aplicadas após salvar.

Após salvar as configurações e confirmar que a conexão com o R2 está funcionando corretamente, você pode prosseguir para configurar outras funcionalidades do plugin, como o CDN para Arquivos Estáticos ou Imagens.