Product Roadmap
公開ロードマップ:ユーザーがアイデアに投票し、自分のアイデアを提案できます。リリース済みの内容を記録する変更履歴付き。
プラグイン
Product Roadmap
公開ロードマップ:ユーザーがアイデアに投票し、自分のアイデアを提案できます。リリース済みの内容を記録する変更履歴付き。
説明
あらゆる EmDash サイトで使える公開ロードマップです。訪問者は、あなたが検討中のもの、開発中のもの、リリース済みのものを見られます。投票でき、あなたの承認を待つアイデアを送ることもできます。
主な機能
- 名前を付けられるステージ付きのボード。 最初は Under review、Planned、In progress、Done から始まります。追加、非表示、名前の変更、並べ替えができます。
- 投票。 1 人につき 1 項目に 1 票。もう一度クリックすると取り消せます。
- 承認制の提案。 アイデアは下書きとして保存されます。承認してボードに載せるか、却下します。
- ゲストまたは会員。 誰が投票や提案をできるかはあなたが選びます。ゲストは名前を入力します。書かれたアイデアは常にレビュー待ちになります。
- 変更履歴。 一覧ページとリリースごとのページを持つ、2 つ目のコレクションです。
- コメント。 項目ページは EmDash 自身のコメントを使います。追加でモデレーションするものはありません。
- 統合。 重複した項目を、残す項目にまとめます。票は 1 人 1 票のまま移ります。
全体の仕組み
プラグインはエンジンです。ルート、ストレージ、管理画面を担います。EmDash プラグインはサイトにページを追加できないため、公開ページは一度コピーするサイトキットとして提供されます。「インストール」を参照してください。
1 時間ごとのメールにはメールプロバイダーが必要です。メールがオフでも、ダッシュボードカードには承認待ちのアイデアの件数が表示されます。
インストール
インストールの前に
1. サイトにはサンドボックスランナーが必要です。 レジストリのプラグインはサンドボックスで実行されます。サイトにサンドボックスランナーがない間は、Admin、Plugins に「No plugins configured」と表示され、メニューに Registry もありません。
- Node: サイトで
npm install @emdash-cms/sandbox-workerd workerdを実行し、astro.config.mjsのemdash()の中にsandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",を追加します。 - Cloudflare:
import from "@emdash-cms/cloudflare";とsandboxRunner: sandbox(),を追加します。Workers Paid プラン、LOADERという名前のworker_loadersバインディング(Wrangler の設定でコメントを外します)、そしてstorage: r2(...)としての R2 バケットが必要です。そうでないと、インストールは「Storage error while installing plugin」で止まります。その後、npm run deployを実行します。
開発サーバーを停止して再度起動します。管理メニューに Registry が表示されるようになります。
2. プラグインはエンジンです。訪問者向けのページは、そのサイトキットから提供されます。 レジストリのプラグインはサイトにページを追加できません。キットをコピーするまでは、そのアドレス(たとえば /roadmap/)にはサイトの 404 ページが表示されます。これは想定どおりです。下のキットのコピーは 1 つのコマンドで済みます。
3. Node 22.16 以降が必要です。 npx emdash seed のステップのために必要です。
blog テンプレートを使い、EmDash 1.3.1 の Node と Cloudflare Workers(レジストリからのインストール)で確認しています。
インストール手順
-
Admin、Registry で Product Roadmap を検索し、Install して、権限を承認します。
-
サイトのルートフォルダーで次を実行します。
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.4.0 \ https://github.com/wbcomdesigns/emdash-roadmap \ "$kit/emdash-roadmap" && "$kit/emdash-roadmap/scripts/add-to-site.sh" . -
貼り付けるものはありません。開発サーバーを再起動します。
-
Admin、Menus で、表示されたリンクを追加します。
-
Admin、Roadmap、Ideas を開きます。
更新のたびに、新しいタグを指定して手順 2 を実行してください。完全なガイド:https://github.com/wbcomdesigns/emdash-roadmap/blob/v0.4.0/docs/website/getting-started/install.md
よくある質問
インストール後に /roadmap/ が 404 になるのはなぜですか?
プラグインはページを作成できません。インストールしたバージョンのタグを指定して、Installation タブ(または Admin、Roadmap、Ideas)にあるキットのコマンドを実行し、その後に開発サーバーを再起動してください。
ボードが読み込めないと表示されます。 インストールしたバージョンのタグから、もう一度キットをコピーしてください。キットとプラグインは同時にリリースされます。
ゲストは投票やアイデアの提案ができますか?
はい。Settings が Anyone(既定)に設定されていて、ホストが訪問者のアドレスを EmDash に渡す場合に限ります。Cloudflare、またはサイト設定の trustedProxyHeaders が該当します。そうでない場合、ゲストにはサインインのリンクが表示され、Settings にもその旨が示されます。すべてのアイデアは、あなたの承認を待ちます。
ゲストがブラウザーのコンソールで 401 を見ます。 想定どおりです。ページはまず、サインイン済みの会員の投票を確認します。ページ自体に問題はありません。
項目を別のステージに移すにはどうしますか? 項目の編集画面で、右側の Stage パネルを使います。
新しいアイデアはすぐに公開されますか? いいえ。提案は下書きとして保存されます。Ideas で承認すると、ボードに載ります。
ステージの名前を変更するとどうなりますか? ボードは新しい名前を使います。項目はその列に残ります。項目を 1 つずつ編集する必要はありません。
ダークモードで動作しますか? はい。キットの色はサイトのテーマに従います。
メールを送信しますか? サイトにメールプロバイダーがあれば、アイデアが承認待ちのときに 1 時間に 1 通の短い通知を送ります。通知にはアイデアの文章もリンクも含まれません。ダッシュボードカードには常に件数が表示されます。
有料版はありますか? いいえ。ここにあるものはすべて無料です。
変更履歴
0.4.0
負荷の高いテストサイトでも、すべてのページ、投票、管理画面が、Cloudflare のプラグイン呼び出し 1 回あたり 10 リクエストという上限内に収まるようになりました。Cloudflare で確認するまでは、引き続き非対応と表示します。新しい権限はありません。
- 新機能:各項目が累計の票数を保持します。0.3.0 の票数は、Ideas ページの読み込み時と 1 時間ごとに再構築されます。
- 改善:統合、Roadmap の票の消去、1 時間ごとのクリーンアップが段階的に実行されます。
- 修正:Cloudflare で、ゲストの投票が「ボードにありません」として拒否されていました。
- 修正:キットのスクリプトが、Cloudflare のサイトでコンテンツタイプが作成されたと表示しなくなりました。
更新後にもう一度キットをコピーしてください。それまでは、カテゴリで絞り込んだボードにすべての項目が表示され、Take back all my votes は 7 件を超えるとエラーで止まります。
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.4.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
0.3.0
新しい権限:Read retained content revision history。これにより、Stage パネルは、未公開の変更がある項目を確認して移動できます。更新時に一度承認します。ゲストが投票するには訪問者のアドレスが必要です。更新後にもう一度キットをコピーしてください。
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.3.0 \
https://github.com/wbcomdesigns/emdash-roadmap \
"$kit/emdash-roadmap" &&
"$kit/emdash-roadmap/scripts/add-to-site.sh" .
- 新機能:Set up visitor pages カード。scripts/add-to-site.sh がキット全体をコピーします。
- 改善:ステージの設定場所は Stage パネルだけになりました。
- 修正:Ideas の件数、入れ子のフォーム、配置、ダークモード。
- セキュリティ:訪問者のアドレスがない場合、ゲストは書き込めません。IPv4 または IPv6 /64 ごとにゲスト 1 人です。ハッシュは 30 日後に消去されます。
0.2.1
- 修正:My votes のファイル名が WB Polls のものと同じではなくなったため、両方のキットを 1 つのサイトに置けます。更新後にもう一度キットをコピーしてください。
以前のバージョン:https://github.com/wbcomdesigns/emdash-roadmap/blob/main/CHANGELOG.md