I’m looking at the new user onboarding flow, and that has led me to the system_messages.welcome_user.text_body_template, which uses %{new_user_tips}, among other macros. I’m struggling to find where these value are set.

[image] G Ann Campbell: I’m struggling to find where these value are set. It is not apparent to me, either! Fortunately someone referred to that exact macro before: [image]Where the welcome email template is used Now, there is a key in Transifex named system_messages.usage_tips.text_body_template. Its content is pushed into the above to replaced the %{new_user_tips}. As for where it is used, /admin/customize/site_texts?locale=en&q=%25{new_user_tips} shows a few templates: [Screenshot 2024-02-14 at 11-19-17 Admin - fnord] I’ve never seen another macro that pull into the content from another content template in Discourse. :slight_smile:

I… still don’t understand What / where is ‘Transifex’? And also, without asking here, how would I know that %{new_user_tips} == system_messages.usage_tips.text_body_template

[image] G Ann Campbell: What / where is ‘Transifex’? Transifex is our system for people contributing translations for localisation. You don’t need to worry about that and can pretend it doesn’t exist. [image] G Ann Campbell: I’m struggling to find where these value are set. But this is a good question - most of the below are (I think) self-evident except for new_user_tips. In any case it might be a good idea to have an ⓘ explanation nearby. Available interpolation keys: site_name, new_user_tips, base_url, username, name, name_or_username You’d have to go digging into the code to find system_messages.usage_tips.text_body_template. This is something that could definitely be improved so it’s apparent in the editor.

I think the values are set here: lib/system_message.rb main post end def defaults { site_name: SiteSetting.title, username: @recipient.username, name: @recipient.name, name_or_username: @recipient.name.presence || @recipient.username, user_preferences_url: "#{@recipient.full_url}/preferences", new_user_tips: I18n.with_locale(@recipient.effective_locale) do I18n.t("system_messages.usage_tips.text_body_template", base_url: Discourse.base_url) But I agree that it would be welcome to see a note about it somewhere.

What do macros decode to?

Product Support

ganncamp (G Ann Campbell) February 15, 2024, 12:36pm 8

Thanks @Arkshine! That’s helpful!

And… That block is named defaults, implying that they can be changed to point to other values…?

Topic		Replies	Views
Where the welcome email template is used Translations	2	1845	April 16, 2019
Interpolation Keys for Customizing Text and System Email Templates Site Management explanation	9	1391	November 19, 2024
Invalid Interpolation Key Product Support	3	995	December 4, 2019
The following interpolation key is invalid: name Product Support	10	1161	May 13, 2023
Customizing specific system email templates Site Management email , how-to	8	13859	November 3, 2025

What do macros decode to?

Related topics