معالج التثبيت

يحتوي Chamilo 2.0 على معالج تثبيت قائم على الويب يرشدك خلال الإعداد الأولي. يعمل المعالج تلقائيًا عند الوصول إلى المنصة للمرة الأولى.

قبل البدء

تأكد من تحقق المتطلبات التمهيدية التالية:

1. يلبي خادمك جميع متطلبات الخادم.

2. قمت بتحميل نسخة معبأة (zip أو tar.gz) من Chamilo.

3. تم تهيئة خادم الويب الخاص بك لخدمة دليل public/ كجذر المستندات.

4. يوجد ملف .env الخاص بك وهو فارغ (سيرشد المعالج إعداد قاعدة البيانات).

الخطوة 1: لغة التثبيت

Installation wizard Step 1 — language selection

تتيح الخطوة الأولى اختيار اللغة لعملية التثبيت. اختر اللغة المفضلة لديك من القائمة المنسدلة.

إذا اكتشف Chamilo تثبيتًا موجودًا (للترقية)، فسيعرض حالة الترحيل ويقدم مسار ترقية بدلاً من تثبيت جديد.

الخطوة 2: فحص المتطلبات

Installation wizard Step 2 — requirements check showing PHP version, extensions, and directory permissions

يفحص المعالج بيئة خادمك:

• إصدار PHP هو 8.2 أو أعلى

• الامتدادات المطلوبة لـ PHP مثبتة (intl، gd، curl، zip، mbstring، xml، إلخ)

• إعدادات PHP الموصى بها — date.timezone مُهيأ، حدود تحميل/ذاكرة كافية

• أذونات الدليل والملف — var/، config/، و public/upload/ قابلة للكتابة بواسطة خادم الويب

إذا لم تتحقق أي من المتطلبات، يعرض المعالج تحذيرات أو أخطاء. قم بحلها قبل المتابعة.

الخطوة 3: الترخيص

Installation wizard Step 3 — license acceptance

تعرض هذه الخطوة رخصة GNU/GPLv3. يجب عليك تحديد خانة الاختيار "أقبل" للمتابعة.

اختياريًا، يمكنك توسيع قسم معلومات الاتصال لتقديم تفاصيل عن منظمتك (الاسم، البريد الإلكتروني، الشركة، البلد). هذا طوعي ويساعد مجتمع Chamilo على فهم من يستخدم المنصة، لكنه سيسمح لنا أيضًا بالاتصال بك نادرًا جدًا بشأن الفعاليات التي تحدث بالقرب منك.

الخطوة 4: إعدادات قاعدة البيانات

Installation wizard Step 4 — database connection configuration

أدخل تفاصيل اتصال قاعدة البيانات الخاصة بك:

الحقل	الوصف
مضيف قاعدة البيانات	اسم المضيف أو عنوان IP لخادم قاعدة البيانات (مثل localhost أو 127.0.0.1)
منفذ قاعدة البيانات	الافتراضي: 3306 لـ MySQL/MariaDB
اسم قاعدة البيانات	اسم قاعدة البيانات المستخدمة (حروف وأرقام ورموز سفلية فقط)
مستخدم قاعدة البيانات	مستخدم قاعدة بيانات لديه صلاحيات كاملة على قاعدة البيانات المحددة
كلمة مرور قاعدة البيانات	كلمة المرور لمستخدم قاعدة البيانات

انقر على فحص اتصال قاعدة البيانات للاختبار. لن يسمح المعالج بالمتابعة حتى ينجح الاتصال. إذا كانت قاعدة البيانات موجودة بالفعل، يُعرض تحذير.

الخطوة 5: إعدادات التكوين

Installation wizard Step 5 — administrator account, portal settings, and email configuration

تجمع هذه الخطوة بين إنشاء حساب المسؤول، إعدادات البوابة، وتكوين البريد الإلكتروني.

حساب المسؤول

الحقل	الوصف
تسجيل الدخول	اسم مستخدم المسؤول
كلمة المرور	اختر كلمة مرور قوية — هذا الحساب لديه وصول كامل إلى المنصة
الاسم الأول	الاسم الأول للمسؤول
الاسم الأخير	الاسم الأخير للمسؤول
البريد الإلكتروني	يُستخدم لإشعارات النظام وإعادة تعيين كلمة المرور
الهاتف	رقم الاتصال الاختياري

سيتم استخدام هذه التفاصيل الخاصة بالمسؤول أيضًا من قبل Chamilo لملء تفاصيل الاتصال بالدعم، لذا تأكد من إعادة تهيئتها في الإعدادات بعد انتهاء التثبيت.

إعدادات البوابة

الحقل	الوصف
اللغة	اللغة الافتراضية لواجهة المستخدم
اسم البوابة	اسم المنصة الخاصة بك (مثل "نظام إدارة التعلم لمنظمتي")
الاسم المختصر للشركة	الاسم المختصر لمنظمتك
رابط الشركة	موقع منظمتك على الويب
طريقة التشفير	خوارزمية تشفير كلمات المرور — bcrypt موصى به
السماح بالتسجيل الذاتي	نعم / لا / بعد الموافقة
السماح بالتسجيل الذاتي كمدرب	نعم / لا

تكوين البريد الإلكتروني

يسمح قسم إعدادات البريد الإلكتروني بتكوين وسيلة نقل البريد (SMTP، Amazon SES، Mailjet، إلخ) واختبار إرسال البريد الإلكتروني. انظر تكوين البريد الإلكتروني للتفاصيل.

يمكن تغيير جميع هذه الإعدادات لاحقًا من لوحة الإدارة.

---

---

الخطوة 6: التحقق النهائي قبل التثبيت

Installation wizard Step 6 — review of all settings before installation

تعرض هذه الخطوة ملخصًا لكل ما أدخلته للمراجعة:

• بيانات مصادقة المسؤول (يتم إخفاء كلمة المرور افتراضيًا — انقر على أيقونة العين للكشف عنها)

• إعدادات البوابة

• تفاصيل اتصال قاعدة البيانات

راجع بعناية، ثم انقر على تثبيت Chamilo لتنفيذ التثبيت. يقوم المعالج بإنشاء جميع جداول قاعدة البيانات، وملء البيانات الأولية، وتكوين المنصة.

الخطوة 7: اكتمل التثبيت

Installation wizard Step 7 — completion with security advice and portal link

بعد اكتمال التثبيت بنجاح، يعرض المعالج:

• نصائح البدء — يقترح إنشاء مساقك الأول لاستكشاف المنصة (كمسؤول، يجب عليك القيام بذلك من لوحة الإدارة)

• توصيات الأمان:

  • اجعل دليل config/ للقراءة فقط (chmod 0555)

  • احذف دليل public/main/install/

• رابط إلى بوابتك لتسجيل الدخول ببيانات مصادقة المسؤول التي أنشأتها للتو

ما بعد التثبيت

بعد إكمال المعالج:

• إزالة أو تقييد الوصول إلى برنامج التثبيت -- يجب ألا يكون المعالج متاحًا بعد التثبيت. يقوم Chamilo عادةً بقفله تلقائيًا، لكن تحقق من أن إعادة زيارة عنوان URL للتثبيت يعيد التوجيه إلى صفحة تسجيل الدخول.

• تكوين إرسال البريد الإلكتروني -- انظر تكوين البريد الإلكتروني.

• إعداد النسخ الاحتياطي -- قبل إضافة المحتوى، قم بتكوين نسخ احتياطي تلقائي لقاعدة البيانات والملفات (لا يوفر Chamilo حلاً لهذا، لكن نسخ مجلد var/ وقاعدة البيانات هما العنصران الأهم).

• مراجعة إعدادات الأمان -- انظر إعدادات الأمان.

استكشاف الأخطاء وحل المشكلات

المشكلة	الحل
صفحة فارغة في عنوان URL للتثبيت	تحقق من سجلات أخطاء PHP. غيّر إلى APP_ENV=dev في .env مؤقتًا لرؤية الأخطاء في المتصفح.
فشل اتصال قاعدة البيانات	تحقق من بيانات المصادقة، وتأكد من وجود قاعدة البيانات، وتحقق من أن خادم قاعدة البيانات يسمح بالاتصالات من مضيف الخادم الويب.
أخطاء رفض الصلاحية	تأكد من أن var/ قابل للكتابة بواسطة مستخدم الخادم الويب.
عدم تحميل الموارد (لا CSS/JS)	قم بتشغيل yarn install && yarn build لتجميع موارد الواجهة الأمامية.