BeamReactor — Guia de introdução #

Version: 1.0 — 2026-09-23 — tradução automática (Claude) de BEAMREACTOR_GETTING_STARTED_FR.md 1.0, não revista

Pré-requisitos #

• PHP 8.3 ou superior
• MySQL / MariaDB
• Acesso FTP ao seu servidor
• phpMyAdmin (ou qualquer cliente SQL)
• Não é necessário Composer, Node nem ferramenta de build

Instalação rápida (5 minutos) #

1. Upload #

Carregue todo o diretório do BeamReactor para o seu servidor web por FTP. É tudo — nenhuma instalação de dependências, nenhuma etapa de build.

2. Base de dados #

Importe o esquema SQL por defeito para a sua base através do phpMyAdmin:

1. Crie uma nova base (ex.: beamreactor)
2. Importe conf/sql_default.sql
3. Configure as credenciais da base em conf/sql.ini.php

3. Configurar conf/cfg.php #

Abra conf/cfg.php e ajuste os seguintes valores de acordo com a sua instalação:

Identidade do site

• $cfg[1] — Nome do site
• $cfg[2] — Ficheiro da página inicial (por defeito: home.php)
• $cfg[9] — Pseudónimo do webmaster
• $cfg[10] — Email do webmaster
• $cfg[11] — Endereços de email de contacto (geral, comercial, técnico, jurídico, noreply)
• $cfg[19] — Descrição do site (usada nas meta tags)
• $cfg[21] — Sufixo da barra de título do navegador
• $cfg[27] — Texto alternativo na barra de título quando um plugin é chamado

Localização

• $cfg[5] — Símbolo da moeda (por defeito: €)
• $cfg[22] — Língua de base (fr, en, pt, etc.)
• $cfg[30] — Desfasamento horário do MySQL (ex.: +1:00) ou FALSE para a hora do servidor
• date_default_timezone_set() — Fuso horário do PHP (por defeito: Europe/Paris)

Segurança (a alterar imediatamente)

• $cfg['security_pepper'] — 64+ caracteres aleatórios, únicos na sua instalação
• $cfg['fake_salt_secret'] — Cadeia hexadecimal de 64 caracteres, única na sua instalação
• $cfg[23] — Chave de cliente (fornecida com a sua licença)

Caminhos (os valores por defeito geralmente servem)

• $cfg[3] — Caminho das skins (por defeito: user/skins)
• $cfg[4] — Caminho dos dados (por defeito: user/data)
• $cfg[6] — Caminho das imagens (por defeito: user/images)
• $cfg[33] — Caminho dos tipos de letra (por defeito: user/fonts)

Informações da empresa (para a faturação / páginas legais)

• $cfg[34] — Número SIRET, morada, telefone
• $cfg[35] — Dados bancários (IBAN, BIC)

Gateways de pagamento (se usar os plugins de comércio eletrónico)

• $cfg[36] — Chaves Stripe e modo (test / live)
• $cfg[37] — Chaves PayPal e modo (sandbox / live)
• $cfg[38] — Configuração do pagamento por cheque

4. Criar a sua conta #

Aceda ao seu site num navegador e registe-se através do formulário normal. Indique o seu email, pseudónimo, nome e palavra-passe.

5. Passar a webmaster #

No phpMyAdmin, abra a tabela users e defina o nível de privilégio da sua conta como 1500 (OVERMIND). Isto dá acesso administrativo total.

A hierarquia de privilégios:

• 0 — USER (por defeito)
• 100 — HIGHUSER
• 500 — MODERATOR
• 1000 — ADMIN
• 1500 — OVERMIND (controlo total)

6. Concluído #

A sua instalação do BeamReactor está online. A partir do painel de administração pode:

• Instalar plugins através do Gestor de pacotes
• Personalizar a sua skin com o Gerador de skins
• Configurar cada plugin através dos seus parâmetros
• Começar a criar conteúdo

Instalação guiada (chave de licença) #

Se comprou uma licença com uma chave de registo, pode usar o script de instalação automatizado em vez da configuração manual:

1. Carregue o BeamReactor por FTP
2. Execute o script de instalação no seu navegador
3. Introduza as suas informações (email, pseudónimo, nome) e a sua chave de registo (UUID)
4. Crie a sua palavra-passe

O script trata automaticamente da instalação da base de dados, das bibliotecas, da skin por defeito (css1), da área de membros e dos includes de segurança. Guia-o através de um percurso sequencial:

1. Gestor de pacotes — Selecione e instale os plugins de que precisa a partir do catálogo. Os pacotes instalam-se automaticamente (descompressão em /plugins/)
2. Gerador de skins — Crie a sua skin e os seus botões por defeito. Os botões são guardados no skinconfig, os estilos em CSS
3. Sistema pronto

Durante este percurso, o login_success é substituído temporariamente pelo script de instalação para manter o utilizador no fluxo até a configuração estar concluída.

Estrutura dos ficheiros #

/conf/
  cfg.php			   # Configuração principal
  sql.ini.php		   # Credenciais da base de dados
  sql_default.sql	   # Esquema por defeito
/lib/				   # Bibliotecas do motor
/plugins/			   # Diretório de plugins (uma pasta por plugin)
/widgets/			   # Widgets da página inicial
/user/
  /data/				# Dados do utilizador, ficheiros MD
  /skins/			   # Ficheiros de skin
  /images/			  # Imagens carregadas
  /fonts/			   # Ficheiros de tipos de letra
/members/			   # Área de membros
/javascript/			# Bibliotecas JS (jQuery, dialogs)

Próximos passos #

• Arquitetura de plugins — Funcionamento dos plugins
• Documentação do Sanitizer — Sistema de validação das entradas
• Guia SQL — Camada de abstração da base de dados
• Guia de widgets — Sistema de widgets na página inicial