Aller au contenu
EN/FR
Contact
Tous les articles
Guides pratiquessneaps

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/Export

Vé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

Sources et documentation

Consulter la roadmap

À lire aussi

Guides pratiques

Comment importer un fichier CSV dans EmDash

Préparez une collection, vérifiez un import CSV et mettez à jour vos contenus avec le plugin gratuit Import/Export de Sneaps.

Lire l’article
Guides pratiques

Comment exporter les contenus EmDash en CSV ou JSON

Choisissez le bon format et la bonne version de contenu, et distinguez export de collection et sauvegarde complète.

Lire l’article
Guides pratiques

Comment générer une image de couverture IA dans EmDash

Un parcours éditorial avec Image Generator : choisir une direction, générer une couverture et la vérifier avant publication.

Lire l’article
Guides pratiques

Migrer de Webflow vers EmDash : les points SEO à vérifier

Préparez les URL, contenus, médias et redirections avant de basculer votre site Webflow vers Astro et EmDash.

Lire l’article
Guides pratiques

EmDash vs Webflow : lequel choisir pour un site de contenu ?

Comparez édition, contrôle du frontend, maintenance et migration avant de choisir le CMS de votre prochain site.

Lire l’article
Lancement produit

Import/Export pour EmDash est disponible.

Notre deuxième plugin est sur npm : un outil natif gratuit pour transférer les contenus de vos collections en CSV et JSON.

Lire l’article
Dans les coulisses

Petits plugins. Une grande idée.

Pourquoi nous créons des outils ciblés pour les besoins quotidiens des sites EmDash.

Lire l’article
Notes produit

Une couverture qui commence par vos mots.

Découvrez Image Generator, le premier plugin sneaps publié pour EmDash.

Lire l’article
Roadmap

Une roadmap pensée pour les sorties utiles.

Comment nous organisons le catalogue, des intégrations rapides aux outils natifs plus ambitieux.

Lire l’article