Installer un plugin EmDash : npm ou registre ?
Comprenez les modes d’installation, vérifiez les prérequis et installez le bon plugin pour votre projet EmDash.
Installation et exécution sont deux sujets distincts
Un plugin EmDash peut être installé depuis le registre dans l’administration ou géré comme dépendance npm. Ne supposez pas que tout package npm est natif : un plugin configuré dans le projet peut aussi être sandboxé. Lisez les instructions de son éditeur.
Chez Sneaps, Image Generator dispose d’une fiche dans le registre ; Import/Export est un plugin npm natif. Commencez par l’outil nécessaire, puis suivez son installation documentée. Installer un package natif comme un bundle sandboxé ne lui fournit pas l’environnement attendu.
Utilisez le registre quand le plugin le propose
Pour un plugin du registre, examinez sa fiche, son éditeur, ses permissions et ses instructions. L’administration doit disposer d’un sandbox configuré, d’un stockage de bundles et d’un administrateur autorisé à gérer les plugins. Voir le catalogue ne prouve pas que l’installation fonctionne.
Sur un projet client, notez pourquoi vous ajoutez le plugin et qui le maintiendra. Vérifiez son comportement en préproduction avant d’en dépendre pour un parcours éditorial important. Le sandbox limite l’exécution, mais les permissions approuvées restent à comprendre.
Utilisez npm pour une dépendance native
Installez le package dans le projet Astro et enregistrez la fonction exportée selon sa documentation. Pour Import/Export, importez importExport depuis @sneaps/import-export et ajoutez importExport() au tableau plugins existant. Conservez les autres plugins au lieu de remplacer tout le tableau par un exemple.
Enregistrez les modifications de dépendance et de lockfile dans le projet, compilez et redéployez. Vérifiez l’entrée attendue dans l’administration et testez un petit jeu de données. La maintenance d’un plugin natif suit le parcours de développement et de déploiement du site.
Installer Import/ExportVérifiez la plateforme avant le package
Si l’installation échoue, déterminez d’abord si l’erreur intervient avant l’exécution du plugin. Vérifiez version EmDash, hébergement, configuration et accès administrateur. Consultez le guide sandbox actuel pour le runner et les bindings de votre plateforme.
Contrôlez ensuite le nom du package et l’export enregistré. N’inventez pas un nom de fonction à partir du package npm. Conservez l’erreur exacte et comparez-la à la documentation. Modifier les identifiants ou redéployer une configuration sans rapport ne résout pas un enregistrement au mauvais endroit.
Prévoyez mises à jour et retrait
Notez la version installée et le rôle du plugin. Avant une mise à jour, exportez ou sauvegardez les données concernées, lisez les notes de version et vérifiez le résultat hors production. Examinez les changements de permissions aussi attentivement que les nouvelles fonctions.
Avant le retrait, identifiez les données propres au plugin et les templates dépendant de ses sorties. Une dépendance npm peut nécessiter modification de configuration et déploiement ; un plugin du registre suit son parcours d’administration. Documentez un retour arrière réellement utilisable par votre équipe.
Choisissez l’outil adapté au travail
Pour les images à la une générées, commencez par Image Generator. Pour transférer des contenus de collection via des fichiers structurés, utilisez Import/Export. Les deux étendent EmDash, mais leurs besoins d’installation et d’exploitation diffèrent.
Un bon choix répond à un besoin précis, documente sa compatibilité et dispose d’un responsable des mises à jour. Installez les outils utiles aujourd’hui, puis ajoutez les autres lorsqu’un besoin éditorial ou commercial concret apparaît. Le dépannage et la passation restent ainsi compréhensibles.
Guide de génération d’images