Customs email headers and/or subjects tags

XioNoX · 25.Июнь.2014 20:24:01

Hi!

To be able to sort automatically notification emails sent by Discourse, it would be great if they could have customs headers (or a subject tag) based on the message’s content/content:

For example, here is a list of headers Bugzilla sends with each notification email:

X-Bugzilla-Reason: CC AssignedTo
X-Bugzilla-Type: dep_changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Classification: Other
X-Bugzilla-ID: 1014331
X-Bugzilla-Product: mozilla.org
X-Bugzilla-Component: Server Operations
X-Bugzilla-Version: other
X-Bugzilla-Keywords:
X-Bugzilla-Severity: normal
X-Bugzilla-Who: foobar@email.com
X-Bugzilla-Status: RESOLVED
X-Bugzilla-Resolution: FIXED
X-Bugzilla-Priority: –
X-Bugzilla-Assigned-To: email@email.com
X-Bugzilla-Target-Milestone: —
X-Bugzilla-Flags:
X-Bugzilla-OS: Linux
X-Bugzilla-Changed-Fields: Status Resolution
X-Bugzilla-Changed-Field-Names: bug_status resolution

Thanks!

downey · 25.Июнь.2014 20:55:25

See also our discussion at:

Where we’re hoping to get categories in a header.

downey · 09.Октябрь.2014 20:05:43

FYI, there is now a category-specific List-Id header sent along with unsubscribe headers, and the ability to add your own generic headers for all notifications with the email custom headers site setting.

llc1990 · 18.Август.2020 08:11:01

Для тех, кто интересуется, как настроить пользовательский заголовок электронной почты, вот инструкция.

Перейдите в Панель настроек >> Электронная почта или воспользуйтесь ссылкой ниже:
https://forums.example.com/admin/site_settings/category/email — замените доменное имя на свой собственный.
Найдите параметр email custom headers и задайте свои значения. Всё готово!

mattdm · 17.Декабрь.2020 23:38:45

Можно ли размещать в пользовательских заголовках такие элементы форматирования, как %{optional_pm}%{optional_cat}%{topic_title}?

mattdm · 05.Январь.2022 19:55:17

Для справки: я только что проверил это, и ответ таков: нет, расширения нет. Я получаю, например

X-Tags: %{optional_tags}

simon · 08.Январь.2022 01:03:28

Я не вижу в коде места, где что-то вроде %{optional_tags} подставлялось бы в заголовок, добавленный в настройку сайта «email custom headers». То, что я нахожу, — это метод, используемый для установки значения пользовательских заголовков:

github.com/discourse/discourse

lib/email/sender.rb

main


      
                     !@stripped_secure_upload_shas.include?(optimized_1X&.sha1)
                 )
              return
            end
            if (optimized_1X&.filesize || upload.filesize) >
                 SiteSetting.secure_uploads_max_email_embed_image_size_kb.kilobytes
              return
            end
            true
          end
          
          #
          # Two behaviors in the mail gem collide:
          #
          #  1. Attachments are added as extra parts at the top level,
          #  2. When there are both text and html parts, the content type is set
          #     to 'multipart/alternative'.
          #
          # Since attachments aren't alternative renderings, for emails that contain
          # attachments and both html and text parts, some coercing is necessary.
          #

Он вызывается из:

github.com/discourse/discourse

lib/email/sender.rb

main


      
            # to the array of values for the header.
            @message.header[key] = nil
            @message.header[key] = our_value
          end
          
          value = header_value(key)
          
          # Remove Auto-Submitted header for group private message emails, it does
          # not make sense there and may hurt deliverability.
          #
          # From https://www.iana.org/assignments/auto-submitted-keywords/auto-submitted-keywords.xhtml:
          #
          # > Indicates that a message was generated by an automatic process, and is not a direct response to another message.
          @message.header[key] = nil if key.downcase == "auto-submitted" && smtp_group_id
          
          # Replace reply_key in custom headers or remove
          if value&.include?("%{reply_key}")
            # Delete old header first or else the same header will be added twice
            @message.header[key] = nil
            @message.header[key] = value.gsub!("%{reply_key}", reply_key) if reply_key.present?
          end

Я постараюсь получить у команды Discourse больше деталей о том, как предполагается использовать эту настройку и какие значения могут подставляться в пользовательские заголовки.

mattdm · 08.Январь.2022 16:31:12

@simon Сравните

github.com/discourse/discourse

lib/email/message_builder.rb

c0d72ec3d


      
                # No point in adding a reply-to header if it is going to be identical
                # to the from address/alias. If the from option is not present, then
                # the default reply-to address is used.
                result['Reply-To'] = from_value if from_value != alias_email(@opts[:from])
              end
            end
          
            result.merge(MessageBuilder.custom_headers(SiteSetting.email_custom_headers))
          end
          
          def self.custom_headers(string)
            result = {}
            string.split('|').each { |item|
              header = item.split(':', 2)
              if header.length == 2
                name = header[0].strip
                value = header[1].strip
                result[name] = value if name.length > 0 && value.length > 0
              end
            } unless string.nil?
            result

с

github.com/discourse/discourse

lib/email/message_builder.rb

c0d72ec3d


      
                elsif SiteSetting.unsubscribe_via_email_footer
                  "unsubscribe_link_and_mail"
                else
                  "unsubscribe_link"
                end
                @template_args[:unsubscribe_instructions] = I18n.t(unsubscribe_string, @template_args)
              end
            end
          end
          
          def subject
            if @opts[:template] &&
                TranslationOverride.exists?(locale: I18n.locale, translation_key: "#{@opts[:template]}.subject_template")
              augmented_template_args = @template_args.merge({
                site_name: @template_args[:email_prefix],
                optional_re: @opts[:add_re_to_subject] ? I18n.t('subject_re') : '',
                optional_pm: @opts[:private_reply] ? @template_args[:subject_pm] : '',
                optional_cat: @template_args[:show_category_in_subject] ? "[#{@template_args[:show_category_in_subject]}] " : '',
                optional_tags: @template_args[:show_tags_in_subject] ? "#{@template_args[:show_tags_in_subject]} " : '',
                topic_title: @template_args[:topic_title] ? @template_args[:topic_title] : '',
              })

Здесь есть некоторая сложность с шаблонами по сравнению с настройкой email_subject, которую я до конца не понимаю — похоже, что последняя не используется, если есть шаблон, но я не уверен, когда шаблона нет! Но aside от этого, главное в том, что если бы функция, создающая пользовательские заголовки, использовала тот же шаблон, это сработало бы, и пользовательские заголовки могли бы содержать полезную динамическую информацию.

Тема		Ответов	Просм.
Show categories in e-mail notifications Feature	51	8950	13.09.2017
Add email header to distinguish reply emails from other emails Feature email	1	681	06.05.2024
Email: mail headers should have tags in them Feature	2	859	16.08.2014
Headers for email notifications so that Gmail users can filter on tags? Feature notifications , email	18	1924	09.01.2023
Subscription emails should carry more context in message body Feature	6	3314	04.12.2025

Customs email headers and/or subjects tags

Связанные темы