プラグインのインストール

EmDashプラグインは2つの方法でインストールできます：管理ダッシュボード経由のマーケットプレイスから、またはAstro設定に直接追加します。マーケットプレイスのプラグインは常にサンドボックス化されて実行されます；設定ベースのプラグインは、宣言されている配列（sandboxed: [] vs plugins: []）に応じて、サンドボックス化またはインプロセスで実行されます。

マーケットプレイスから

管理ダッシュボードには、プラグインを検索、インストール、管理できるマーケットプレイスブラウザが含まれています。

前提条件

マーケットプレイスのプラグインをインストールするには、サイトに次のものが必要です：

1. サンドボックスランナーの設定 — マーケットプレイスのプラグインは分離されたランタイムで実行され、サンドボックスランナーが必要です。次の設定でこれを有効にします：

   import { defineConfig } from "astro/config";
   import emdash from "emdash/astro";
   
   export default defineConfig({
     integrations: [
       emdash({
         marketplace: "https://marketplace.emdashcms.com",
         sandboxRunner: "@emdash-cms/sandbox-cloudflare",
       }),
     ],
   });

2. 管理者アクセス — 管理者のみがプラグインをインストールまたは削除できます。

閲覧とインストール

プラグインはダウンロードされ、サイトのR2バケットに保存され、サンドボックスランナーに読み込まれます。すぐにアクティブになります。

機能の同意

インストール前に、プラグインがアクセスする必要があるものをリストしたダイアログが表示されます：

セキュリティ監査

マーケットプレイスのすべてのプラグインバージョンは、自動セキュリティ監査を受けています。監査の判定はプラグインカードに表示されます：

• Pass — 問題は見つかりませんでした
• Warn — 軽微な懸念事項がフラグ付けされました（結果を確認してください）
• Fail — 重大なセキュリティ問題が検出されました

プラグインの詳細ページで、個々の結果とその重大度を含む完全な監査レポートを表示できます。

更新

インストールされたプラグインの新しいバージョンが利用可能な場合：

1. 管理パネルのプラグインに移動します
2. マーケットプレイスのプラグインに更新可能バッジが表示されます
3. 更新をクリックして、変更履歴と機能の変更を確認します
4. 新しいバージョンで追加の機能が必要な場合は、差分が表示され、承認が必要です
5. 更新を確認します

アンインストール

1. 管理パネルのプラグインに移動します
2. 削除したいマーケットプレイスのプラグインをクリックします
3. アンインストールをクリックします
4. プラグインの保存されたデータを保持するか削除するかを選択します
5. 確認します

プラグインのサンドボックスコードはR2バケットから削除され、すぐに実行を停止します。

設定から

ネイティブプラグイン — 自分のコードまたはnpm経由でインストールされたパッケージ — はAstro設定に直接追加されます。次の例はSEOプラグインを登録します：

import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import seoPlugin from "@emdash-cms/plugin-seo";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [
        seoPlugin({ generateSitemap: true }),
      ],
    }),
  ],
});

ネイティブプラグイン：

• インプロセスで実行されます（サンドボックス化されません）
• Node.js APIへの完全なアクセス権を持ちます
• ビルド時およびサーバー起動のたびに読み込まれます
• 管理UIからインストールまたは削除できません

マーケットプレイス vs. 設定 — どちらを使用するか