E EmDash CMS Everything Guides, use cases, plugins, templates
Français

Le registre de plugins

Sur cette page

Le registre de plugins est le catalogue pris en charge pour les plugins sandbox. Tout le monde peut parcourir les plugins publiés sur plugins.emdashcms.com. Les administrateurs peuvent les examiner et les installer depuis la section Registry du panneau d’administration EmDash.

EmDash utilise le registre hébergé sur https://registry.emdashcms.com par défaut lorsque le site dispose d’un sandbox de plugins activé.

Noms publics des plugins

Chaque plugin du registre possède un nom public composé du handle de compte Atmosphere actuel de son éditeur et de son slug de package. Par exemple, un package avec le slug my-gallery publié par example.com apparaît comme @example.com/my-gallery.

Le nom public apparaît dans les résultats du registre et sous Plugins après l’installation. Sélectionnez-le pour ouvrir la page de détails du plugin, ou collez le nom complet dans la recherche du registre pour trouver ce package exact. EmDash résout le handle vers l’identifiant de compte stable de l’éditeur avant de charger le package.

Si le handle cesse de se résoudre de manière concluante vers l’éditeur, EmDash affiche INVALID HANDLE et empêche les nouvelles installations depuis la page de détails du package. Les installations existantes restent dans leur état actuel afin qu’une recherche d’identité ne puisse pas désactiver un site en cours d’exécution. Examinez le plugin installé et contactez son éditeur avant de le mettre à jour. Une défaillance temporaire de recherche affiche l’identifiant d’éditeur stable avec Handle unavailable au lieu de signaler un handle invalide.

Activer les installations du registre

Pour installer des plugins depuis le registre, configurez le stockage et un runner sandbox disponible. Complétez d’abord la configuration du sandbox de plugins spécifique à la plateforme.

Ajoutez le runner sandbox Cloudflare à la configuration emdash() dans astro.config.mjs :

import { defineConfig } from "astro/config";
import { sandbox } from "@emdash-cms/cloudflare";
import emdash from "emdash/astro";

export default defineConfig({
	integrations: [
		emdash({
			sandboxRunner: sandbox(),
		}),
	],
});

EmDash affiche le catalogue Registry après que le runner sandbox est configuré. Consultez la référence de configuration registry pour sélectionner un autre agrégateur, définir une politique de registre ou désactiver la découverte.

Installer un plugin du registre

  1. Ouvrez Registry dans le panneau d’administration.
  2. Recherchez par titre, description ou un nom public complet tel que @example.com/my-gallery, puis ouvrez la page de détails du plugin.
  3. Sélectionnez une version et examinez son éditeur, ses métadonnées, les permissions demandées et l’état de vérification.
  4. Sélectionnez Install.
  5. Examinez l’état de vérification et les permissions dans la boîte de dialogue de consentement, puis confirmez.

Avant d’afficher la boîte de dialogue de consentement, EmDash vérifie la somme de contrôle, le nom, la version et les permissions du bundle téléchargé. Si l’éditeur exige une provenance de build, EmDash vérifie également ces preuves. L’installation s’arrête si une vérification échoue. La boîte de dialogue de consentement affiche l’état de vérification et les permissions exactes avant l’installation.

Les mises à jour du registre répètent ces vérifications. Une mise à jour attend confirmation lorsqu’elle ajoute des permissions ou des outils MCP, ou change une route d’authentifiée à publique. La désinstallation supprime le bundle et conserve les données de stockage du plugin sauf si vous sélectionnez Also delete plugin storage data. Consultez Installation de plugins pour les étapes partagées de mise à jour et de désinstallation.

Pages connexes