理想的には、Discourse をテーマやプラグインでカスタマイズする際、CSS、JavaScript プラグイン API 、またはプラグインアウトレット を使用すべきです。これらがあなたのユースケースに当てはまらない場合は、Discourse コアへの PR を開くか、Meta の Development
他のすべての選択肢が尽きた場合、テンプレートオーバーライドに頼る必要があるかもしれません。このテクニックにより、テーマ/プラグインから任意の Ember コンポーネントまたはルートのテンプレート全体をオーバーライドできます。
これは Discourse をカスタマイズする推奨されない方法です。 Discourse コアの日々の変更は、最終的にあなたのテンプレートオーバーライドと競合し、フォーラムのレンダリング時に深刻なエラーを引き起こす可能性があります。
このアプローチを採用する場合は、リグレッションを検出するための十分な自動テストと QA プロセスを持っていることを確認してください。テンプレートオーバーライドを含むテーマ/プラグインを配布する場合は、フォーラム管理者があなたのテーマ/プラグインが抱える安定性のリスクを理解していることを確認してください。
2023年10月更新 : 新しい機能について、Discourse はますます Ember の .gjs ファイル形式で作成されたコンポーネントの使用に移行しています。これらのコンポーネントのテンプレートはインラインで定義されており、テーマ/プラグインによってオーバーライドすることはできません。
今後、すべてのテンプレートカスタマイズは Plugin Outlets を使用して行うべきです。
近いうちにこれが壊れることは理解しているが、とにかくドキュメントを見せて
Ember コンポーネントのテンプレート（つまり、Discourse コアの components/*.hbs ファイルを作成する必要があります。例えば、Discourse コアの badge-button コンポーネントのテンプレートをオーバーライドするには、テーマ/プラグイン内の以下の場所にテンプレートファイルを作成します:
{theme}/javascripts/discourse/templates/components/badge-button.hbs
{plugin}/assets/javascripts/discourse/templates/components/badge-button.hbs
コアのコンポーネントが「同置（colocated）」テンプレートを持っていた場合でも、オーバーライドは常に /templates ディレクトリ内にネストされていなければなりません。
ルートテンプレート（つまり、templates/*discovery.hbs をオーバーライドするには、次のようなファイルを作成します:
{theme}/javascripts/discourse/templates/discovery.hbs
{plugin}/assets/javascripts/discourse/templates/discovery.hbs
複数のインストールされたテーマ/プラグインが同じテンプレートをオーバーライドする場合、「勝者」となるのは、以下のリストの中で最も低い番号のランキングを持つものです:
テーマのオーバーライド（最も大きいテーマの ‘id’ が勝つ）
プラグインのオーバーライド（アルファベット順で最も新しいプラグイン名が勝つ）
コア
この優先順位により、テーマからプラグインのテンプレートをオーバーライドすることもできます。技術的には、他のテーマからテーマのテンプレートを、または他のプラグインからプラグインのテンプレートをオーバーライドすることもできますが、プラグイン名とテーマ ID への依存関係により、動作が予測しにくい場合があります。
Discourse は DiscourseTemplateMap クラス内でテンプレートを組み立て、優先順位付けを行います。同置コンポーネントテンプレートの場合、その情報はアプリ初期化中 に使用され、コアのテンプレート関連付けが置き換えられます。その他のすべてのテンプレートについては、マップが実行時のリゾルバー によって使用され、正しいテンプレートを取得するために使用されます。
このドキュメントはバージョン管理されています - 変更提案は github で。
「いいね！」 17
misham
2022 年 12 月 7 日午後 3:44
2
モバイルテンプレートについてはどうですか？コアのテンプレートを書き直すためのディレクトリ構造は何ですか？
david
2022 年 12 月 7 日午後 3:47
3
それは全く同じように機能するはずです。コアテンプレートの名前を一致させます。したがって、/mobile がある場合は、オーバーライドに含めてください。
misham
2022 年 12 月 14 日午前 10:42
4
モバイルの login.hbs テンプレートを書き直そうとしていますが、うまくいきません Imgur: The magic of the Internet
david
2022 年 12 月 14 日午前 11:18
5
スクリーンショットでは、完全なパスが表示されていないように見えます。テキストとしてここに貼り付けていただけますか。
misham
2022 年 12 月 14 日午後 12:00
6
themeroot/javascripts/mobile/modal/login.hbs
david
2022 年 12 月 14 日午後 12:03
7
パスにdiscourse/templatesがありません
David Taylor:
ルートテンプレートの上書き
ルートテンプレート（つまり、templates/*discovery.hbsを上書きするには、次のようなファイルを作成します。
{theme}/javascripts/discourse/templates/discovery.hbs
したがって、この場合は{theme}/javascripts/discourse/templates/mobile/modal/login.hbsになります。
「いいね！」 2
これはまだ当てはまりますか？
多くのコードを上書きする機能が削除されるのは少し残念です。
Widget システムをある程度置き換えるのは理にかなっていますが、これにより複数のレベルで既存のコードにフックすることができ、次のようなことを可能にする巧妙な方法で小さなブロックのみを対象とすることで、多くの破壊的変更のリスクを軽減できました。
たとえば、Discourse Journal から 2 つの重要な機能を削除しなければなりませんでした。これはウィジェットのきめ細かなオーバーライドに基づいていたためですが、Glimmer でそれらを再作成する唯一の方法は、テンプレートのオーバーライドのペア (.gjs ファイルの変更を試みるものを含む) を介して行うことでしたが、これはサポートされなくなったようです。
たとえこれがサポートされていたとしても、ウィジェットフレームワークの下よりも大きなコードのストレッチをオーバーライドすることになり、コアの変更がオーバーライドと競合するリスクが増加します。
これはプラットフォームの拡張性にとって健全ではありません。
何かできることはありますか？
「いいね！」 7
david
2024 年 3 月 7 日午後 1:17
13
ええ、わかります。ウィジェットの拡張性APIには良い点もありました。
しかし、その一方で、ウィジェットベースのUIのコア部分を少しでも変更するのが非常に困難でした。なぜなら、人々がどのようなランダムなメソッドやデコレーションを導入しているかわからなかったからです。そのため、ウィジェットのカスタマイズは比較的安定しているように見えました。コアの実装に触れるのが怖すぎたのです。
今後のための私たちの解決策は、Wrapper Plugin Outlets です。これらは、テーマやプラグインがテンプレートの非常に小さなチャンクを独自のインプリメンテーションでオプションでオーバーライドできるようにします。
例えば、Chatがどのように条件付きでホームロゴをオーバーライドしているか を見てください。カスタムコンポーネント で。これは、既存のウィジェットベースのヘッダーと、新しいGlimmerベースのヘッダー（近日公開予定！
私たちは、さまざまな場所に新しいラッパーアウトレットを追加するPRを一般的に受け入れています。特定のユースケースについて不明な点がある場合は、お気軽に詳細を添えて#devトピックを開いてください！
「いいね！」 10
わかりました、それは前進するための方法のようですね。ありがとうございます。
その影響を消化し、それに沿った戦略に調整する必要があります。
ご回答に感謝します！
「いいね！」 6
これは Discourse をカスタマイズする推奨されない方法です。 Discourse コアの日々の変更は、最終的にあなたのテンプレートオーバーライドと競合し、フォーラムのレンダリング時に深刻なエラーを引き起こす可能性があります。
）の両方で機能します。