Tutoriel
Construire pas à pas un onglet sur la fiche ticket, l’empaqueter et l’installer.
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.

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 :
paquet .zip KiwiDesk votre serveur (facultatif)----------- -------- -------------------------manifest.json -- installation -> Paramètres > Pluginsindex.html, app.js, styles.css pages servies isolées, dans deskiwidesk-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, stockageLe 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.
alert, confirm, prompt,
print), naviguer la page principale ou charger un autre site dans son cadre ;Tutoriel
Construire pas à pas un onglet sur la fiche ticket, l’empaqueter et l’installer.
Exemples
Trois plugins complets : un onglet simple, un widget avec stockage, un plugin avec serveur.