 |
概要 | 右サイドバーブロックは、トピックリストの右側に設定可能なブロックリストを表示するサイドバーを提供します。 |
 |
プレビュー | 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 |
トップトピックの期間 | 週間 | すべて、年間、四半期、月間、週間、日次 | top-topics |
title |
ブロックのタイトル | 変動 | 文字列 | tag-topics, category-list, top-contributors |
excludedGroupNames |
指定されたグループを除外 | グループ名 | top-contributors | |
order |
コントリビューターの順序 | 文字列（likes_receivedまたはlikes_given） | top-contributors | |
period |
トップコントリビューターの期間 | 年間 | すべて、年間、四半期、月間、週間、日次 | top-contributors |
includeSubcategories |
サブカテゴリイベントを含める | false | false, true | upcoming-events-list |
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）。 将来どれくらい先まで表示するか、およびサブカテゴリイベントを含めるかどうかも設定できます（上記の表を参照）
