Documentation

Addon annonce & liens

Deux réglages d'ambiance pour le panel :

  • un bandeau d'annonce en haut de toutes les pages (panel et connexion) ;
  • des liens utiles (Discord, statut, documentation…) sous le formulaire de connexion.

Installation

cd blhost-theme/addons/extras && sh install.sh

Réglage

Page Admin → Annonce & liens (/admin/blhost/extras) :

Champ Effet
Afficher le bandeau active / désactive le bandeau
Message 300 caractères max ; vide = aucun bandeau
Niveau information (violet), succès (vert), avertissement (orange)
Liens une ligne par lien, Libellé \| https://url, 8 maximum

Tout est stocké dans la table settings (blhost:announce:*, blhost:links).

Un lien mal formé est refusé avec le numéro de ligne concerné : format attendu, URL sans http(s)://, ou libellé de plus de 40 caractères.

Où ça s'affiche

  • le bandeau est rendu côté serveur (aucun JavaScript requis) ;
  • sur les pages d'authentification il est fixé en haut de la fenêtre, pour ne pas pousser la carte de connexion sous le pli ; dans le panel il reste dans le flux ;
  • les liens sont rendus côté serveur puis déplacés dans la carte de connexion par blhost-extras.js (ils restent masqués si le script ne tourne pas) ;
  • une entrée « Annonce & liens » est ajoutée à la barre latérale de l'admin, en clonant le lien Settings du panel.

Sécurité

  • accès réservé aux administrateurs (middleware du panel) ;
  • message et libellés échappés par Blade, jamais injectés en HTML brut ;
  • seules les URL http(s):// avec un hôte valide sont acceptées, ouvertes en noopener noreferrer ;
  • aucune écriture hors de la table settings.

Désinstallation

sh install.sh --uninstall

Retire le bloc de routes, l'@include du bandeau, les balises <script> et les fichiers de l'addon (sauvegardes dans storage/app/blhost-extras-backup).