Plugins téléphones
Plugins téléphones
La page Plugins de provisioning (/admin/system/plugins) gère les pilotes constructeurs (« plugins ») utilisés par MaxiPBX pour provisionner les téléphones IP. Ces plugins contiennent les modèles de configuration et les firmwares propres à chaque marque.
Les plugins sont globaux au serveur : ils sont partagés par tous les clients. Installer ou désinstaller un plugin affecte tous les téléphones de la marque concernée.
En-tête
- Titre : « Plugins de provisioning ».
- Sous-titre dynamique : « Pilotes constructeurs pour le provisioning. Globaux au serveur — partagés par tous les clients. {n} installés · {n} disponibles. » (les compteurs reflètent les listes filtrées).
Deux boutons d'action :
| Bouton | Effet |
|---|---|
| Rafraîchir le catalogue | Met à jour le catalogue distant des plugins disponibles. L'icône tourne pendant l'opération. |
| Tout installer ({n}) | Installe en masse tous les plugins de téléphones (voir plus bas). Désactivé s'il n'y a aucun candidat. |
Filtre
Un champ de recherche (icône loupe) permet de filtrer les listes par identifiant de plugin. Placeholder : « Filtrer par vendor (yealink, snom, polycom…) ». Le filtre s'applique simultanément aux installés et aux installables, sans tenir compte de la casse.
Si une erreur survient au chargement, un encadré rouge affiche son détail.
Liste « Installés »
Carte avec en-tête « Installés ({n}) » et icône verte.
- Chaque ligne affiche l'identifiant du plugin (le préfixe technique est masqué), une description optionnelle, et la version (
vX.Y) si disponible. - Au survol, un bouton Désinstaller (icône corbeille rouge) apparaît à droite.
- État vide : « Aucun plugin installé. Clique sur « Tout installer ». »
- Chargement : « Chargement… ».
Liste « Installables »
Carte avec en-tête « Installables ({n}) » et icône bleue.
- Chaque ligne affiche l'identifiant (préfixe technique masqué), la description et la version.
- Au survol, un bouton Installer (icône téléchargement) apparaît à droite. Il est désactivé pendant une installation en cours.
- État vide : « Rien à installer. Clique sur « Rafraîchir le catalogue ». »
Action « Tout installer »
Le bouton Tout installer ne cible que les plugins de téléphones non encore installés. Sont reconnus comme plugins téléphones les identifiants des marques : Yealink, Snom, Fanvil, Polycom, Grandstream, Cisco, Gigaset, Aastra, Panasonic, Mitel, AudioCodes.
Un clic ouvre une confirmation :
- Titre : « Installer {n} plugin(s) ? »
- Description : « Va télécharger tous les packs téléphones (Yealink/Snom/Fanvil/Polycom/Grandstream/Cisco/Gigaset/Aastra…) disponibles dans le catalogue. Chaque pack pèse 100-500 MB (firmwares inclus). L'installation peut prendre plusieurs minutes. »
- Bouton de confirmation : Tout installer.
Les plugins sont ensuite installés un par un. Résultat :
- Tous réussis : « {n} plugin(s) installation(s) lancée(s) ».
- Réussites et échecs mélangés : « {ok} OK · {ko} échec(s) » (avertissement).
Prévoyez suffisamment d'espace disque avant un « Tout installer » : les firmwares occupent beaucoup de place.
Désinstallation d'un plugin
Le bouton Désinstaller d'un plugin installé ouvre une confirmation (variante destructive) :
- Titre : « Désinstaller {id} ? »
- Description : « Les téléphones provisionnés avec ce plugin ne pourront plus tirer leur config. Désinstaller libère l'espace disque des firmwares. »
- Bouton de confirmation : Désinstaller.
Mise à jour automatique
En bas de page, un encadré informatif rappelle le fonctionnement de l'auto-update :
- Titre : « Auto-update ».
- Corps : « Un job en arrière-plan rafraîchit le catalogue toutes les 6h et installe automatiquement les nouveaux plugins phone détectés. Désactivable côté serveur via la variable
MAXIPBX_AUTO_INSTALL_PLUGINS=false. »