 |
概要 | Right Sidebar Blocks は、トピック一覧の右側に設定可能なブロック一覧を表示するサイドバーを表示します。 |
 |
プレビュー | Discourse Theme Creator でプレビュー |
 |
リポジトリリンク | https://github.com/discourse/discourse-right-sidebar-blocks |
 |
Discourse テーマは初めてですか？ | Discourse テーマの使い方入門ガイド |
このテーマコンポーネントをインストール
機能
このコンポーネントには、サイドバーに表示できるいくつかのブロックが含まれています:
- popular-tags
- top-contributors
- recent-replies
- category-topics
- custom-html
- category-list
- subcategory-list
- upcoming-events-list*
- minimal-gamification-leaderboard**
トップコントリビューター一覧が埋め込まれるには、ユーザーディレクトリを有効にする必要があります。一覧が空白の場合は、管理設定で
enable user directoryを検索して、有効になっていることを確認してください。
* Calendar プラグインと併用した場合のみ利用可能です。
** Gamification プラグインと併用した場合のみ利用可能です。
他の Ember コンポーネントをブロックとして使用することもできます。正しい名前を使用するだけです。例えば、コアには signup-cta という Ember コンポーネントが含まれており、そのままサイドバーで使用できます。パラメータのセットを期待するコンポーネントは使用できませんが、別のテーマで独自の Ember コンポーネントを作成し、サイドバーの blocks 設定でその名前だけで参照することは可能です。
提供されたブロックのいくつかの機能は、パラメータを通じて制御できます。
| 名前 | 説明 | デフォルト | 値 | 対象 |
|---|---|---|---|---|
count |
結果の数を制限 | 可変 | 数値 | custom-html 以外すべて |
excerptLimit |
各返信の抜粋の長さを制限 | 150 | 数値 | recent-replies |
id |
カテゴリ ID | カテゴリ ID（category-list はカンマ区切り） | category-topics, category-list | |
content |
表示する内容 | html | custom-html | |
scopeToCategory |
カテゴリまたはサブカテゴリ X のみ表示 | カテゴリ ID | popular-tags | |
excludedTags |
除外するタグのリスト | タグ名 | popular-tags | |
displayInSpecificCategories |
ウィジェットを表示するカテゴリのリスト | すべて | カンマ区切りの数値 | popular-tags |
id |
リーダーボード ID | 数値 | minimal-gamification-leaderboard | |
tag |
表示するタグ | タグ名 | tag-topics | |
period |
トップトピックの期間 | weekly | all, yearly, quarterly, monthly, weekly, daily | top-topics |
title |
ブロックのタイトル | 可変 | 文字列 | tag-topics, category-list, top-contributors |
excludedGroupNames |
指定されたグループを除外 | グループ名 | top-contributors | |
order |
コントリビューターを並べ替え | 文字列（likes_received または likes_given） | top-contributors | |
period |
トップコントリビューターの期間 | yearly | all, yearly, quarterly, monthly, weekly, daily | top-contributors |
upcomingDays |
指定値以前に開始されたイベント | 180 | 数値 | upcoming-events-list |
timeFormat |
イベントの日時フォーマット | LT | momentjs フォーマット | upcoming-events-list |
設定
| 名前 | 説明 |
|---|---|
| blocks | |
| show in routes | 上級者向け: 選択されたルートにサイドバーを制限します。 例: discovery.latest, discovery.unread, discovery.new, discovery.top, tag.show, “c/category-slug”（カテゴリ用）, “tag/sample-tag”（タグ用）。 空の場合、サイドバーはすべての一覧ルートに表示されます。 |
blocks: 表示するブロックを選択し、順序を調整します
show_in_routes: トピック一覧のどのルートでサイドバーを表示するかを決定します。デフォルトでは、/categories を除くすべての discovery ルートで表示されます。
| 翻訳 | デフォルト |
|---|---|
| top_contributors.heading | トップコントリビューター |
| top_contributors.view_all | すべて表示 |
| popular_tags.heading | 人気タグ |
| popular_tags.view_all | すべて表示 |
| recent_replies.heading | 最近の返信 |
| subcategory_list.heading | サブカテゴリ |
| top_topics.heading | トップトピック |
| category_list.heading | カテゴリ |
スクリーンショット
このコンポーネントは非常に基本的なスタイルのみが付属しており、管理者が独自のテーマで独自のスタイルを追加することを前提としています。
連携
Discourse Calendar プラグインと併用すると、今後のイベント用のサイドバーブロックを追加できます。ブロック名は upcoming-events-list で、日付フォーマットは この構文 に従ってカスタマイズできます（例: MMMM D, YYYY ）。
当社でホストされていますか？ テーマコンポーネントは、Pro、Business、Enterprise プランで利用可能です。