כיצד להוסיף כותרת X-TAGS מותאמת אישית למיילים מסוכמים עבור ניתוח דוא"ל חיצוני (Netcore)?

emonunix · 10 בספטמבר,‏ 2025,‏ 8:19pm

שלום לכולם,

אני משתמש ב-Discourse בהוסט עצמי ומחפש דרך להוסיף כותרת מותאמת אישית, ספציפית X-TAGS, למיילים היוצאים שלנו. המטרה היא להשתלב עם ספק שירותי הדוא"ל שלנו (Netcore Email API) לצורך ניתוח ומעקב טובים יותר. אנו רוצים להיות מסוגלים לתייג סוגים מסוימים של מיילים, כמו התקציר השבועי, לתצוגה גרנולרית יותר של מעורבות הדוא"ל שלנו.

בעיה:

אני צריך להוסיף כותרת כמו X-TAGS: Digest לכל המיילים שנשלחים כתקציר. כותרת זו מיועדת למעקב פנימי ותוסר על ידי ספק הדוא"ל לפני המסירה, כך שהיא לא תהיה גלויה למשתמש הקצה.

מה שכבר בדקתי:

הגדרות אתר: עברתי על הדף /admin/site_settings/category/email ומצאתי את ההגדרה email custom headers. עם זאת, נראה שהיא מוסיפה כותרת סטטית לכל המיילים. איני בטוח אם ניתן להפוך אותה לדינמית או להחיל אותה רק על סוג מסוים של מייל (כמו התקציר).
נושאי פורום קיימים: חיפשתי בפורומים של Discourse Meta ומצאתי דיונים מסוימים על כותרות מותאמות אישית, אך הם מתמקדים בעיקר בהוספת תגיות נושא לשורת הנושא של המייל או לסינון בצד המשתמש (למשל, ב-Gmail), לא לניתוח דוא"ל חיצוני. לא נראה שיש דרך פשוטה ומתועדת רשמית לעשות זאת.

השאלות שלי הן:

האם יש שיטה מובנית או הגדרת אתר ספציפית שאני מפספס, שתאפשר לי להוסיף כותרת מותאמת אישית כמו X-TAGS ספציפית למיילים של תקציר?
אם לא, האם זהו פיצ’ר שניתן להשיג באמצעות תוסף מותאם אישית?
האם שינוי קוד הליבה יהיה הפתרון היחיד, ואם כן, האם תוכלו להפנות אותי לכיוון הנכון (למשל, אילו קבצים לבדוק)?

כל הדרכה או הצעה תתקבל בברכה. תודה מראש על עזרתכם!

selase · 12 בספטמבר,‏ 2025,‏ 2:31pm

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.

נושא		תגובות	צפיות
Customs email headers and/or subjects tags Feature	7	2718	8 בינואר,‏ 2022
Add headers to all outgoing emails Installation	2	789	23 באוקטובר,‏ 2020
Adding custom content to summary emails Documentation email	14	5658	6 ביוני,‏ 2023
How to show tags in the digest email? Support activity-summary	0	336	23 ביוני,‏ 2021
Email: mail headers should have tags in them Feature	2	842	16 באוגוסט,‏ 2014

כיצד להוסיף כותרת X-TAGS מותאמת אישית למיילים מסוכמים עבור ניתוח דוא"ל חיצוני (Netcore)?

נושאים קשורים