管理パネルは、EmDashサイトに含まれる編集インターフェースです。Astroアプリケーションによって/_emdash/admin/で配信され、公開ページと同じデータベース、メディアストレージ、コンテンツモデル、プラグインを使用します。
新しいサイトの管理ルートへの初回アクセスでは、セットアップウィザードが開きます。セットアップ後は、ログインしたユーザーの権限によって、利用できるコンテンツツールと管理ツールが決まります。
作業エリア
ナビゲーションはサイトのコレクションとインストールされたプラグインに適応します。エディターまたは管理者が見る可能性のある主なエリアは以下の通りです：
| エリア | 用途 |
|---|---|
| ダッシュボード | サイトとプラグインのウィジェットを含むスタートビュー |
| 投稿などのコレクション名 | エントリの一覧表示、作成、編集、公開、ゴミ箱への移動 |
| コレクショングループ | グループを共有するコレクションを含む折りたたみ可能なフォルダー、およびそのフォルダー内のコレクションのみに割り当てられたタクソノミー |
| メディア | ファイルのアップロード、検索、検査、置換、削除 |
| タクソノミーとバイライン | コンテンツの整理とクレジットされた著者の管理 |
| メニューとウィジェットエリア | ナビゲーションとサイトがレンダリングするエディター制御領域の管理 |
| コメント | コレクションがコメントを有効にしている場合のレビューとモデレーション |
| コンテンツタイプ | コレクションとフィールドの作成、設定変更 |
| プラグイン | プラグインのインストール、設定、プラグインが提供するページを開く |
| 設定 | サイト、認証、バックアップ、メール、検索、その他のサービスの構成 |
このインターフェースはデータと構成を管理します。Astroのページとコンポーネントは引き続き公開レイアウトを定義します。管理画面でメニュー項目やウィジェットを追加しても、Astroコンポーネントがそのメニューまたはウィジェットエリアをクエリしてレンダリングする場合にのみ、公開サイトが変更されます。
コンテンツエディター
コンテンツエディターは、選択されたコレクションからフォームを構築します。短いテキストフィールドはテキスト入力に、portableTextフィールドはリッチテキストエディターに、メディアフィールドはメディアピッカーを開き、参照フィールドはエディターが別のエントリを選択できるようにします。コレクション設定は、該当する場合に公開、プレビュー、リビジョン、コメント、検索のコントロールを追加します。
リッチテキストエディターは、見出し、リスト、引用、コード、リンク、画像、登録されたカスタムブロックをサポートします。インポートされたコンテンツにエディターが表示できないブロックが含まれている場合、EmDashは次の保存時にそれを削除するのではなく、保存されたブロックを保持します。
保存と公開は、下書きを持つコレクションでは別々の状態です。保存は現在の作業を下書きとして保存します。公開または変更を公開は、保存されたバージョンを公開クエリで利用可能にします。スケジューリングは、下書きまたは保留中の変更がいつ公開されるべきかを記録します。
コレクションで編集ロックが有効になっている場合、エントリを開くとそのエディターのロックが保持されます。ロックがアクティブな間は、エントリを黙って上書きするのではなく、他のライターが拒否されます。エディターがエントリを読み込んだ後にエントリが変更された場合、EmDashは古い保存も拒否するため、エディターは上書きする代わりに新しいバージョンを再読み込みできます。
ロールと権限
EmDashには5つのロールがあります：購読者、寄稿者、著者、エディター、管理者。ロールレベルが上がるにつれて権限が増えますが、コンテンツとメディアのアクションには所有権が重要です。例えば、著者は自分のエントリを編集・公開できますが、エディターはどのエントリに対してもそれが可能です。
管理エリアには別の権限チェックがあります：
- エディターはタクソノミー、メニュー、バイライン、ウィジェット、セクション、他の著者のコンテンツを管理できます。
- 管理者はコンテンツモデル、ユーザー、プラグイン、リダイレクト、バックアップ、設定を変更でき、ゴミ箱のコンテンツを完全に削除できます。
- サーバーは各アクションの権限をチェックします。ナビゲーション項目を非表示にしてもセキュリティの境界にはなりません。
アカウントのセットアップと完全なロールの説明については認証とユーザーロールをお読みください。
メディア
メディアライブラリはファイルをグリッドまたはリストで表示し、検索とフィルタリング、メタデータの表示、複数アイテムのアクションを実行できます。アップロードの動作は構成されたストレージアダプターに依存します。アダプターが署名付きアップロードをサポートしている場合、ブラウザは短期間の署名付きURLを使用してファイルをストレージに送信し、EmDashにアップロードの完了を確認します。
メディアアイテムの削除は、それを参照するエントリに影響を与える可能性があります。公開ページで使用されているアセットを削除する前に、メディア使用情報と置換ツールを使用してください。アップロード、置換、削除のワークフローについてはメディアライブラリを参照してください。
プラグインインターフェース
プラグインはダッシュボードウィジェット、設定セクション、エディターコントロール、または完全な管理ページを追加できます。プラグインページはそのプラグイン独自の管理ルートの下にマウントされ、コアの管理画面を置き換えることはできません。管理リンクが特定のロールにのみ表示される場合でも、プラグインは保護されたアクションに対してサーバーサイドの権限チェックが必要です。
拡張機能を追加するにはプラグインのインストールをお読みください。インターフェースを構築するサイト開発者は、コアの管理アプリケーションを変更するのではなく、ネイティブプラグイン管理APIを使用すべきです。
構成要件
管理画面はReactアプリケーションのため、Astroプロジェクトは@astrojs/react、react、react-domをインストールし、astro.config.mjsにreact()を登録する必要があります。サイトにはサーバー出力、データベース、メディアストレージも必要です。完全なローカル構成については既存のAstroプロジェクトにEmDashを追加するを参照してください。