Documentation

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 (JSON public)
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

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.

Les tarifs, adresses e-mail et liens du contenu de départ sont des exemples : ajustez-les 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.