BeamReactor — Guide de démarrage #

Prérequis #

• PHP 8.3 ou supérieur
• MySQL / MariaDB
• Accès FTP à votre serveur
• phpMyAdmin (ou tout client SQL)
• Ni Composer, ni Node, ni outil de build requis

Installation rapide (5 minutes) #

1. Upload #

Uploadez l'intégralité du répertoire BeamReactor sur votre serveur web par FTP. C'est tout — aucune installation de dépendances, aucune étape de build.

2. Base de données #

Importez le schéma SQL par défaut dans votre base via phpMyAdmin :

1. Créez une nouvelle base (ex : `beamreactor`)

2. Importez `conf/sql_default.sql`

3. Configurez vos identifiants de base dans `conf/sql.ini.php`

3. Configurer `conf/cfg.php` #

Ouvrez `conf/cfg.php` et ajustez les valeurs suivantes selon votre installation :

Identité du site

• `$cfg[1]` — Nom du site
• `$cfg[2]` — Fichier d'accueil (défaut : `home.php`)
• `$cfg[9]` — Pseudo du webmaster
• `$cfg[10]` — Email du webmaster
• `$cfg[11]` — Adresses email de contact (général, commercial, technique, légal, noreply)
• `$cfg[19]` — Description du site (utilisée dans les meta tags)
• `$cfg[21]` — Suffixe de la barre de titre du navigateur
• `$cfg[27]` — Texte de repli dans la barre de titre quand un plugin est appelé

Localisation

• `$cfg[5]` — Symbole de devise (défaut : `€`)
• `$cfg[22]` — Langue de base (`fr`, `en`, etc.)
• `$cfg[30]` — Décalage horaire MySQL (ex : `+1:00`) ou `FALSE` pour l'heure serveur
• `date_default_timezone_set()` — Fuseau horaire PHP (défaut : `Europe/Paris`)

Sécurité (à changer immédiatement)

• `$cfg['security_pepper']` — 64+ caractères aléatoires, uniques à votre installation
• `$cfg['fake_salt_secret']` — Chaîne hexadécimale de 64 caractères, unique à votre installation
• `$cfg[23]` — Clé client (fournie avec votre licence)

Chemins (les défauts conviennent généralement)

• `$cfg[3]` — Chemin des skins (défaut : `user/skins`)
• `$cfg[4]` — Chemin des données (défaut : `user/data`)
• `$cfg[6]` — Chemin des images (défaut : `user/images`)
• `$cfg[33]` — Chemin des polices (défaut : `user/fonts`)

Informations entreprise (pour la facturation / pages légales)

• `$cfg[34]` — Numéro SIRET, adresse, téléphone
• `$cfg[35]` — Coordonnées bancaires (IBAN, BIC)

Passerelles de paiement (si utilisation des plugins e-commerce)

• `$cfg[36]` — Clés Stripe et mode (`test` / `live`)
• `$cfg[37]` — Clés PayPal et mode (`sandbox` / `live`)
• `$cfg[38]` — Configuration paiement par chèque

4. Créer votre compte #

Accédez à votre site dans un navigateur et inscrivez-vous via le formulaire standard. Renseignez votre email, pseudo, nom et mot de passe.

5. Passer en webmaster #

Dans phpMyAdmin, ouvrez la table `users` et mettez le niveau de privilège de votre compte à `1500` (OVERMIND). Cela donne l'accès administratif complet.

La hiérarchie des privilèges :

• `0` — USER (défaut)
• `100` — HIGHUSER
• `500` — MODERATOR
• `1000` — ADMIN
• `1500` — OVERMIND (contrôle total)

6. Terminé #

Votre installation BeamReactor est en ligne. Depuis le panneau d'administration vous pouvez :

• Installer des plugins via le Gestionnaire de paquets
• Personnaliser votre skin avec le Générateur de skin
• Configurer chaque plugin via ses paramètres
• Commencer à créer du contenu

Installation guidée (clé de licence) #

Si vous avez acheté une licence avec une clé d'enregistrement, vous pouvez utiliser le script d'installation automatisé au lieu de la configuration manuelle :

1. Uploadez BeamReactor par FTP

2. Lancez le script d'installation dans votre navigateur

3. Entrez vos informations (email, pseudo, nom) et votre clé d'enregistrement (UUID)

4. Créez votre mot de passe

Le script prend en charge l'installation de la base de données, des librairies, de la skin par défaut (css1), de la zone membres et des includes de sécurité automatiquement. Il vous guide à travers un parcours séquentiel :

1. Gestionnaire de paquets — Sélectionnez et installez les plugins dont vous avez besoin depuis le catalogue. Les paquets s'installent automatiquement (décompression dans `/plugins/`)

2. Générateur de skin — Créez votre skin et vos boutons par défaut. Les boutons sont sauvés dans skinconfig, les styles en CSS

3. Système prêt

Pendant ce parcours, `login_success` est temporairement remplacé par le script d'installation pour maintenir l'utilisateur dans le flux jusqu'à la complétion de la configuration.

Structure des fichiers #

/conf/
  cfg.php               # Configuration principale
  sql.ini.php           # Identifiants de base de données
  sql_default.sql       # Schéma par défaut
/lib/                   # Librairies du moteur
/plugins/               # Répertoire plugins (un dossier par plugin)
/widgets/               # Widgets de page d'accueil
/user/
  /data/                # Données utilisateur, fichiers MD
  /skins/               # Fichiers de skin
  /images/              # Images uploadées
  /fonts/               # Fichiers de polices
/members/               # Zone membres
/javascript/            # Librairies JS (jQuery, dialogs)

Étapes suivantes #

• Architecture Plugin — Fonctionnement des plugins
• Documentation Sanitizer — Système de validation des entrées
• Guide SQL — Couche d'abstraction base de données
• Guide Widgets — Système de widgets en page d'accueil