Início / Documentação / Instalação

Instalação

A instalação do plugin Cloudflare R2 Media & Static CDN é simples e pode ser feita de duas maneiras diferentes. Escolha o método que for mais conveniente para você.

Método 1: Instalação via Painel WordPress

Este é o método mais simples e recomendado para a maioria dos usuários:

  1. Acesse o painel administrativo do WordPress.
  2. Navegue até Plugins > Adicionar Novo.
  3. Na caixa de pesquisa, digite "Cloudflare R2 Media & Static CDN".
  4. Quando o plugin aparecer nos resultados, clique em Instalar Agora.
  5. Após a instalação ser concluída, clique em Ativar para ativar o plugin.

Nota: Se você não conseguir encontrar o plugin na pesquisa, pode ser porque ele ainda não foi aprovado no repositório oficial do WordPress. Nesse caso, utilize o método de instalação manual.

Método 2: Instalação Manual

Se preferir ou se o método anterior não funcionar, você pode instalar o plugin manualmente:

  1. Baixe o arquivo .zip do plugin no site oficial ou no repositório WordPress.
  2. Acesse o painel administrativo do WordPress.
  3. Navegue até Plugins > Adicionar Novo > Enviar Plugin.
  4. Clique em Escolher arquivo, selecione o arquivo .zip baixado e clique em Instalar Agora.
  5. Após a instalação ser concluída, clique em Ativar Plugin.

Instalação do AWS SDK

O plugin precisa do AWS SDK para PHP para se comunicar com o Cloudflare R2 (que usa a API compatível com S3). Após a ativação do plugin, você verá uma notificação se o SDK não estiver instalado.

Instalação Automática do SDK

Na maioria dos ambientes, o plugin tentará instalar o AWS SDK automaticamente. Se o seu servidor suporta shell_exec(), siga estes passos:

  1. Acesse o menu Cloudflare R2 Media & Static CDN no painel WordPress.
  2. Você verá uma mensagem indicando que o SDK não está instalado.
  3. Clique no botão Instalar AWS SDK Automaticamente.
  4. Aguarde o processo de instalação ser concluído.

Instalação Manual do SDK

Se a instalação automática falhar ou se o seu servidor não suportar shell_exec(), você precisará instalar o SDK manualmente:

Método 1: Via FTP

  1. Baixe o AWS SDK de https://github.com/aws/aws-sdk-php/releases
  2. Extraia o arquivo baixado
  3. Crie uma pasta 'vendor' dentro do diretório do plugin (wp-content/plugins/r2-assets-cdn/)
  4. Faça upload da pasta extraída para o diretório 'vendor'
  5. Certifique-se de que exista um arquivo 'autoload.php' em vendor/

Método 2: Via SSH/Terminal

Se você tiver acesso SSH ao seu servidor, pode instalar o SDK usando o Composer:

cd wp-content/plugins/r2-assets-cdn/
composer require aws/aws-sdk-php

Atenção: A instalação do AWS SDK é um passo obrigatório para o funcionamento do plugin. Sem ele, não será possível conectar-se ao Cloudflare R2.

Verificação da Instalação

Após a instalação e ativação do plugin, verifique se ele foi instalado corretamente:

  1. Acesse o menu Cloudflare R2 Media & Static CDN no painel lateral do WordPress.
  2. Você deverá ver a interface principal do plugin com várias abas.
  3. Na aba Configurações Gerais, execute a ferramenta de verificação de compatibilidade para garantir que seu ambiente atenda a todos os requisitos.

Próximo Passo

Após instalar o plugin com sucesso, o próximo passo é configurar suas credenciais do Cloudflare R2 e começar a usar o plugin. Prossiga para a seção Configuração Inicial para aprender como fazer isso.