تهيئة البريد الإلكتروني

يُدير Chamilo الآن تهيئة إرسال البريد الإلكتروني من لوحة الإدارة، قسم إعدادات المنصة (هناك مدخل محدد للبريد الإلكتروني). يتم إرسال البريد الإلكتروني لإنشاء الحسابات، وإعادة تعيين كلمات المرور، وإشعارات الدورات، وتنبيهات الرسائل، وأحداث المنصة الأخرى. يتم تهيئة تسليم البريد الإلكتروني من خلال إعداد MAILER_DSN.

التهيئة

قم بتعيين خيار Mail DSN في قسم /admin/settings/mail. يعتمد التنسيق على وسيط البريد الإلكتروني الخاص بك.

SMTP

التهيئة الأكثر شيوعًا، والمناسبة لأي خادم SMTP:

# Let the system decide
native://default

# Basic SMTP
smtp://username:[email protected]:587

# SMTP with TLS (most providers)
smtp://username:[email protected]:587?encryption=tls

# SMTP without authentication (local relay)
smtp://localhost:25

استبدل username، وpassword، والمضيف ببيانات اعتماد خادم SMTP الخاص بك.

Amazon SES

# Using SMTP interface
ses+smtp://ACCESS_KEY:SECRET_KEY@default?region=us-east-1

# Using API
ses+api://ACCESS_KEY:SECRET_KEY@default?region=us-east-1

يأتي وسيط Symfony Amazon Mailer مدمجًا في Chamilo. لا يلزم تثبيت إضافي.

Mailjet

mailjet+api://API_KEY:SECRET_KEY@default

يأتي وسيط Symfony Mailjet مدمجًا في Chamilo. لا يلزم تثبيت إضافي.

Brevo (formerly Sendinblue)

brevo+api://API_KEY@default

يأتي وسيط Symfony Brevo مدمجًا في Chamilo. لا يلزم تثبيت إضافي.

Gmail (Development/Small Platforms)

gmail+smtp://[email protected]:app-password@default

استخدم كلمة مرور التطبيق، وليس كلمة مرور Gmail العادية. هذا مناسب للمنصات الصغيرة أو التطوير فقط، حيث لدى Gmail حدود على الإرسال.

إعدادات بريد المنصة الإلكتروني

بالإضافة إلى الوسيط، قم بتهيئة هوية المرسل في نفس الصفحة:

الإعداد	الوصف
إرسال جميع البريد الإلكتروني كأنه صادر عن هذا الاسم (التنظيمي)	الاسم المعروض المرتبط بالبريد الإلكتروني للنظام.
إرسال جميع البريد الإلكتروني من عنوان بريد إلكتروني هذا	عنوان "من" لجميع البريد الإلكتروني للنظام. يجب أن يكون عنوانًا صالحًا مقبولاً من قبل وسيط البريد الخاص بك. نوصي باستخدام عنوان "لا رد" مثل [email protected] لتجنب تلقي ردود غير مفيدة على البريد الإلكتروني الآلي.

اختبار تسليم البريد الإلكتروني

بعد تهيئة MAILER_DSN، اختبر أن البريد الإلكتروني يتم تسليمه: اذهب إلى إدارة > نظام > مختبر البريد الإلكتروني، حدد مستلمًا، وموضوعًا، ونص البريد الإلكتروني، ثم انقر على إرسال بريد إلكتروني تجريبي.

إذا اكتمل الأمر دون أخطاء لكن البريد الإلكتروني لم يُستلم:

1. تحقق من مجلد البريد غير المرغوب فيه/السبام لدى المستلم.

2. تحقق من أن نطاق الإرسال الخاص بك لديه سجلات DNS صحيحة (SPF، DKIM، DMARC).

3. تحقق من سجلات الإرسال لدى مزود البريد الخاص بك بحثًا عن الارتدادات أو الرفض.

4. راجع سجل Chamilo في var/log/prod.log بحثًا عن أخطاء المرسل.

5. في إعدادات تهيئة البريد الإلكتروني، قم بتفعيل بريد: تصحيح أخطاء (غير متاح في 2.0، سيكون قريبًا).

تجريبي: طابور البريد الإلكتروني (التسليم غير المتزامن)

افتراضيًا، يتم إرسال البريد الإلكتروني بشكل متزامن أثناء طلب الويب. لأداء أفضل، قم بتهيئة التسليم غير المتزامن باستخدام Symfony Messenger:

# config/packages/messenger.yaml
framework:
    messenger:
        transports:
            async: '%env(MESSENGER_TRANSPORT_DSN)%'
        routing:
            'Symfony\Component\Mailer\Messenger\SendEmailMessage': async

مع التسليم غير المتزامن، يتم وضع البريد الإلكتروني في الطابور وإرساله بواسطة عامل خلفي:

php bin/console messenger:consume async

شغل هذا كخدمة نظام (مثل systemd أو supervisord) ليظل يعمل.

نصائح

• استخدم خدمة بريد إلكتروني مخصصة (SES، Mailjet، Brevo) للمنصات الإنتاجية. يتطلب SMTP المباشر إلى خادم البريد الخاص بك تهيئة دقيقة لتجنب مشكلات التسليم.

• قم بتهيئة سجلات DNS SPF، DKIM، وDMARC لنطاق الإرسال الخاص بك لتعظيم معدلات التسليم ومنع تصنيف البريد الإلكتروني كسبام. يمكنك أيضًا تهيئة رؤوس DKIM من صفحة إعدادات البريد الإلكتروني.

• استخدم التسليم غير المتزامن على المنصات التي لديها أكثر من بضع عشرات من المستخدمين النشطين -- إرسال البريد الإلكتروني المتزامن يمكن أن يبطئ طلبات الويب بشكل ملحوظ.