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

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

## التهيئة

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

### SMTP

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

```bash
# Let the system decide
native://default

# Basic SMTP
smtp://username:password@smtp.example.com:587

# SMTP with TLS (most providers)
smtp://username:password@smtp.example.com:587?encryption=tls

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

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

### Amazon SES

```bash
# 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

```bash
mailjet+api://API_KEY:SECRET_KEY@default
```

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

### Brevo (formerly Sendinblue)

```bash
brevo+api://API_KEY@default
```

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

### Gmail (Development/Small Platforms)

```bash
gmail+smtp://your-email@gmail.com:app-password@default
```

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

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

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

| الإعداد                                                            | الوصف                                                                                                                                                                                                                       |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **إرسال جميع البريد الإلكتروني كأنه صادر عن هذا الاسم (التنظيمي)** | الاسم المعروض المرتبط بالبريد الإلكتروني للنظام.                                                                                                                                                                            |
| **إرسال جميع البريد الإلكتروني من عنوان بريد إلكتروني هذا**        | عنوان "من" لجميع البريد الإلكتروني للنظام. يجب أن يكون عنوانًا صالحًا مقبولاً من قبل وسيط البريد الخاص بك. نوصي باستخدام عنوان "لا رد" مثل `no-reply@yourdomain.com` لتجنب تلقي ردود غير مفيدة على البريد الإلكتروني الآلي. |

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

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

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

1. تحقق من مجلد البريد غير المرغوب فيه/السبام لدى المستلم.
2. تحقق من أن نطاق الإرسال الخاص بك لديه سجلات DNS صحيحة (SPF، DKIM، DMARC).
3. تحقق من سجلات الإرسال لدى مزود البريد الخاص بك بحثًا عن الارتدادات أو الرفض.
4. راجع سجل Chamilo في `var/log/prod.log` بحثًا عن أخطاء المرسل.
5. في إعدادات تهيئة البريد الإلكتروني، قم بتفعيل *بريد: تصحيح أخطاء* (غير متاح في 2.0، سيكون قريبًا).

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

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

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

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

```bash
php bin/console messenger:consume async
```

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

## نصائح

* **استخدم خدمة بريد إلكتروني مخصصة** (SES، Mailjet، Brevo) للمنصات الإنتاجية. يتطلب SMTP المباشر إلى خادم البريد الخاص بك تهيئة دقيقة لتجنب مشكلات التسليم.
* **قم بتهيئة سجلات DNS SPF، DKIM، وDMARC** لنطاق الإرسال الخاص بك لتعظيم معدلات التسليم ومنع تصنيف البريد الإلكتروني كسبام. يمكنك أيضًا تهيئة رؤوس DKIM من صفحة إعدادات البريد الإلكتروني.
* **استخدم التسليم غير المتزامن** على المنصات التي لديها أكثر من بضع عشرات من المستخدمين النشطين -- إرسال البريد الإلكتروني المتزامن يمكن أن يبطئ طلبات الويب بشكل ملحوظ.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.chamilo.org/2.x-ar/dlyl-alidarh/admin-guide/installation/email-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.