Как добавить заголовок X-TAGS в дайджест-письма для внешнего email-анализа (Netcore)?

emonunix · 10.Сентябрь.2025 20:19:40

Всем привет,

Я использую Discourse на собственном хостинге и ищу способ добавить пользовательский заголовок, а именно X-TAGS, в исходящие письма. Цель — интеграция с нашим поставщиком email-услуг (Netcore Email API) для улучшенной аналитики и отслеживания. Мы хотим иметь возможность помечать определённые типы писем, например еженедельную рассылку, для более детального анализа вовлечённости пользователей.

Проблема:

Мне нужно добавлять заголовок вида X-TAGS: Digest ко всем письмам, отправляемым в виде дайджеста. Этот заголовок предназначен для внутреннего отслеживания и будет удалён провайдером email-услуг перед доставкой, поэтому конечный пользователь его не увидит.

Что я уже исследовал:

Настройки сайта: Я просмотрел страницу /admin/site_settings/category/email и нашёл настройку «Пользовательские заголовки email». Однако, похоже, она добавляет статический заголовок ко всем письмам. Я не уверен, можно ли сделать это динамичным или применить только к определённому типу писем (например, к дайджесту).
Существующие темы на форуме: Я искал на форумах Discourse Meta и нашёл обсуждения о пользовательских заголовках, но они в основном касаются добавления тегов темы в тему письма или для фильтрации на стороне пользователя (например, в Gmail), а не для внешней email-аналитики. По-видимому, нет простого, официально документированного способа сделать это.

Мои вопросы:

Есть ли встроенный метод или конкретная настройка сайта, которую я упускаю, позволяющая добавить пользовательский заголовок, например X-TAGS, именно к письмам дайджеста?
Если нет, можно ли реализовать эту функцию с помощью пользовательского плагина?
Является ли изменение исходного кода ядра единственным решением, и если да, то могли бы вы направить меня в правильном направлении (например, указать, какие файлы стоит изучить)?

Любые советы или предложения будут очень кстати. Заранее благодарю за помощь!

selase · 12.Сентябрь.2025 14:31:39

Нет, это не поддерживается «из коробки», за исключением настройки сайта «email custom headers», которая применяется глобально ко всем исходящим письмам.

Да, в данном случае лучшим решением будет пользовательский плагин.

Текущий процесс для сводных писем выглядит следующим образом:

github.com/discourse/discourse

app/jobs/scheduled/enqueue_digest_emails.rb

d82fcb8af


      
          def execute(args)
            return if SiteSetting.disable_emails == "yes"
            return if SiteSetting.disable_digest_emails?
            return if SiteSetting.private_email?
          
            target_user_ids.each do |user_id|
              ::Jobs.enqueue(:user_email, type: "digest", user_id: user_id)
            end
          end

github.com/discourse/discourse

app/jobs/regular/user_email.rb

d82fcb8af

# frozen_string_literal: true

module Jobs
  # Asynchronously send an email to a user
  class UserEmail < ::Jobs::Base
    include Skippable

    sidekiq_options queue: "low"

    sidekiq_retry_in do |count, exception|
      # retry in an hour when SMTP server is busy
      # or use default sidekiq retry formula. returning
      # nil/0 will trigger the default sidekiq
      # retry formula
      #
      # See https://github.com/mperham/sidekiq/blob/3330df0ee37cfd3e0cd3ef01e3e66b584b99d488/lib/sidekiq/job_retry.rb#L216-L234
      case exception.wrapped
      when Net::SMTPServerBusy
        return 1.hour + (rand(30) * (count + 1))
      end

This file has been truncated. show original

github.com/discourse/discourse

app/mailers/user_notifications.rb

d82fcb8af


      
          def digest(user, opts = {})
            build_summary_for(user)
            @unsubscribe_key = UnsubscribeKey.create_key_for(@user, UnsubscribeKey::DIGEST_TYPE)
          
            @since = opts[:since].presence
            @since ||= [user.last_seen_at, user.user_stat&.digest_attempted_at, 1.month.ago].compact.max
          
            # Fetch some topics and posts to show
            digest_opts = {
              limit: SiteSetting.digest_topics + SiteSetting.digest_other_topics,
              top_order: true,
            }
            topics_for_digest = Topic.for_digest(user, @since, digest_opts)
            if topics_for_digest.empty? && !user.user_option.try(:include_tl0_in_digests)
              # Find some topics from new users that are at least 24 hours old
              topics_for_digest =
                Topic.for_digest(user, @since, digest_opts.merge(include_tl0: true)).where(
                  "topics.created_at < ?",
                  24.hours.ago,
                )

This file has been truncated. show original

github.com/discourse/discourse

lib/email/build_email_helper.rb

d82fcb8af

# frozen_string_literal: true

module Email
  module BuildEmailHelper
    def build_email(*builder_args)
      builder = Email::MessageBuilder.new(*builder_args)
      headers(builder.header_args) if builder.header_args.present?
      mail(builder.build_args).tap do |message|
        if message && h = builder.html_part
          message.html_part = h
        end
      end
    end
  end
end

github.com/discourse/discourse

lib/email/message_builder.rb

d82fcb8af

# frozen_string_literal: true

# Builds a Mail::Message we can use for sending. Optionally supports using a template
# for the body and subject
module Email
  class MessageBuilder
    attr_reader :template_args, :reply_by_email_key

    ALLOW_REPLY_BY_EMAIL_HEADER = "X-Discourse-Allow-Reply-By-Email"
    INSTRUCTIONS_SEPARATOR = "---\n"

    def initialize(to, opts = nil)
      @to = to
      @opts = opts || {}
      @template_args = {
        site_name: SiteSetting.title,
        email_prefix: SiteSetting.email_prefix.presence || SiteSetting.title,
        base_url: Discourse.base_url,
        user_preferences_url: "#{Discourse.base_url}/my/preferences",
        hostname: Discourse.current_hostname,

This file has been truncated. show original

Плагин может перехватить процесс построения сообщения (Email::MessageBuilder) и условно внедрить ваш пользовательский заголовок (предпочтительно через модификатор) только для сводных писем.

Тема		Ответов	Просм.
Customs email headers and/or subjects tags Feature	7	2783	08.01.2022
Add headers to all outgoing emails Self-hosting	2	806	23.10.2020
Adding custom content to summary emails Documentation email	14	5778	06.06.2023
How to show tags in the digest email? Support activity-summary	0	349	23.06.2021
Email: mail headers should have tags in them Feature	2	859	16.08.2014

Как добавить заголовок X-TAGS в дайджест-письма для внешнего email-анализа (Netcore)?

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