Wie man benutzerdefinierte X-TAGS-Header zu Digest-E-Mails für externe E-Mail-Analysen (Netcore) hinzufügt

emonunix · 10. September 2025 um 20:19

Hallo zusammen,

ich bin ein Self-Hosting-Discourse-Nutzer und suche nach einer Möglichkeit, einen benutzerdefinierten Header, speziell X-TAGS, zu unseren ausgehenden E-Mails hinzuzufügen. Ziel ist die Integration mit unserem E-Mail-Dienstanbieter (Netcore Email API) für bessere Analysen und Tracking. Wir möchten bestimmte E-Mail-Typen, wie den wöchentlichen Digest, markieren, um eine detailliertere Ansicht unseres E-Mail-Engagements zu erhalten.

Problem:

Ich muss einen Header wie X-TAGS: Digest zu allen E-Mails hinzufügen, die als Digest versendet werden. Dieser Header dient internen Tracking-Zwecken und wird vom E-Mail-Anbieter vor der Zustellung entfernt, sodass er für den Endbenutzer nicht sichtbar ist.

Was ich bereits untersucht habe:

Site-Einstellungen: Ich habe die Seite /admin/site_settings/category/email durchsucht und die Einstellung email custom headers gefunden. Diese scheint jedoch einen statischen Header zu allen E-Mails hinzuzufügen. Ich bin mir nicht sicher, ob es möglich ist, diesen dynamisch zu gestalten oder nur auf eine bestimmte E-Mail-Art (wie den Digest) anzuwenden.
Bestehende Forenbeiträge: Ich habe die Discourse Meta-Foren durchsucht und einige Diskussionen über benutzerdefinierte Header gefunden, die sich jedoch meist auf das Hinzufügen von Themen-Tags zur E-Mail-Betreffzeile oder für die Filterung auf Benutzerseite (z. B. in Gmail) konzentrieren, nicht für externe E-Mail-Analysen. Es scheint keine einfache, offiziell dokumentierte Methode dafür zu geben.

Meine Fragen sind:

Gibt es eine integrierte Methode oder eine bestimmte Site-Einstellung, die ich übersehen habe und die es mir ermöglichen würde, einen benutzerdefinierten Header wie X-TAGS speziell für Digest-E-Mails hinzuzufügen?
Wenn nicht, ist dies eine Funktion, die mit einem benutzerdefinierten Plugin realisiert werden könnte?
Wäre die Änderung des Kerncodes die einzige Lösung, und wenn ja, könnten Sie mir in die richtige Richtung weisen (z. B. welche Dateien ich mir ansehen sollte)?

Jeder Hinweis oder Vorschlag wäre sehr willkommen. Vielen Dank im Voraus für Ihre Hilfe!

selase · 12. September 2025 um 14:31

Nein, dies wird nicht standardmäßig unterstützt, abgesehen von der Website-Einstellung email custom headers, die global für alle ausgehenden E-Mails gilt.

Ja, ein benutzerdefiniertes Plugin wäre hier der beste Ansatz.

Der aktuelle Ablauf für Digest-E-Mails ist wie folgt:

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

Ein Plugin könnte sich in den E-Mail-Erstellungsprozess (Email::MessageBuilder) einklinken und Ihren benutzerdefinierten Header bedingt (vorzugsweise über einen Modifier) nur für Digests einfügen.

Thema		Antworten	Aufrufe
Customs email headers and/or subjects tags Feature	7	2718	8. Januar 2022
Add headers to all outgoing emails Installation	2	789	23. Oktober 2020
How to show tags in the digest email? Support activity-summary	0	336	23. Juni 2021
Email: mail headers should have tags in them Feature	2	842	16. August 2014
Force topics into email digest via tags? Feature activity-summary	1	486	20. Juli 2021

Wie man benutzerdefinierte X-TAGS-Header zu Digest-E-Mails für externe E-Mail-Analysen (Netcore) hinzufügt

Verwandte Themen