カスタムテキストおよびシステムメールテンプレートのカスタマイズ用補間キー

ドキュメント サイト管理
1

:bookmark: このガイドでは、Discourse のテキストおよびシステムメールテンプレートのカスタマイズに使用される補間キーの詳細な概要を説明します。

:person_raising_hand: 必要なユーザーレベル: 管理者

Discourse のテキストのカスタマイズ または 特定のメールテンプレートのカスタマイズ の際に、一部のテンプレートでプレースホルダー変数を利用できることに気づいたかもしれません。

Discourse では、これらを補間キーと呼びます。

補間キーの理解

補間キーは、特定の Discourse テンプレートで利用可能なプレースホルダーです。これにより、テキストおよびメールテンプレートに動的なコンテンツを挿入できます。

アカウント作成済み メールテンプレートの補間キーの例:

image
image1705×681 59.3 KB

%{username} や %{site_name} などのこれらのキーは、メール送信時に実際のデータに置き換えられます。

一般的に、これらのプレースホルダーは所属するテンプレート内で移動できますが、サーバーコードによって対応するテンプレートに紐付けられているため、そのテンプレートでのみ利用可能であり、異なるテンプレートに移動することはできません。

ただし、テキストおよびメールテンプレートで利用できる追加の補間キーがいくつかあります。

一般的な補間キー

以下は、すべてのメールテンプレートで使用できる一般的な補間キーのリストです。

  • username: ユーザーのユーザー名
  • name: ユーザーのフルネーム
  • name_or_username: ユーザーのフルネームまたはユーザー名

また、subject_template および text_body_template のサブキーを持つ限り、すべての system_messages.welcome_user キーをテキストおよびメールテンプレートのカスタマイズで使用できます。これは、すべて SystemMessage クラスによって処理されるべきだからです (関連する Discourse コードについては、system_message.rb を参照してください)。

許可されているカスタム補間キーの完全なリストについては、translation_override.rb の Discourse ソースコード の ALLOWED_CUSTOM_INTERPOLATION_KEYS を参照してください。

「いいね！」 9
2

それは正しくありません。現在、それは system_messages.welcome_user のみに有効ですが、他のすべてのキーに拡張することは可能です。これは pr-welcome 対象です。

「いいね！」 4
3

ご指摘ありがとうございます。ガイドを更新しました。

「いいね！」 2
4

こんにちは！

これらの補間キーの値はどのように変更できますか？たとえば、%{search_answer} です。

よろしくお願いします！

5

こんにちは！
このキーは無効であると表示されます。

image
image925×819 42.9 KB

追伸
メールではなくテキストを置き換えています（違いはありますか）？よろしくお願いします！

6

それらはグローバルではなく、どこでも無料で利用できるものではないと思います。

「いいね！」 1
7

@Jagster さん、ありがとうございます！テキストのカスタマイズで使用していますが、トピック投稿によると、機能するはずですよね？

8

トピックは実際にはメールテンプレートとそのテキストに関するものです。そのため、適切なコンテキスト外で補間キーを使用することはできません。そのため、メール用の他のキー、AIプロンプト用の他のキーなどがあります。

確かに、プラグインは多くのことができますが、今回はすぐに使えるものではありません。

免責事項：私は単なるエンドユーザーであり、ひどく間違っている可能性もあります。しかし、私は自分が正しいと確信しています。だからこそ、あなたの試みはうまくいかないのです🤷‍♂️

9

サポートいただき、誠にありがとうございます。メールテンプレートで使用しても機能していないようです。

image
image822×479 19.7 KB

10

%{username} は「User did…」テンプレートで使用でき、他のすべてのテンプレートではサポートされないというのが私の予想です。

しかし、明日、すべての専門家が目を覚ましたらわかるでしょう。