# Addon modules — 30 modules

Un seul addon, 30 modules indépendants, activables un par un depuis **Admin → Modules** (`/admin/blhost/modules`). Chaque module a son interrupteur et ses champs : on enregistre module par module.

Aucun rebuild, aucune migration : les réglages vivent dans la table `settings` sous `blhost:m:*`. Un module désactivé disparaît complètement (pages en 404, bandeaux et liens retirés).

## Pages publiques

| Module | URL | Contenu |
| --- | --- | --- |
| FAQ | `/faq` | Questions/réponses en accordéon, ligne de contact |
| Règlement | `/reglement` | Règles d'utilisation |
| Grille tarifaire | `/tarifs` | Tableau à trois colonnes |
| Support | `/support` | Canaux de contact et horaires |
| Engagements | `/sla` | Disponibilité et délais de réponse |
| Remboursement | `/remboursement` | Conditions de remboursement |
| Journal des mises à jour | `/changelog` | Nouveautés et correctifs |
| Équipe | `/equipe` | Membres et rôles |
| Partenaires | `/partenaires` | Partenaires et hébergeurs |
| Tutoriels | `/tutoriels` | Guides de démarrage |
| Documentation | `/documentation` | Liens vers la doc technique |
| Recrutement | `/recrutement` | Postes ouverts et candidature |

Les pages activées apparaissent dans un bandeau d'onglets commun : le visiteur passe de l'une à l'autre sans revenir au panel.

## Bandeaux et injections

| Module | Effet |
| --- | --- |
| Bandeau de maintenance | Barre en haut de toutes les pages (message, créneau, couleur) |
| Bandeau cookies | Mention cookies, bouton mémorisé dans le navigateur |
| Message de connexion | Encadré limité aux pages `/auth/*` |
| Pied de page | Copyright et liens, pastille discrète en bas à droite |
| Métadonnées | `description`, Open Graph, image de partage |
| Favicon | Icône du panel et icône iOS |

## Apparence

| Module | Effet |
| --- | --- |
| Couleurs du thème | Surcharge `--bl-brand`, `--bl-danger`, `--bl-ink` |
| Police | Famille CSS et feuille de style webfont |
| CSS personnalisé | Feuille de style additionnelle |
| JavaScript personnalisé | Script additionnel en fin de page |

## Administration

| Module | Emplacement |
| --- | --- |
| Statistiques du panel | `/admin/blhost/modules/stats` |
| Recherche rapide | `/admin/blhost/modules/recherche` |
| État technique | `/health` (sonde JSON : état public, détail avec jeton ou session admin) |
| Sauvegardes | `/admin/blhost/modules/sauvegardes` |
| Activité récente | `/admin/blhost/modules/activite` |
| Alertes système | Bandeau admin : disque au-delà du seuil, nœuds en maintenance |
| Serveurs en anomalie | `/admin/blhost/modules/suspendus` |
| Raccourcis admin | Liens rapides en haut du tableau de bord admin |

## Sonde `/health`

```
curl -s https://panel.exemple.fr/health
{"status":"ok"}
```

La réponse anonyme se limite à `status` (200, ou 503 si un contrôle échoue) : ni version, ni espace disque. Le détail — version, contrôles base/cache/stockage, disque — n'est renvoyé qu'à un **administrateur connecté** ou à un appelant qui présente le **jeton de supervision** (champ du module, en `?token=…` ou en-tête `X-BLHost-Health-Token`).

```
curl -s -H "X-BLHost-Health-Token: <jeton>" https://panel.exemple.fr/health
```

Les réponses sont envoyées en `no-store` avec `X-Robots-Tag: noindex`. Laisser le jeton vide garde la sonde utilisable pour un simple contrôle de disponibilité.

## Mise en forme

- une **ligne vide** sépare deux paragraphes ;
- une ligne commençant par `- ` devient une puce ;
- les listes à colonnes utilisent `|` : `Label | URL | Description` ;
- tout le texte est échappé ; seuls les modules CSS/JS injectent du code, et ils sont réservés aux administrateurs.

## Installation

```
cd blhost-theme/addons/modules && sh install.sh
```

## Contenu de départ

```
cd blhost-theme/addons/modules && sh install.sh --seed
```

Active les 30 modules avec une première version française de chaque texte : pages publiques, bandeaux, métadonnées, favicon, couleurs et raccourcis d'administration. Sans `--seed`, les modules restent inactifs et le panel ne change pas.

Le seeder est idempotent : il ignore les modules déjà configurés. `php seed.php /var/www/pterodactyl --force` réécrit tout.

Le contenu de départ est volontairement neutre : les tarifs sont « Sur devis », aucune adresse de support n'est publiée et les fiches de l'équipe n'exposent aucune coordonnée. Complétez ces champs depuis **Admin → Modules**.

## Désinstallation

```
sh install.sh --uninstall
```

Retire les routes, les trois `@include` ajoutés au wrapper et les fichiers de l'addon (sauvegardes dans `storage/app/blhost-modules-backup`). Les réglages restent en base : réinstaller retrouve la configuration.

## Limites

- `/health` est public par conception (aucun nom d'hôte, chemin ou secret) ; le désactiver retire l'URL ;
- le pied de page est une pastille fixe : elle ne recouvre pas la console des serveurs ;
- les modules CSS/JS exécutent le code saisi, ils sont donc réservés aux administrateurs du panel.
