# Settings System

تُدار تكوين Chamilo من خلال مجموعة من مخططات الإعدادات (حوالي 40 منها، تختلف بين الإصدارات) التي تحدد كل جانب قابل للتكوين في المنصة. توجد في `src/CoreBundle/Settings/` — القائمة الدقيقة هناك هي المصدر الحقيقي للحقيقة.

## كيفية عمله

الإعدادات هي:

1. **مُعرَّفة** في فئات المخطط (`src/CoreBundle/Settings/*SettingsSchema.php`)
2. **مخزنة** في قاعدة البيانات (جدول `settings_current`)
3. **مُسْتَخْدَمَة** عبر خدمة `SettingsManager`
4. **مُدْرَجَة** من خلال واجهة الإدارة الإلكترونية

## مخططات الإعدادات

يحدد كل ملف مخطط فئة من الإعدادات. المخططات الرئيسية:

| المخطط                       | الغرض                                                            |
| ---------------------------- | ---------------------------------------------------------------- |
| `PlatformSettingsSchema`     | معلومات المؤسسة، المنطقة الزمنية، نوع الخادم، ميزات البوابة      |
| `SecuritySettingsSchema`     | محاولات تسجيل الدخول، CAPTCHA، سياسة كلمة المرور، رؤوس HTTP، 2FA |
| `RegistrationSettingsSchema` | التسجيل الذاتي، الحقول المطلوبة، الاشتراك التلقائي               |
| `CourseSettingsSchema`       | إعدادات افتراضية لإنشاء الدورة، الأدوات، الكتالوج                |
| `SessionSettingsSchema`      | إعدادات افتراضية للجلسة، الرؤية                                  |
| `MailSettingsSchema`         | تكوين البريد الإلكتروني، DKIM، الإشعارات                         |
| `AiHelpersSettingsSchema`    | مزودو الذكاء الاصطناعي، تبديلات الميزات لكل أداة ذكاء اصطناعي    |
| `ExerciseSettingsSchema`     | تسجيل الاختبارات، الملاحظات، خيارات الأسئلة                      |
| `LearningPathSettingsSchema` | عرض مسار التعلم، المتطلبات السابقة، إعدادات SCORM                |
| `DocumentSettingsSchema`     | حدود الرفع، أنواع الملفات المسموح بها، التخزين                   |
| `DisplaySettingsSchema`      | علامات تبويب الواجهة، عناصر الشريط الجانبي، السمة                |
| `LanguageSettingsSchema`     | اللغات المتاحة، الإعداد الافتراضي للموقع                         |
| `AdminSettingsSchema`        | بريد الإدارة الإلكتروني، خيارات خاصة بالإدارة                    |

## الوصول إلى الإعدادات

في كود PHP:

```php
// Via SettingsManager service
$value = $settingsManager->getSetting('platform.site_name');

// In legacy code
$value = api_get_setting('platform.site_name');
```

في القوالب:

```twig
{# Read a single setting #}
{{ chamilo_settings_get('platform.site_name') }}

{# Check whether a setting exists #}
{% if chamilo_settings_has('platform.allow_registration') %}
    ...
{% endif %}

{# Get all settings as an array #}
{% set settings = chamilo_settings_all() %}
```

## هيكل الإعداد

لكل إعداد:

* **مساحة الاسم** — فئة المخطط (مثل `platform`، `security`، `ai_helpers`)
* **المتغير** — اسم الإعداد (مثل `site_name`، `allow_registration`)
* **القيمة** — القيمة الحالية
* **النوع** — نوع البيانات (string، boolean، array، إلخ)

## إعدادات مستوى الدورة

يمكن تجاوز بعض الإعدادات على مستوى الدورة. هذه مُعرَّفة في `src/CourseBundle/Settings/` وتشمل:

* إعدادات التمارين لكل دورة
* إعدادات المهام لكل دورة
* تبديلات ميزات الذكاء الاصطناعي لكل دورة

## إعدادات متعددة الـ URL

في الإعدادات متعددة الـ URL، يمكن تخصيص بعض الإعدادات لكل عنوان URL للوصول، مما يسمح بتكوينات بوابة مختلفة من نفس التثبيت.

ستظهر هذه الإعدادات عدة مرات في جدول `settings`، مع قيم `access_url` مختلفة. افتراضيًا، ترتبط جميع الإعدادات بـ `access_url=1`.

## إضافة إعداد جديد

1. أضف تعريف الإعداد إلى فئة المخطط المناسبة
2. قدم قيمة افتراضية
3. قم بتشغيل هجرات قاعدة البيانات إذا لزم الأمر
4. استخدم الإعداد عبر `SettingsManager`


---

# 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-almtwr/developer-guide/backend/settings-system.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.