معالج التثبيت
يتم تثبيت LeadHub بالكامل من خلال متصفح الويب الخاص بك. لا يوجد سطر أوامر، ولا طرفية، ولا SSH. تقوم برفع الملفات، وفتح رابط URL، واتباع خمس خطوات بسيطة. يرشدك هذا الدليل خلال العملية بأكملها من البداية إلى النهاية.
الوقت الإجمالي: حوالي 10-20 دقيقة.
قبل البدء
تأكد من أن خادمك يلبي المتطلبات المدرجة في دليل متطلبات الخادم. على وجه الخصوص، تأكد من:
- PHP 8.3 أو أعلى مفعّل لنطاقك
- لديك قاعدة بيانات MySQL (أو MariaDB) متاحة — أو يمكنك إنشاء واحدة (التعليمات أدناه)
- مجلدات
storage/وbootstrap/cache/قابلة للكتابة - لديك حوالي 500 ميجابايت من مساحة القرص الحرة
الخطوة 1 — رفع ملفات LeadHub إلى خادمك
تنزيل الحزمة
بعد شراء LeadHub، قم بتنزيل حزمة ZIP من بريد تأكيد الشراء أو من صفحة تنزيلات Envato. سيكون اسم الملف شيئاً مثل leadhub-v1.0.0.zip.
داخل الملف المضغوط ستجد كل ما يحتاجه LeadHub — بما في ذلك مجلد vendor/ وCSS وJavaScript المجمّعة مسبقاً والمثبّت نفسه.
الرفع عبر مدير ملفات cPanel (الطريقة الأسهل)
- سجّل الدخول إلى حساب cPanel الخاص بك.
- انقر على File Manager في قسم Files.
- انتقل إلى المجلد حيث تريد تثبيت LeadHub. عادةً:
public_html/إذا كنت تريد LeadHub على نطاقك الرئيسي- مجلد فرعي مثل
public_html/leadhub/ - مجلد نطاق إضافي مخصص (موصى به — راجع دليل الاستضافة المشتركة)
- انقر على Upload في شريط الأدوات.
- ارفع ملف
leadhub-v1.0.0.zip. - بعد انتهاء الرفع، انقر بزر الماوس الأيمن على الملف المضغوط واختر Extract.
- استخرجه في المجلد الصحيح.
الرفع عبر FTP
- اتصل بخادمك باستخدام بيانات اعتماد FTP الخاصة بك.
- انتقل إلى مجلد الوجهة على خادمك.
- اسحب مجلد
leadhubالمستخرج من جهاز الكمبيوتر إلى مجلد الخادم. - انتظر حتى تنتهي جميع الملفات من الرفع (5-15 دقيقة).
نصيحة: من الأسرع رفع ملف ZIP عبر مدير الملفات واستخراجه على الخادم بدلاً من رفع آلاف الملفات الفردية عبر FTP.
الخطوة 2 — تعيين صلاحيات الملفات
عيّن المجلدات التالية بمستوى صلاحية 755:
في مدير ملفات cPanel:
- افتح File Manager وانتقل إلى مجلد LeadHub.
- انقر بزر الماوس الأيمن على مجلد
storageواختر Change Permissions. - عيّنه إلى 755 وتأكد من تحديد "Recurse into subdirectories".
- انقر على Change Permissions.
- كرر العملية لمجلد
bootstrap/cache(755).
الخطوة 3 — افتح المثبّت في متصفحك
https://yourdomain.com/install
إذا ظهر خطأ 404: تحقق من موقع الملفات وأن
public/.htaccessتم رفعه بشكل صحيح.
إذا ظهرت صفحة بيضاء فارغة: تحقق من إصدار PHP في cPanel → MultiPHP Manager.
خطوة المثبّت 1 — الترحيب وفحص المتطلبات
يفحص تلقائياً:
- إصدار PHP — يجب أن يكون 8.3 أو أعلى
- إضافات PHP — يفحص الإضافات الـ 13 المطلوبة
- صلاحيات المجلدات — يتحقق من قابلية الكتابة لـ storage/ و bootstrap/cache/
عندما يظهر كل شيء بعلامة خضراء، انقر على "Next: Database".
خطوة المثبّت 2 — إعداد قاعدة البيانات
| الحقل | ما تدخله |
|---|---|
| Database Host | عادةً localhost أو 127.0.0.1 |
| Port | عادةً 3306 |
| Database Name | اسم قاعدة بيانات MySQL التي أنشأتها |
| Database Username | اسم مستخدم MySQL الذي أنشأته |
| Database Password | كلمة مرور مستخدم MySQL |
كيفية إنشاء قاعدة بيانات MySQL في cPanel
- في cPanel، ابحث عن MySQL Databases.
- تحت "Create New Database"، اكتب اسماً → Create Database.
- تحت "MySQL Users" → "Add New User"، أنشئ اسم مستخدم وكلمة مرور → Create User.
- تحت "Add User to Database"، حدد المستخدم وقاعدة البيانات → Add.
- حدد "All Privileges" → Make Changes.
خطوة المثبّت 3 — حساب المسؤول
| الحقل | ما تدخله |
|---|---|
| Your Name | اسمك الكامل |
| Email Address | بريدك الإلكتروني (سيكون اسم مستخدم تسجيل الدخول) |
| Password | كلمة مرور قوية (8 أحرف على الأقل) |
| Confirm Password | نفس كلمة المرور مرة أخرى |
| Workspace Name | اسم مؤسستك أو مساحة العمل |
مساحة العمل هي حساب مؤسستك داخل LeadHub. ستُعيّن كمالك بصلاحيات المسؤول الأعلى الكاملة.
انقر على "Next: License".
خطوة المثبّت 4 — الترخيص
للعثور على رمز الشراء:
- سجّل الدخول إلى حساب Envato Market / CodeCanyon.
- الملف الشخصي → Downloads.
- ابحث عن LeadHub → "Download" → "License certificate & purchase code".
- انسخ الرمز.
الصقه في حقل مفتاح الترخيص وانقر "Next: Finish". يمكنك تخطي هذه الخطوة وإضافة الترخيص لاحقاً.
خطوة المثبّت 5 — الإنهاء
انقر على "Install LeadHub". سيقوم المثبّت تلقائياً بـ:
- كتابة ملف التكوين (
.env) - تشغيل ترحيلات قاعدة البيانات
- إدخال البيانات الأولية (الأدوار والصلاحيات)
- إنشاء حساب المسؤول
- إنشاء مساحة العمل
- ربط مجلد التخزين
- تخزين التكوين مؤقتاً
المدة: 30-90 ثانية. سيتم توجيهك إلى /admin.
اكتمل التثبيت.
قائمة التحقق بعد التثبيت
1. إعداد مهمة Cron (حرج)
php /home/yourusername/leadhub/cron.php >> /dev/null 2>&1
يجب تشغيلها كل دقيقة. راجع دليل الاستضافة المشتركة.
2. تكوين البريد الإلكتروني
الإعدادات → البريد الإلكتروني في لوحة الإدارة.
3. رفع الشعار وتخصيص العلامة التجارية
الإعدادات → العلامة التجارية.
4. إنشاء أول خط أنابيب
Pipelines في الشريط الجانبي.
5. ربط أول مصدر للعملاء المحتملين
Lead Sources في الشريط الجانبي.
كيفية إعادة تشغيل المثبّت
احذف installed.lock من storage/ وزر /install مرة أخرى.
تحذير: قم بنسخ قاعدة البيانات احتياطياً أولاً لأن
.envسيُكتب فوقه.
استكشاف الأخطاء وإصلاحها
| المشكلة | السبب المحتمل | الحل |
|---|---|---|
| "Page not found" عند زيارة /install | الملفات في المجلد الخطأ أو mod_rewrite غير نشط | تحقق من موقع الملفات و public/.htaccess |
| صفحة بيضاء فارغة | خطأ PHP أو إصدار خاطئ | غيّر إلى PHP 8.3 في cPanel MultiPHP Manager |
| "Cannot connect to database" | بيانات اعتماد خاطئة | تحقق من الاسم (مع بادئة cPanel) واسم المستخدم وكلمة المرور |
| تحذيرات حمراء للإضافات | إضافات PHP غير مفعّلة | cPanel → Select PHP Version، فعّل الإضافات المفقودة |
| "storage is not writable" | صلاحيات غير صحيحة | عيّن storage/ إلى 755 بشكل متكرر |
| المثبّت يتوقف عند "Installing..." | حد ذاكرة PHP منخفض | حدّث الصفحة؛ تحقق من حد ذاكرة PHP |
| توجيه إلى /admin لكن لا يمكن تسجيل الدخول | الجلسة لا تُحفظ | تحقق من وجود storage/framework/sessions/ وقابليتها للكتابة |
| خطأ "installation failed" | فقدان اتصال قاعدة البيانات | تحقق من بيانات الاعتماد وصلاحيات كتابة .env |