يُثبَّت Eagle3D من حزمة ZIP. ترفعها إلى مساحة الاستضافة، ثم تفتح موقعك في المتصفح وتتبع معالج الإعداد. تستغرق العملية بأكملها بضع دقائق.
قبل أن تبدأ
- تحقق من متطلبات الخادم.
- احرص على وجود حزمة تثبيت Eagle3D (ملف ZIP) على حاسوبك. نزّلها من الرابط الموجود في رسالة الترخيص الواردة إلى بريدك الإلكتروني.
- حدّد العنوان الذي ستستخدمه، مثل
https://print.example.com/. سيُربط الترخيص بهذا النطاق لاحقًا، ويُعدّ النطاق معwwwوبدونwwwنطاقين مختلفين. - تأكد من أن النطاق أو النطاق الفرعي يفتح عبر HTTPS بالفعل.
- لا تحتاج إلى رمز تفعيل الترخيص بعد. سيطلبه Eagle3D بعد أول تسجيل دخول.
الخطوة 1. أنشئ قاعدة بيانات فارغة
- في لوحة الاستضافة، افتح أداة قواعد البيانات (مثل cPanel > MySQL Databases).
- أنشئ قاعدة بيانات جديدة ومستخدم قاعدة بيانات بكلمة مرور قوية.
- أضف المستخدم إلى قاعدة البيانات مع ALL PRIVILEGES.
- دوّن اسم قاعدة البيانات واسم المستخدم وكلمة المرور، فستحتاج إليها في معالج الإعداد.
الخطوة 2. ارفع الملفات
ارفع حزمة ZIP إلى مجلد موقعك (مثل public_html أو مجلد نطاق فرعي) وفك ضغطها هناك. في cPanel يمكنك استخدام مدير الملفات: ارفع ملف ZIP ثم اختر فك الضغط.
إذا كان لديك وصول SSH، يمكنك فعل الشيء نفسه من سطر الأوامر:
cd ~/print.example.com
unzip ~/eagle3d-installation.zip
استبدل اسم المجلد واسم الملف بما يخصك. تُفك الحزمة مباشرةً داخل المجلد؛ ويجب أن تكون الملفات index.php وorder.php والمجلدات app وpages وinstall موجودة الآن في مجلد الموقع.
الخطوة 3. شغّل معالج الإعداد
افتح موقعك في المتصفح، مثل https://print.example.com/. يبدأ معالج الإعداد (Eagle3D Setup) تلقائيًا. يمكنك تبديل لغة المعالج بين الإنجليزية والتركية أعلى اليمين.
1. الخادم
يفحص المعالج إصدار PHP وإضافات PHP والمجلدات القابلة للكتابة وHTTPS. يجب إصلاح العناصر المميزة باللون الأحمر قبل المتابعة؛ أصلحها في لوحة الاستضافة وانقر الفحص مجددًا. العناصر باللون البرتقالي تحذيرات. عندما تكتمل جميع المتطلبات، انقر متابعة.
2. قاعدة البيانات
أدخل بيانات الاتصال من الخطوة 1:
| الحقل | ما يجب إدخاله |
|---|---|
| المضيف | عادةً localhost |
| المنفذ | عادةً 3306 |
| اسم قاعدة البيانات | قاعدة البيانات التي أنشأتها |
| اسم المستخدم | مستخدم قاعدة البيانات |
| كلمة المرور | كلمة مرور مستخدم قاعدة البيانات |
انقر اختبار الاتصال والمتابعة. يتحقق المعالج من الاتصال وإصدار قاعدة البيانات ومن أن قاعدة البيانات فارغة.
3. النشاط التجاري والمسؤول
أدخل بيانات نشاطك التجاري وحساب المسؤول الأول. يمكن تغيير بيانات النشاط لاحقًا من الإعدادات → عام؛ أما النطاق فلا يمكن تغييره هناك.
| الحقل | وظيفته |
|---|---|
| اسم النظام / النشاط التجاري | الاسم المعروض في اللوحة وصفحة الطلب والرسائل الإلكترونية |
| النطاق | النطاق المرتبط به الترخيص. أدخل العنوان الدقيق الذي ستستخدمه. |
| مجلد التطبيق | للعلم فقط: المجلد الذي يعمل فيه Eagle3D (/ للجذر) |
| لغة النظام | لغة اللوحة وصفحة الطلب وصفحة التتبع (12 لغة) |
| الدولة | تحدد تنسيق رقم الهاتف. بالنسبة لتركيا، تُحمَّل جميع المحافظات والأقضية مسبقًا. |
| رمز العملة | من 1 إلى 5 أحرف، ويُقترح بناءً على الدولة |
| تنسيق الأرقام | 1.234,56 أو 1,234.56 |
| المنطقة الزمنية | تُستخدم للتواريخ ومواعيد الاستحقاق والتقارير |
| نوع النشاط | فرد / ورشة صغيرة أو شركة (وحدة الموظفين مفعّلة) |
| اسم المستخدم | من 3 إلى 50 حرفًا: أحرف وأرقام ونقطة وشرطة وشرطة سفلية |
| البريد الإلكتروني | عنوان البريد الإلكتروني للمسؤول |
| كلمة المرور وكلمة المرور (تكرار) | 10 أحرف على الأقل؛ وتُرفض كلمات المرور البسيطة جدًا |
انقر بدء التثبيت. ينشئ المعالج الجداول ويكتب القيم الافتراضية وينشئ حساب المسؤول. إذا فشل أي شيء، تُستعاد قاعدة البيانات إلى حالتها السابقة ويمكنك المحاولة مجددًا.
4. تم
يعرض المعالج اكتمل التثبيت وفحص الأمان: إذ يختبر ما إذا كان يمكن فتح الملفات الحساسة (مثل .env) من الخارج. يجب أن يظهر في كل سطر غير قابل للوصول من الخارج. إذا ظهر في سطر قابل للوصول من الخارج، فتحقق من قواعد الوصول على الخادم قبل الإطلاق.
لمزيد من الأمان يمكنك حذف المجلد install من الخادم؛ فقد أغلق المعالج نفسه بالفعل. انقر الانتقال إلى تسجيل الدخول.
الخطوة 4. سجّل الدخول وفعّل الترخيص
سجّل الدخول بحساب المسؤول الذي أنشأته للتو. سيطلب Eagle3D بعدها رمز تفعيل الترخيص. راجع تفعيل ترخيص Eagle3D.
ملف الإعدادات .env
يكتب المعالج ملفًا باسم .env في مجلد التطبيق. يحتوي على اتصال قاعدة البيانات ومجلد التطبيق ونطاق الترخيص (APP_DOMAIN) ومفتاح التطبيق (APP_KEY).
- احتفظ بنسخة من
.envفي مكان آمن. فهو ليس جزءًا من النسخ الاحتياطية لقاعدة البيانات. - لا تغيّر
APP_KEYأبدًا. فمفاتيح المتاجر المحفوظة وكلمة مرور SMTP وبيانات الترخيص مشفّرة به. - لا تشارك هذا الملف أبدًا؛ فهو يحتوي على كلمة مرور قاعدة البيانات.
خلف Cloudflare أو وكيل عكسي
إذا كان موقعك يعمل خلف Cloudflare أو وكيل عكسي آخر، فأضف سطرًا كهذا إلى .env مع عناوين الوكيل (عناوين IP أو نطاقات، مفصولة بفواصل):
TRUSTED_PROXIES="203.0.113.10, 198.51.100.0/24"
بعد ذلك تستخدم حدود تسجيل الدخول والطلبات العنوان الحقيقي للزائر. راجع الأمان وملكية البيانات.