| 概要 | 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 ターゲットとして category-header クラスを body タグに追加します。
当社でホストされていますか? テーマコンポーネントは、Standard、Business、Enterprise プランで利用可能です。
