
EmDash garde son noyau petit : les contenus, les médias, les utilisateurs et l’administration. Tout le reste passe par des plugins. C’est une bonne idée d’architecte, et c’est aussi la première surprise de qui arrive de WordPress : un site EmDash neuf ne sait ni vendre, ni prendre un rendez-vous, ni envoyer une relance de panier.
Cet article fait le point sur ce qu’est un plugin EmDash, sur les deux façons de l’installer, et sur ce que nous avons écrit nous-mêmes pour nos sites clients puis livré dans nos templates EmDash. Ce qui concerne EmDash vient de sa documentation ; ce qui concerne nos plugins vient de leur code.
Ce qu’un plugin EmDash peut faire
D’après la documentation, un plugin peut :
- réagir à des événements : un contenu enregistré, un média envoyé, un commentaire modéré, une tâche planifiée ;
- garder ses propres données, dans des collections indexées et un stockage clé-valeur ;
- ajouter des pages et des cartes au back office, avec des formulaires de réglages générés ;
- servir des routes d’API sous
/_emdash/api/plugins/<id>/<route>; - appeler des services externes, seulement sur les hôtes qu’il déclare ;
- envoyer des courriels par le fournisseur configuré.
Deux formats : sandboxé ou natif
C’est la notion à comprendre avant tout le reste.
- Sandboxé. Le plugin tourne dans un environnement séparé, limité aux API EmDash qu’il déclare. Un administrateur peut l’installer depuis le registre de plugins. La documentation recommande ce format par défaut.
- Natif. Le plugin tourne dans le même processus que le site, avec un accès complet. C’est le seul format qui peut livrer des pages d’administration en React, des composants de rendu Portable Text ou du HTML injecté dans les pages publiques. Il s’installe depuis npm dans
astro.config.mjset demande un déploiement.
En pratique, tout ce qui a besoin de vrais écrans et de vraies tables est natif : une boutique, un CRM, un agenda. Faire confiance à un plugin natif, c’est lui faire autant confiance qu’à son propre code.
Comment on les installe
Un plugin sandboxé du registre s’installe depuis le back office, par un administrateur. Le registre est sorti avec EmDash 1.0 ; un développeur peut aussi déclarer un plugin sandboxé dans astro.config.mjs.
Un plugin natif suit le chemin d’une dépendance :
- ajouter le paquet au projet ;
- le déclarer dans l’intégration EmDash de
astro.config.mjs; - reconstruire et déployer le site ;
- au premier passage, le plugin crée ses tables et ses écrans apparaissent dans le menu.
Avant d’installer un plugin natif, trois questions : quelle version d’EmDash il vise, qui le met à jour quand EmDash sort une version, et si vous pouvez lire son code.
Ce que nous livrons, et pourquoi c’est différent
Nos plugins ne sont pas sur un registre : ils vivent dans le code source de chaque template, sur le socle commun de l’agence. Le site en ligne les liste tous dans sa page Plugins, chacun avec un interrupteur. Désactivé, un plugin quitte le menu et ses routes ne répondent plus ; ses données restent, et le réactiver rend tout tel quel.
Avec la licence Kailua 3, les sept templates portent les plugins du site, de la boutique, du paiement, de la livraison et du marketing : Boutique, Stripe, PayPal, SumUp, Colissimo, Mondial Relay, Assistant IA, Sécurité, Holo, Maintenance, Brevo, Fidélité, Cartes cadeaux, Codes promo, Licences et d’autres. La licence Kailua 3 Pro ajoute, dans le template Kailua, le CRM, la réservation en ligne, les agendas Google et Microsoft 365, l’annuaire des entreprises, les abonnements et Pennylane. La liste complète, avec une ligne par plugin, est sur la page Plugins EmDash.
Ce choix a un prix, et nous le payons à la place de l’acheteur : nos écrans sont natifs, donc ils dépendent de la version de l’administration. À chaque version d’EmDash, nous les reprenons ; pour la 1.5.0, le travail est raconté dans EmDash 1.5.0 : ce que la version change pour un thème.
En bref
- Un plugin EmDash est sandboxé (registre, limité à ses API) ou natif (npm, accès complet, déploiement).
- Une boutique, un CRM ou un agenda sont des plugins natifs : choisissez-les sur leur code et sur qui les suit.
- Les nôtres sont livrés dans les templates, s’allument depuis la page Plugins et suivent chaque version d’EmDash.
Pour choisir le template qui porte les plugins dont vous avez besoin, commencez par comment choisir un template EmDash.




