كيفية إضافة ترويسة X-TAGS مخصصة إلى رسائل البريد الإلكتروني الملخصة لتحليلات البريد الإلكتروني الخارجية (Netcore)؟

emonunix · 10 سبتمبر 2025، 8:19م

مرحباً بالجميع،

أنا مستخدم لـ 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:31م

لا، هذا غير مدعوم بشكل مباشر، بخلاف إعداد الموقع 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	2718	8 يناير 2022
Add headers to all outgoing emails Installation	2	789	23 أكتوبر 2020
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
Force topics into email digest via tags? Feature activity-summary	1	486	20 يوليو 2021

كيفية إضافة ترويسة X-TAGS مخصصة إلى رسائل البريد الإلكتروني الملخصة لتحليلات البريد الإلكتروني الخارجية (Netcore)؟

الموضوعات ذات الصلة