以前は「Discourse Category Sidebars」と呼ばれていましたが、このテーマコンポーネントはカテゴリとタグの両方のトピックリストをサポートするようになったため、名前がTopic List Sidebarsに更新されました。
 |
概要 | Topic List Sidebarsは、特定のトピックを取得し、カテゴリまたはタグのトピックリストのサイドバーとして適用します。 |
 |
プレビュー | Discourse Theme Creatorでのプレビュー |
 |
リポジトリリンク | https://github.com/discourse/discourse-topic-list-sidebars |
 |
Discourseテーマが初めての方へ | Discourseテーマの使用に関する初心者向けガイド |
このテーマコンポーネントをインストール
機能
このテーマコンポーネントは、特定のトピックを取得し、カテゴリまたはタグのトピックリストのサイドバーとして適用します。これらのサイドバーは、ブラウザの幅が767px以上の場合（ほとんどのタブレットとモニター）に表示されます。
このテーマコンポーネントで何ができますか？
-
特定のトピックを選択し、そのコンテンツをカテゴリまたはタグのサイドバーとして表示します。
-
設定でカテゴリ名として
allを使用することで、/latest、/new、/unread、/topページにサイドバーを表示させることができます。 -
サイドバーをトピックリストの左側または右側に表示させるかを選択できます。
-
デフォルトでは、カテゴリのサイドバーはすべての子カテゴリでも表示されます（ただし、子カテゴリに独自のサイドバーが定義されている場合は除く。この動作を無効にするには、
inherit parent sidebar設定のチェックを外してください）。
設定方法は？
カテゴリとタグを選択し、サイドバーのコンテンツを埋めるために使用するトピックの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プランでご利用いただけます。