以前は「Discourse カテゴリサイドバー」と呼ばれていましたが、カテゴリとタグの両方をサポートするようになったため、このテーマコンポーネントの名称は現在トピックリストサイドバーに更新されています。
 |
概要 | トピックリストサイドバーは、トピックを指定し、カテゴリまたはタグのトピックリストのサイドバーとして適用します。 |
 |
プレビュー | Discourse テーマクリエーターでプレビュー |
 |
リポジトリリンク | https://github.com/discourse/discourse-topic-list-sidebars |
 |
Discourse テーマは初めてですか？ | Discourse テーマの利用に関する初心者ガイド |
このテーマコンポーネントをインストール
機能
このテーマコンポーネントは、トピックを指定し、カテゴリまたはタグのトピックリストのサイドバーとして適用します。これらのサイドバーは、ブラウザの幅が 767px 以上（ほとんどのタブレットとモニター）の場合にのみ表示されます。
このテーマコンポーネントで何ができますか？
- 任意のトピックを選択し、その内容をカテゴリまたはタグのサイドバーとして表示します。
- 設定でカテゴリ名に
allを指定することで、/latest、/new、/unread、/top ページにサイドバーを表示できます。 - サイドバーをトピックリストの左側または右側に表示するよう選択できます。
- デフォルトでは、サブカテゴリに独自のサイドバーが定義されていない限り、カテゴリのサイドバーはそのすべてのサブカテゴリにも表示されます（
親のサイドバーを継承する設定のチェックを外すとこれを無効にできます）。
設定方法は？
カテゴリとタグを選択し、サイドバーの内容を埋め込むために使用するトピックの ID（例：example.com/t/example-topic/57）を追加します。
それぞれのカテゴリ/タグにサイドバー用のトピックを作成し、返信がないようにトピックを閉じ、リストから除外すること（トピックリストに表示されないようにする）をお勧めします。
なお、プライベートカテゴリのトピックをパブリックカテゴリのサイドバーとして使用することはできません（技術的には可能ですが、そのプライベートトピックへのアクセス権がないユーザーには空のサイドバーが表示されるだけです）。
設定
| 名前 | 説明 |
|---|---|
| sidebars | サイドバーの追加と削除 |
| sidebar side | 左または右を選択 |
| inherit parent sidebar | チェックした場合、サブカテゴリは親カテゴリのサイドバーを継承します（サブカテゴリに独自のサイドバーが割り当てられている場合を除く）。 チェックを外した場合、サブカテゴリはサイドバーが指定されている場合のみ表示されます。 |
| stick on scroll | チェックした場合、サイドバーはスクロール時に固定位置になります |
開発者向けノート
各カテゴリのサイドバーは、カテゴリのスラッグを含むクラスで囲まれています。例えば、スタッフカテゴリの場合は .category-sidebar-staff となります。これらのクラスを使用して、個々のサイドバーのスタイルを設定できます。
サイドバーがあるページの body タグにもクラスが追加されるため、body.custom-sidebar を使用して、サイドバーがあるすべてのページにスタイルを適用できます。
クレジット
このコンポーネントの実現に向けた基盤作りをしてくださった @xrav3nz に特別な感謝を！
当方でホストされていますか？ テーマコンポーネントは、Standard、Business、Enterprise プランで利用可能です。