カンバンボード

[Discourse]

	概要	Kanban Board を使用すると、カンバンボードインターフェースを通じてトピックを表示し、整理できます。
	プレビュー	Discourse Theme Creator でプレビュー
	リポジトリリンク	https://github.com/discourse/discourse-kanban-theme
	Discourse テーマ初心者ですか？	Discourse テーマの使用方法に関する入門ガイド

このテーマコンポーネントをインストール

これは Discourse チームがメンテナンスする official テーマコンポーネントであるため、#support、#contribute:bug、#contribute:ux、Contribute > Feature のリクエストは、Meta の該当するカテゴリで行うことができ、適切なテーマコンポーネントタグが付けられます。下のリンクをクリックして開始してください。

 サポート  バグ  UX  機能

Kanban ボードは現在、コアの Discourse プラグインとしてリリースされました。Try out the new Boards feature for roadmaps and collaboration を参照してください。これは、Business プランと Enterprise プランの顧客に利用可能です。

私たちがホスティングしていますか？ テーマコンポーネントは、Pro、Business、Enterprise プランで利用可能です。

概要

Kanban Board テーマコンポーネントは、フォーラムのトピックを整理し、可視化する手法を変革します。カテゴリ、タグ、またはユーザーへの割り当てを表す異なるカラム間をトピックが移動できるようにするドラッグ＆ドロップインターフェースを提供し、プロジェクト管理、ワークフローの可視化、コンテンツの整理に最適です。

機能

複数の組織モード

Kanban Board は、トピックを整理するための 3 つの異なるモードを提供します：

1. カテゴリモード: 割り当てられたカテゴリ別にトピックを整理
2. タグモード: 割り当てられたタグ別にトピックを整理
3. 割り当てモード: トピックが割り当てられたユーザー別に整理

リスト間をトピックをドラッグすると、対応する属性が自動的に変更されます：

パフォーマンス最適化

リストは「遅延読み込み」されており、コンポーネントは必要に応じてのみコンテンツを読み込みます。これにより、大量のカテゴリやトピックを扱う場合でも、適切なパフォーマンスが確保されます。

セットアップと設定

デフォルトのボードモードの選択

デフォルトのボードモードは、以下の基準を使用して自動的に決定されます：

• トップレベルの場合は、カテゴリモードを使用
• カテゴリであり、サブカテゴリがある場合は、カテゴリモードを使用
• それ以外の場合は、タグモードを使用。（リストは「トップタグ」リストから構築されます）

ボードモードの変更

左側のフィルターボタンを使用してボードモードを変更できます。設定の変更は URL に反映されます。ユーザーはブラウザで好む設定をブックマークできます。

設定

サイト管理者は、テーマの設定を通じて、テーマコンポーネントのデフォルト設定をカスタマイズできます：

概要

設定	説明
カテゴリの表示	「ボード」ボタンが表示されるべきカテゴリのリスト。空白にすると、どこでも表示されます。サブカテゴリの場合、親スラッグを含めないでください。トップレベルビューを示すには @ を使用してください。
デフォルトモード	各カテゴリのデフォルトのボードモードを上書きします。構文は category:mode:params です。例えば、support:assigned:david,sam,joffrey。トップレベルビューを示すにはカテゴリの代わりに @ を使用します（例：@:tags:todo,done）。タグ未付のカラムを表示するには @untagged を使用してください。
デフォルトビュー	「ボード」がデフォルトビューであるカテゴリのリスト。（注：トップレベルのデフォルトビューはまだサポートされていません）
確認の要求	トピックのタグ/カテゴリを変更する前に確認モーダルを表示する
タグの表示	トピックカードにタグを表示する
カードスタイル	トピックカードの視覚的なスタイルを決定します（現在「詳細」が利用可能）
トピックサムネイルの表示	カードの下部にトピックサムネイルを表示する
アクティビティインジケーターの表示	カードのアクティビティのインジケーターを表示します。トピックが 7 日以上前または 20 日以上前にバンプされた場合、異なるスタイルが適用されます

各設定のデフォルト値は以下に表示されています：

テキストのカスタマイズ

管理者は、Kanban ボードインターフェース全体で使用される テキストラベルをカスタマイズできます。以下のテキスト要素をカスタマイズできます：

概要

翻訳	デフォルト	説明
no_topics	トピックなし	カラムにトピックがない場合に表示
confirm_change_tags	‘%{title}’ に ‘#%{remove}’ を削除し ‘#%{add}’ を追加しますか？	タグ変更時の確認メッセージ
confirm_close	トピック ‘%{title}’ をクローズしますか？	トピックをクローズする際の確認
confirm_open	トピック ‘%{title}’ を再開しますか？	トピックを再開する際の確認
confirm_change_category	トピック ‘%{title}’ を移動しますか？	トピックのカテゴリを変更する際の確認
menu_label	ボード	ボードナビゲーションメニュー項目のテキスト
copy_link	リンクをクリップボードにコピー	リンクコピーのツールチップ
configure	カンバンボードを設定	設定ボタンのテキスト
fullscreen	全画面切替	全画面切替ボタンのテキスト
no_lists	設定された Kanban リストがありません…	リストが設定されていない場合に表示
controls	Kanban Board コントロール	コントロールセクションの見出し
last_post_by	最終投稿者	最終投稿者情報のラベル
modal.title	Kanban を設定	設定モーダルのタイトル
modal.tags_placeholder	表示するタグ…	タグ入力フィールドのプレースホルダー
modal.categories_placeholder	表示するカテゴリ…	カテゴリ入力フィールドのプレースホルダー
modal.usernames_placeholder	表示するユーザー…	ユーザー入力フィールドのプレースホルダー
modal.apply	適用	適用ボタンのテキスト
modal.mode	ボードモード	ボードモードセレクターのラベル
modal.lists	リスト	リスト設定セクションのラベル

効果的な使用のコツ

タグカラムのセットアップ

タグモードで最も直感的なセットアップのために、タグを 「このグループから 1 つのタグのみ」が有効なタググループに整理してください。これにより、トピックにはステータスタグが 1 つのみ付与されるようになり、カンバンボードが従来のワークフローボードのように機能します。

タグモードでのカラム順序の制御

default modes 設定を使用して、カラムの正確な順序を指定できます。例えば、roadmap:tags:discovery,design,build,testing と指定すると、カラムがその特定の順序で表示されます：

ユーザーのエンパワーメント

カンバンカラム間をトピックを移動する仕組みはタグの変更であるため、ターゲットユーザーが実際にこれを行えることを確認する必要があります。オプション：

1. ターゲットユーザーが @staff、@trust_level_4、またはカテゴリモデレーターであることを確認する
2. post edit time サイト設定を変更する（これにより、ユーザーが自分のトピックのタイトル/タグをより長い期間変更できるようになります）
3. すべてのトピックをウィキにする（ただし、タグを変更するにはウィキを編集する必要があるため、あまり推奨されません）

よくある質問

モバイルデバイスでカンバンボードを使用できますか？

ドラッグ＆ドロップ機能は、HTML5 ドラッグ＆ドロップをサポートしていないため、現在モバイルデバイスでは動作しません。モバイルでボードを表示することはできますが、カラム間をカードを移動することはできません。

セットアップ後、ボードタブが消えてしまいます。なぜですか？

初期設定後にボードタブが消える場合は、テーマ設定にカテゴリ名を正しく入力していることを確認する必要があります。正確なカテゴリスラッグ（該当する場合はダッシュではなくアンダースコアを使用）を使用し、親カテゴリとサブカテゴリをそれぞれ個別に設定してください。

サイト全体で表示されるタグを制限するにはどうすればよいですか？

default modes 設定を使用して、タグモードで表示されるタグを設定できます。すべてのタグが表示されるのを防ぐために、カラムとして表示されるべきタグを正確に指定してください。

カードの外観を変更するにはどうすればよいですか？

いくつかの設定を使用して、カードの外観をカスタマイズできます：

• 「カードスタイル」設定を使用して表示形式を選択
• 「タグの表示」オプションでカード上のタグの有効/無効を切り替え
• 「トピックサムネイルの表示」設定でカードにサムネイルを追加
• 「アクティビティインジケーターの表示」設定で視覚的なアクティビティインジケーターを追加

pr-welcome 機能：

• リストをより設定可能にする。例えば、管理者が割り当て、タグ、カテゴリの組み合わせを 1 つの表示で定義できるようにする

• モバイルデバイスでのカードのドラッグ＆ドロップをサポートする。残念ながら、それらは html drag and drop をサポートしていません

[satonotdead]

このプラグインは大幅に改善されました。コアチームの皆様のご尽力に感謝します！

特定のピン留めされたトピックを常にカンバンテーブルの最上部に表示するオプションを追加することを提案したいと思います。

これにより、カンバンビューを使用している場合でも、重要な情報 ('サポート' の使用方法) がすべてのユーザーに常に見える状態を維持するのに役立ちます。

[ChrisBeach (Chris)]

「デフォルトモード」設定について、タグ（カテゴリではない）を使用しているボードの場合、どのように設定すべきか明確にしていただけますでしょうか。

これはドキュメントからの引用ですが、不明瞭です。

@Discourse

各カテゴリのデフォルトボードモードを上書きします。構文 category:mode:params を使用します。例： support:assigned:david,sam,joffrey。トップレベルのビューを示すには @ を使用します。タグなしの列を表示するには @untagged を使用します。

基本的に、#todo と #done の2つのタグがあり、すべてのカテゴリの投稿から、これらのタグのいずれかが付いている投稿を表示するカンバンボードを作成したいと考えています。

[Moin]

@:tags:todo,done でお望みのことができるはずです

[ChrisBeach (Chris)]

うまくいきました！@Moin さん、ありがとうございます。

追記: これを分かりやすくするために、OP のドキュメントを更新しました。

[ShizukuYae]

こんにちは。

プラグインでの素晴らしい仕事に感謝します。

現在、タグモードの設定で、カテゴリのカードのみを表示し、サブカテゴリのカードを表示しないようにする方法はありますか？

[Lew_Grothe]

Horizon テーマへの移行を検討し始めています。Kanban テーマコンポーネントとの互換性についてご存知ですか？リストには載っていませんが、Horizon は非常に強い方針を持っているため、新しい UI を合理的に処理するのは難しいだろうと推測しています。

もし互換性がなければ、Kanban コンポーネントを Horizon で動作するようにフォークする方法はありますか？

[mcwumbly (Dave McClure)]

Horizon と非常にうまく動作するはずです。

[Lew_Grothe]

開発マシンで Horizon を起動しましたが、Kanban が全く動作しません。以前はデフォルトのテーマ（数リリース前）で動作していました。おそらく管理設定の問題だとは思いますが、一応聞いてみました…

さらに調査します…

[Arkshine]

試してみましたが、私の環境では動作しています。
以下の点を確認してみてください：

• コンポーネントはテーマにアタッチされていますか？
• ブラウザのコンソールにエラーは表示されていませんか？

[nathank (Nathan Kershaw)]

@mcwumbly

Horizon と併用しても問題なく動作するはずです。

私も Horizon と併用して快適に使っています。

ただ、Horizon は中央部分の横幅が少し狭いため、カンバンビューの表示幅を広げるために少し調整が必要でした。私が使用した CSS は以下の通りです：

// カンバンビューがメインコンテナの全幅を占有できるようにし、カラム幅を制御します
@media (min-width: 40rem) {
    body.kanban-active:not(.has-full-page-chat,.wizard) #main-outlet-wrapper #main-outlet>*:not(.experimental-screen,.activate-account) {
        max-width: none;
    }
}
.discourse-kanban-container .discourse-kanban-list {
    width: 350px;
}