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

EmDash プラグインは 2 つの方法でインストールできます：管理ダッシュボード経由でマーケットプレイスから、または Astro 設定に直接追加します。マーケットプレイスプラグインは分離されたサンドボックスで実行されます；設定ベースのプラグインはインプロセスで実行されます。

マーケットプレイスから

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

前提条件

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

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

   import { emdash } from "emdash/astro";
   
   export default defineConfig({
     integrations: [
       emdash({
         marketplace: "https://marketplace.emdashcms.com",
         sandboxRunner: true,
       }),
     ],
   });

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

ブラウズとインストール

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

機能同意

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

セキュリティ監査

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

• 合格 — 問題なし
• 警告 — 軽微な懸念事項がフラグ付け（結果を確認）
• 不合格 — 重大なセキュリティ問題が検出

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

更新

インストール済みプラグインの新しいバージョンが利用可能になったとき：

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

アンインストール

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

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

設定から

ネイティブプラグイン（自分のコード、または npm 経由でインストールしたパッケージ）の場合、Astro 設定に直接追加します：

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 設定：どちらを使用するか