||||
-|-|
| 概要 | Category Banners は、既存のカテゴリ情報を活用して、カテゴリページ用のバナーを作成します(タグ用のバナーについては、Discourse Tag Banners をご覧ください)。
|
| プレビュー | Discourse Theme Creator でのプレビュー |
| リポジトリリンク | https://github.com/discourse/discourse-category-banners
|Discourse テーマが初めての方へ | Discourse テーマの使用方法に関する初心者ガイド
このテーマコンポーネントをインストール
機能
Category Banners は、既存のカテゴリ情報を使用して、カテゴリページ用のバナーを作成します。カテゴリ名、説明文、色を使用して、関連するカテゴリページの上部にバナーを生成します(タグ用のバナーについては、Discourse Tag Banners をご覧ください)。
カテゴリの説明文は、各カテゴリの「… 用のカテゴリ定義」トピック内の最初の段落で定義されます。バナーの背景色/文字色は、カテゴリバッジの設定によって定義されます。
デフォルトでは、これはデスクトップとモバイルの両方で、すべてのカテゴリページとサブカテゴリページに表示されますが、カテゴリに説明文が設定されていない場合は表示されません。
設定
このコンポーネントには、デフォルトを上書きするためのオプションが用意されています:
| 名前 | 説明 |
|---|---|
| show description | 「このカテゴリについて」投稿からの説明文を表示 |
| show mobile | モバイルでバナーを表示 |
| show subcategory | サブカテゴリのバナーを表示 |
| hide if no description | カテゴリの説明文が設定されていない場合、バナーを非表示にする |
| show category logo | カテゴリロゴを表示 |
| align text | |
| exceptions | これらのカテゴリ名に対してバナーを表示しない |
| categories | バナーを表示するカテゴリ |
| plugin outlet | ページ上のバナーの位置を変更 |
| show category icon | カテゴリ設定からカテゴリアイコンまたは絵文字を表示 * |
| override category icon color | カテゴリアイコンが使用される場合、これを有効にすると、アイコンがバナーの文字色に一致します |
* 注:この設定は、カテゴリ設定で設定されたカテゴリアイコンまたは絵文字 を参照するようになりました。これは、コア機能に取って代わられた Category Icons テーマコンポーネントではありません。
カスタマイズに関するノート
追加の CSS でカスタマイズしたい場合は、次の構造を使用して特定のカテゴリヘッダーを対象とすることができます(example-category はカテゴリ名):
.category-title-header {
&.category-banner-example-category {
background: url(example.jpg);
}
}
このコンポーネントは、追加の CSS ターゲットとして、body タグに category-header クラスも追加します。
ホスティングサービスをご利用ですか? テーマコンポーネントは、当社の Standard、Business、Enterprise プランでご利用いただけます。
