 |
概要 | Versatile Banner は、サイトのカスタマイズ可能なバナーを追加します。 |
 |
プレビュー | Discourse Theme Creator でのプレビュー |
 |
リポジトリリンク | https://github.com/discourse/discourse-versatile-banner |
 |
Discourse テーマが初めてですか？ | Discourse テーマの使用に関する初心者ガイド |
このテーマコンポーネントをインストール
機能
このテーマコンポーネントは、以前のバナー機能の進化版です。テーマ設定の使用により、より容易で柔軟な提供を目指しています。
以下は機能のハイライトです：
- ログインユーザーまたは匿名ユーザーへの表示を制限
- モバイルまたはデスクトップのみに表示を制限
- 特定のページへの表示を制限
- 閉じる、展開、常に表示のオプション
- ブラウザの全幅表示オプション
- 色の管理
- HTML を使用した見出しと列のカスタマイズ（以下参照）
- 永続的な状態のオプション（以下参照）
バナーコンテンツのカスタマイズ
バナーコンテンツは、メインの見出しと列に分かれています。バナーには最大 5 列まで設定できますが、幅の制限のため、推奨される列数は 3 列以下です。HTML テンプレートが提供されており、個々のニーズに合わせてカスタマイズできます。各列の幅を制御し、各列の上部に任意の画像や Font Awesome アイコンを追加することもできます。
永続的な状態オプションの使用
永続的な状態オプションは、最大 2 つの Cookie に依存します。これらの Cookie には、バナーの名前と、バナーの状態に関連する true/false の値が含まれます。サイトで Cookie を使用することに懸念がある場合は、この設定の使用を避けるのが最も安全です。cookie_lifespan 設定に対して相対的な時間のオプションを選択すると、ユーザーが適切なボタンを押した後に、その期間中バナーが閉じられたまま/展開されたまま/折りたたまれたままになるようにします。この設定がない場合、バナーは完全なページ読み込みのたびにリセットされます。バナーに変更を加え、以前にバナーを閉じていたユーザーを含むすべてのユーザーに変更を確認させたい場合は、「cookie name」を変更してください。これにより、永続的な状態がリセットされ、ユーザーが再度バナーを閉じることができます。
設定
| 名前 | 説明 |
|---|---|
| メンバーに表示 | フォーラムにログインしているユーザーにバナーを表示 |
| 匿名ユーザーに表示 | 匿名ユーザーにバナーを表示 |
| モバイルに表示 | モバイルデバイスにバナーを表示 |
| デスクトップに表示 | デスクトップコンピュータにバナーを表示 |
| ホームページに表示 | ホームページにバナーを表示 |
| URL に次の文字列が含まれる必要がある | バナーを表示するパスを入力します。パスの末尾に * を追加してワイルドカードとして使用 |
| 閉じ可能 | ユーザーがバナーを閉じられるようにする |
| 折りたたみ可能 | ユーザーがバナーを展開および折りたたみできるようにする |
| デフォルトの折りたたみ状態 | 折りたたみ可能設定が有効な場合のデフォルトの折りたたみ状態 |
| Cookie の存続期間 | バナーが閉じられたか、展開されたか、折りたたまれたかを記憶するために使用される Cookie の存続期間。「none」に設定すると、このコンポーネントでは Cookie が一切使用されず、バナーに関連する以前に作成されたすべての Cookie は、ユーザーが次の完全なページ読み込みを実行したときに削除されます。値は単一の単位として測定されるため、「year」を設定すると 1 年、「week」を設定すると 1 週間などとなります。 |
| Cookie 名 | バナーに重要な変更が加えられた場合、すべてのユーザーに変更を確認させるために Cookie 名を変更する必要があります。 |
| 全幅バナー | バナーをブラウザの全幅で表示 |
| デフォルトの配置を切り替え | 他のバナー関連コンポーネントがアクティブな場合、これを使用して Versatile Banner との位置を切り替えます |
| プラグインアウトレット | below-site-header はサイドバーの上に配置し、above-main-container はサイドバーの横のコンテンツの上に配置します |
| バナーの背景画像 | 背景画像のソース URL。ヒント：メインテーマに画像をアップロードし、その URL を使用できますが、このコンポーネントの「Uploads」セクションは使用しないでください。このコンポーネントに追加されたアップロードは、コンポーネントが更新されるたびに削除されます。 |
| バナーの背景画像（ダークモード） | システムのダークモードが検出されたときの背景画像のソース URL。 |
| 背景色 | 背景画像の代わりに使用 |
| 背景色（ダークモード） | システムのダークモードが検出されたときに、背景画像の代わりに使用 |
| メインテキストの色 | バナーのメインテキストの色 |
| メインテキストの色（ダークモード） | システムのダークモードが検出されたときのバナーのメインテキストの色 |
| サブテキストの色 | アイコンとテキストの見出し、およびボタンの背景色のテキストの色。 |
| サブテキストの色（ダークモード） | システムのダークモードが検出されたときの、アイコンとテキストの見出し、およびボタンの背景色のテキストの色。 |
| リンクテキストの色 | バナー内のリンクのテキストの色 |
| リンクテキストの色（ダークモード） | システムのダークモードが検出されたときの、バナー内のリンクのテキストの色。 |
| 翻訳 | デフォルト |
|---|---|
| close.title | バナーを閉じる |
| close.label | 閉じる |
| toggle.title | バナーを展開/折りたたむ |
| toggle.collapse_label | 折りたたむ |
| toggle.expand_label | 展開 |
当社でホストしていますか？テーマコンポーネントは、Pro、Business、Enterprise プランでご利用いただけます。
当社でホストしていますか？テーマコンポーネントは、Pro、Business、Enterprise プランでご利用いただけます。