プラグインレジストリ

プラグインレジストリは、サンドボックスプラグインのサポートされているカタログです。誰でもplugins.emdashcms.comで公開されているプラグインを閲覧できます。管理者は、EmDash管理パネルのRegistryセクションからそれらをレビューしてインストールできます。

EmDashは、サイトにプラグインサンドボックスが有効になっている場合、デフォルトでhttps://registry.emdashcms.comでホストされているレジストリを使用します。

プラグインの公開名

すべてのレジストリプラグインには、発行者の現在のAtmosphereアカウントハンドルとそのパッケージスラッグから構成される公開名があります。たとえば、example.comによって発行されたmy-galleryというスラッグのパッケージは、@example.com/my-galleryとして表示されます。

公開名は、レジストリ結果と、インストール後のPluginsの下に表示されます。プラグインの詳細ページを開くには、それを選択するか、レジストリ検索に完全な名前を貼り付けてその正確なパッケージを見つけます。EmDashは、パッケージをロードする前に、ハンドルを発行者の安定したアカウント識別子に解決します。

ハンドルが発行者に決定的に解決されなくなった場合、EmDashはINVALID HANDLEを表示し、パッケージ詳細ページからの新規インストールを防ぎます。既存のインストールは現在の状態のままなので、IDルックアップが実行中のサイトを無効にすることはできません。インストールされたプラグインをレビューし、更新する前に発行者に連絡してください。一時的なルックアップ失敗は、無効なハンドルを報告する代わりに、安定した発行者識別子をHandle unavailableと共に表示します。

レジストリインストールを有効にする

レジストリからプラグインをインストールするには、ストレージと利用可能なサンドボックスランナーを設定します。まず、プラットフォーム固有のプラグインサンドボックスセットアップを完了してください。

astro.config.mjsのemdash()設定にCloudflareサンドボックスランナーを追加します:

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

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

サンドボックスランナーが設定されると、EmDashはRegistryカタログを表示します。別のアグリゲーターを選択したり、レジストリポリシーを設定したり、検出を無効にしたりするには、registry設定リファレンスを参照してください。

レジストリプラグインをインストール

同意ダイアログを表示する前に、EmDashはダウンロードされたバンドルのチェックサム、名前、バージョン、権限を確認します。発行者がビルド来歴を要求する場合、EmDashはその証拠も検証します。チェックが失敗すると、インストールは停止します。同意ダイアログは、インストール前に検証ステータスと正確な権限を表示します。

レジストリ更新はこれらのチェックを繰り返します。更新が権限やMCPツールを追加する場合、または認証済みからパブリックにルートを変更する場合、確認を待ちます。アンインストールはバンドルを削除し、Also delete plugin storage dataを選択しない限り、プラグインストレージデータを保持します。共有の更新とアンインストール手順については、プラグインのインストールを参照してください。

関連ページ

• レジストリのクエリは、実験的な読み取り専用検出クライアントを文書化しています。
• バンドルと公開は、サンドボックスプラグインの公開をカバーしています。
• 機能とセキュリティは、サンドボックス権限モデルを説明しています。