まず、この点について明確にしておきましょう。
これは正しくありません。テーマ内で変更を加えた場合、アップデートしても変更は失われません。それらは永続的に保持されます。変更が失われる唯一のケースは、サーバー上のファイルを直接編集した場合ですが、それは明らかに避けるべき行為です。
ただし、テンプレートをオーバーライドすることには一定のリスクが伴います。コアのアップデートにより、変更が互換性を失い、更新が必要になる可能性があるためです。そのリスクを許容できるのであれば、技術的にはここで求められていることが実現可能です。
まず、ユーザーがホームページにいるかどうかを区別する方法が必要です。カテゴリ専用コンポーネントの場合、searchContext を確認する方法があります。サブカテゴリページにいる場合、検索コンテキストは “category” に設定されます。検索コンテキストが存在しない場合は、ユーザーがホームページにいることを意味します。
これをテンプレートに渡すには、以下のようなコードを追加します。
<script type="text/discourse-plugin"
version="0.8">
const categoriesOnlyComponent = require('discourse/components/categories-only').default;
categoriesOnlyComponent.reopen({
isHomepage: function() {
return !this.parentView.searchService.contextType
}.property()
});
</script>
これにより、categories-only テンプレート内で isHomepage を使用できるようになります。検索コンテキストが存在しない場合（つまり、ユーザーがホームページにいる場合）は true を返し、それ以外は false を返します。
次に、デフォルトのテンプレートを以下のようにコピーします。
<script type='text/x-handlebars'
data-template-name='components/categories-only'>
{{#if categories}}
... テンプレートの残りの部分
{{/if}}
</script>
そして、先ほど追加した isHomepage を使用します。そのためには、Handlebars の {{#if}} ヘルパーを使用する必要があります。 essentially、以下のようなコードが必要です。
<script type='text/x-handlebars'
data-template-name='components/categories-only'>
{{#if categories}}
{{#if isHomepage}}
... ホームページ専用のテンプレート
{{else}}
... ホームページでない場合のデフォルトテンプレートの残りの部分
{{/if}}
</script>
isHomepage セクション内では、任意の内容を使用できます。その場で編集することも、以下のようにより新しいテンプレートを作成することも可能です。
<script type='text/x-handlebars'
data-template-name='components/categories-only-homepage'>
<h1>あなたはホームページにいます！</h1>
<p>
ユーザーがホームページにいる場合に、カテゴリ専用コンポーネントのテンプレートをレンダリングするためにこのセクションを使用してください。
</p>
</script>
最後に、categories-only テンプレート内の isHomepage セクションで、そのテンプレートをパーシャルとして呼び出す必要があります。
<script type='text/x-handlebars'
data-template-name='components/categories-only'>
{{#if categories}}
{{#if isHomepage}}
{{partial 'components/categories-only-homepage'}}
{{else}}
... ホームページでない場合のデフォルトテンプレートの残りの部分
{{/if}}
</script>
その結果、ホームページを訪問すると以下のような表示になります。
ただし、サブカテゴリのコンポーネントは変更されずに残ります。
これはオプションですが、以下のリンクも参考になるかもしれません。
これは、テーマを扱う際の新しい推奨方法であり、<script> タグの使用を避けるためのものです。