إنتقل إلى المحتوى الرئيسي

التثبيت

يتم تثبيت LeadHub بالكامل من خلال معالج يعمل عبر المتصفح. لا حاجة لـ SSH أو الطرفية أو Composer.

قبل البدء​

✅ تأكد من أن خادمك يستوفي المتطلبات
✅ أنشئ قاعدة بيانات MySQL ومستخدماً (دوّن بيانات الاعتماد)
✅ احضر مفتاح الترخيص (من عملية الشراء على CodeCanyon)
✅ تأكد من امتلاكك وصولاً عبر FTP أو مدير ملفات cPanel لرفع الملفات

الخطوة 1 — رفع الملفات​

  1. نزّل حزمة LeadHub من CodeCanyon ← Downloads.
  2. استخرج ملف ZIP على جهازك.
  3. ارفع محتوى المجلد المستخرج بالكامل إلى جذر موقعك الإلكتروني (مثل public_html/) عبر FTP أو مدير ملفات cPanel.

⚠️ لا ترفع المجلد الخارجي نفسه — ارفع محتوياته حتى يكون index.php مباشرةً داخل public_html/.

الخطوة 2 — ضبط صلاحيات الملفات​

في الاستضافة المشتركة تُعيَّن هذه الصلاحيات تلقائياً في الغالب، لكن تحقق منها:

المسارالصلاحية
storage/755 (بشكل تكراري)
bootstrap/cache/755
public/755

الخطوة 3 — فتح معالج التثبيت​

انتقل إلى نطاقك في المتصفح:

https://yourdomain.com/install

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

الخطوة 4 — فحص المتطلبات​

يفحص المعالج جميع متطلبات PHP تلقائياً. أي عنصر فاشل يظهر باللون الأحمر مع شرح موجز. أصلح جميع العناصر الحمراء قبل المتابعة.

الخطوة 5 — إعداد قاعدة البيانات​

أدخل بيانات اعتماد قاعدة البيانات:

الحقلالوصف
Database Hostعادةً localhost أو 127.0.0.1
Database Portعادةً 3306
Database Nameقاعدة البيانات التي أنشأتها
Database Usernameمستخدم قاعدة البيانات
Database Passwordكلمة مرور مستخدم قاعدة البيانات

انقر Test Connection للتحقق، ثم Next.

الخطوة 6 — إعدادات التطبيق​

الحقلالوصف
App URLنطاقك، مثل https://yourdomain.com
App Nameيظهر في تبويب المتصفح والرسائل الإلكترونية
Timezoneمنطقتك الزمنية الأساسية

الخطوة 7 — مفتاح الترخيص​

أدخل رمز الشراء (مفتاح الترخيص) من عملية الشراء على CodeCanyon. يتحقق المعالج منه عبر الإنترنت.

الخطوة 8 — حساب المشرف الأعلى​

أنشئ أول حساب مشرف أعلى:

الحقلملاحظات
Nameاسمك الكامل
Emailيُستخدم لتسجيل الدخول
Password8 أحرف على الأقل

⚠️ احفظ هذه البيانات — إنه حساب الجذر لإدارة المنصة بأكملها.

الخطوة 9 — إعداد مهمة Cron​

يعرض المعالج أمر cron الدقيق لخادمك. انسخه وأضفه إلى لوحة تحكم استضافتك:

* * * * * /usr/bin/php /home/username/public_html/cron.php >> /dev/null 2>&1

في cPanel: Cron Jobs ← Add New Cron Job ← Every Minute ← الصق الأمر.

الخطوة 10 — الإنهاء​

انقر Complete Installation. يكتب المعالج ملف .env وينفّذ عمليات الترحيل. عند الانتهاء، يتم توجيهك إلى صفحة تسجيل دخول المشرف الأعلى على /super-admin.

بعد التثبيت​

  1. سجّل الدخول على /super-admin ببيانات الاعتماد التي أنشأتها للتو.
  2. أنشئ أول مستأجر.
  3. سجّل الدخول إلى لوحة إدارة المستأجر على /admin (أو tenant.yourdomain.com/admin).

استكشاف الأخطاء وإصلاحها​

المشكلةالحل
صفحة بيضاء على /installتحقق من وجود .htaccess وتفعيل mod_rewrite
"Database connection failed"تحقق من بيانات الاعتماد؛ تأكد أن مستخدم قاعدة البيانات يملك الصلاحيات الكاملة
التوقف عند فحص المتطلباتثبّت امتداد PHP الناقص عبر cPanel ← PHP Extensions
خطأ 500 بعد التثبيتتحقق من storage/logs/laravel.log عبر مدير الملفات

➡ انظر أيضاً: دليل الاستضافة المشتركة