Hoe voeg ik een aangepaste X-TAGS-header toe aan digest-e-mails voor externe e-mailanalyse (Netcore)?

emonunix · 10 september 2025 om 20:19

Hallo allemaal,

Ik ben een self-hosted Discourse-gebruiker en ik zoek naar een manier om een aangepaste header, specifiek X-TAGS, toe te voegen aan onze uitgaande e-mails. Het doel is om te integreren met onze e-mailserviceprovider (Netcore Email API) voor betere analyses en tracking. We willen bepaalde soorten e-mails, zoals het wekelijkse digest, kunnen taggen voor een gedetailleerder inzicht in onze e-mailbetrokkenheid.

Probleem:

Ik moet een header zoals X-TAGS: Digest toevoegen aan alle e-mails die als digest worden verzonden. Deze header is voor interne tracking en wordt door de e-mailprovider verwijderd vóór levering, dus deze zal niet zichtbaar zijn voor de eindgebruiker.

Wat ik al heb onderzocht:

Site-instellingen: Ik heb de pagina /admin/site_settings/category/email bekeken en de instelling email custom headers gevonden. Het lijkt er echter op dat deze een statische header toevoegt aan alle e-mails. Ik weet niet zeker of het mogelijk is om dit dynamisch te maken of om het alleen toe te passen op een specifiek type e-mail (zoals de digest).
Bestaande forumonderwerpen: Ik heb de Discourse Meta-forums doorzocht en enkele discussies over aangepaste headers gevonden, maar deze richten zich voornamelijk op het toevoegen van onderwerp-tags aan de onderwerpregel van de e-mail of voor filtering aan de gebruikerszijde (bijv. in Gmail), niet voor externe e-mailanalyses. Er lijkt geen eenvoudige, officieel gedocumenteerde manier te zijn om dit te doen.

Mijn vragen zijn:

Is er een ingebouwde methode of een specifieke site-instelling die ik over het hoofd zie, waarmee ik een aangepaste header zoals X-TAGS specifiek aan digest-e-mails kan toevoegen?
Zo niet, is dit een functie die met een aangepaste plugin kan worden bereikt?
Zou het aanpassen van de kerncode de enige oplossing zijn, en zo ja, kunt u mij in de juiste richting wijzen (bijv. naar welke bestanden ik moet kijken)?

Elke begeleiding of suggestie wordt zeer op prijs gesteld. Alvast bedankt voor uw hulp!

selase · 12 september 2025 om 14:31

No, this isn’t supported out of the box, aside from the email custom headers site setting which applies globally to all outgoing emails.

Yes, a custom plugin would the best approach here.

The current flow for digest emails, is as follows:

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

A plugin could hook into the message building process (Email::MessageBuilder) and inject(preferably via a modifier) your custom header conditionally, only for digests.

Topic		Antwoorden	Weergaven
Customs email headers and/or subjects tags Feature	7	2718	8 januari 2022
Add headers to all outgoing emails Installation	2	789	23 oktober 2020
Adding custom content to summary emails Documentation email	14	5661	6 juni 2023
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 augustus 2014

Hoe voeg ik een aangepaste X-TAGS-header toe aan digest-e-mails voor externe e-mailanalyse (Netcore)?

Gerelateerde topics