# 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`).
