Aller au contenu

Les plugins

Un plugin ajoute à KiwiDesk une fonction qui n’en fait pas partie : un suivi transporteur, un lien avec le logiciel d’un fournisseur, un indicateur maison sur le tableau de bord… Il s’installe depuis le back-office, à partir d’un fichier .zip, sans recompiler ni redémarrer KiwiDesk.

Un plugin est isolé : il ne s’exécute pas dans le serveur de KiwiDesk et ne voit jamais la base de données. Il ne fait que ce que le super administrateur lui a accordé à l’installation, et une panne du plugin n’affecte que lui.

Fiche ticket REP-2026-0215 : l'onglet Expédition, ajouté par le plugin d'exemple Suivi transporteur, montre le transporteur, le numéro de suivi, l'adresse et l'historique du colis jusqu'à Livré.

L’onglet Expédition du plugin d’exemple « Suivi transporteur » sur une fiche ticket ; l’icône à côté du libellé de l’onglet signale qu’il vient d’un plugin.

Emplacement Où il apparaît
Entrée de menu et page Groupe Plugins de la barre latérale ; la page s’ouvre dans le cadre de KiwiDesk (/plugins/<id>/<page>)
Onglet d’une fiche Ticket, client, facture, appareil reconditionné ou article en stock
Action d’une fiche Bouton dans l’en-tête de la fiche, qui ouvre la page du plugin dans une fenêtre
Widget du tableau de bord Sous les widgets du tableau de bord d’accueil
Serveur (facultatif) Un service à vous qui reçoit des événements signés et appelle l’API avec le jeton du plugin

Les pages d’un plugin sont de simples fichiers HTML, CSS et JavaScript, affichés dans une iframe isolée. Elles parlent à KiwiDesk par le SDK :

  • lire le contexte (fiche affichée, boutique, utilisateur, thème clair ou sombre) ;
  • appeler l’API au nom de l’utilisateur connecté, dans la limite de ses droits et de ceux du plugin ;
  • ouvrir une fiche, afficher une notification, demander une confirmation ou un texte, imprimer, rafraîchir la page ;
  • lire et écrire dans son propre espace de stockage.
paquet .zip KiwiDesk votre serveur (facultatif)
----------- -------- -------------------------
manifest.json -- installation -> Paramètres > Plugins
index.html, app.js, styles.css pages servies isolées, dans des
kiwidesk-plugin-sdk.js iframes aux emplacements prévus
| postMessage (SDK)
v
page KiwiDesk : appelle l'API
pour l'utilisateur, droits réduits
à ceux du plugin
webhooks signés -> reçoit les événements
<- jeton plg_live_ appelle l'API, stockage

Le manifeste déclare tout : les emplacements, les permissions, les événements, l’adresse du serveur et les réglages. Le super administrateur voit cette liste avant d’accepter.

  • lire le jeton ou les cookies de l’utilisateur, ni la page de KiwiDesk qui l’entoure ;
  • appeler une autre adresse que son propre serveur ;
  • appeler une route de l’API qui n’est pas ouverte aux plugins ;
  • recevoir les codes de déverrouillage, les liens et codes de suivi client, les jetons ou les secrets, retirés des réponses ;
  • créer une clé API, un webhook, un rôle, un utilisateur, ou modifier l’e-mail d’un compte ;
  • ouvrir des fenêtres ou des boîtes de dialogue du navigateur (alert, confirm, prompt, print), naviguer la page principale ou charger un autre site dans son cadre ;
  • dépasser les droits de l’utilisateur qui l’utilise : un technicien sans accès aux factures ne les voit pas non plus à travers un plugin.

Exemples

Trois plugins complets : un onglet simple, un widget avec stockage, un plugin avec serveur.

Exemples