جولة مثبّت الويب
يشمل FeedbackPulse SaaS مثبّتًا جميلاً مستندًا إلى المتصفح. لا حاجة لسطر الأوامر (بعد الرفع الأولي للملفات وتشغيل composer install).
الوصول إلى المثبّت
انتقل إلى:
https://yourdomain.com/install
لا ترى المثبّت؟ تأكد من:
- إشارة خادم الويب إلى مجلد
public/- تفعيل
mod_rewriteفي Apache (أو وجودtry_filesالصحيح في Nginx)- عدم وجود ملف
storage/installed.lock(يمنع هذا المثبّت بعد التثبيت الأول)
الخطوة 1: الترحيب والترخيص
تُرحّب بك الشاشة الأولى وتطلب منك رمز شراء Envato/CodeCanyon.
أين تجد رمز الشراء:
- سجّل الدخول إلى CodeCanyon
- انتقل إلى Downloads ← ابحث عن FeedbackPulse SaaS
- انقر على Download ← License certificate and purchase code
- يبدو رمز الشراء هكذا:
a1b2c3d4-e5f6-7890-abcd-ef1234567890
ما الذي يفعله:
- يتحقق من ترخيصك مع Envato API
- يضمن أن لديك نسخة مشروعة
- يفتح بقية المثبّت
الخطوة 2: فحص المتطلبات
يفحص المثبّت خادمك تلقائيًا ويتحقق من:
إصدار PHP
- مطلوب PHP 8.4 أو أعلى
- يُظهر إصدار PHP الحالي
اعتماديات Vendor
- يتحقق من وجود
vendor/autoload.php(يجب تثبيت اعتماديات Composer أو رفعها)
امتدادات PHP
يُتحقق من التالي:
pdo_mysql— الاتصال بقاعدة البياناتmbstring— معالجة السلاسلopenssl— التشفيرtokenizer— تحليل الكودxml— معالجة XMLctype— التحقق من الأحرفjson— معالجة JSONbcmath— العمليات الحسابيةfileinfo— اكتشاف نوع الملفcurl— استدعاءات API
صلاحيات المجلدات
storage/— يجب أن يكون قابلاً للكتابةbootstrap/cache/— يجب أن يكون قابلاً للكتابة
عرض النتائج
- علامات خضراء = المتطلب مستوفى
- علامات حمراء = المتطلب غير مستوفى (يجب الإصلاح قبل المتابعة)
إصلاح الفحوصات الفاشلة:
# تثبيت امتدادات PHP المفقودة (Ubuntu)
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-gd php8.4-zip
# إصلاح الصلاحيات
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache
# إعادة تشغيل PHP
sudo systemctl restart php8.4-fpm
الخطوة 3: إعداد قاعدة البيانات
أدخل تفاصيل اتصال MySQL/MariaDB:
| الحقل | مثال | ملاحظات |
|---|---|---|
| مضيف قاعدة البيانات | 127.0.0.1 | استخدم 127.0.0.1 بدلاً من localhost للموثوقية |
| منفذ قاعدة البيانات | 3306 | المنفذ الافتراضي لـ MySQL |
| اسم قاعدة البيانات | feedbackpulse | يجب أن تكون موجودة مسبقًا! |
| اسم مستخدم قاعدة البيانات | feedbackpulse_user | مع صلاحيات كاملة على قاعدة البيانات |
| كلمة مرور قاعدة البيانات | your_secure_password | كلمة مرور المستخدم |
قبل هذه الخطوة
يجب إنشاء قاعدة البيانات أولاً:
-- تسجيل الدخو ل إلى MySQL
mysql -u root -p
-- إنشاء قاعدة البيانات
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- إنشاء مستخدم مخصص (موصى به)
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
ما الذي يحدث عند النقر على "إعداد قاعدة البيانات"
- يختبر المثبّت الاتصال
- يحفظ بيانات اعتماد قاعدة البيانات في ملف
.env - يُشغّل جميع عمليات ترحيل قاعدة البيانات (ينشئ ~30 جدولاً)
- يُلقّح البيانات الافتراضية:
- 3 خطط اشتراك افتراضية (Starter وGrowth وPro)
- إعدادات المنصة الافتراضية
- يُظهر رسالة نجاح
ملاحظة: تظل برامج تشغيل الجلسة والذاكرة المؤقتة بـ
fileأثناء التثبيت للاستقرار. يتم التبديل تلقائيًا إلىdatabaseفي خطوة الاكتمال.
قد تستغرق هذه الخطوة 10-30 ثانية حسب خادمك.
الخطوة 4: حساب المشرف
أنشئ حساب المشرف العام:
| الحقل | مثال | ملاحظات |
|---|---|---|
| الاسم الكامل | John Smith | اسمك الظاهر |
| عنوان البريد الإلكتروني | [email protected] | يستخدم لتسجيل الدخول والإشعارات |
| كلمة المرور | (كلمة مرور قوية) | 8 أحرف على الأقل. استخدم كلمة مرور قوية! |
| تأكيد كلمة المرور | (يجب أن تتطابق) | يجب أن تتطابق |
ما الذي يحدث
- ينشئ حساب مستخدمك بـ
role = superadmin - هذا الحساب الوحيد للمشرف العام الذي يُنشأ تلقائيًا
- ستستخدم هذا للدخول على
/loginوالوصول إلى/admin/dashboard
نصيحة أمنية: استخدم كلمة مرور فريدة وقوية. يمكنك تفعيل 2FA لاحقًا في الإعدادات.
الخطوة 5: إعداد البريد الإلكتروني
قم بإعداد SMTP لإرسال رسائل البريد التحويلية:
| الحقل | مثال | ملاحظات |
|---|---|---|
| مضيف SMTP | smtp.gmail.com | خادم SMTP لمزود البريد الإلكتروني |
| منفذ SMTP | 587 | 587 لـ TLS، 465 لـ SSL |
| اسم مستخدم SMTP | [email protected] | عادةً عنوان بريدك الإلكتروني |
| كلمة مرور SMTP | your_app_password | كلمة مرور التطبيق المخصصة موصى بها |
| التشفير | tls | TLS (موصى به) أو SSL |
| عنوان الإرسال | [email protected] | عنوان "من" في رسائل البريد الصادرة |
| اسم المُرسل | FeedbackPulse | اسم "من" في رسائل البريد الصادرة |
مزودو SMTP الشائعون
| المزود | المضيف | المنفذ | التشفير | ملاحظات |
|---|---|---|---|---|
| Gmail | smtp.gmail.com | 587 | TLS | يتطلب كلمة مرور التطبيق (وليس كلمة المرور العادية) |
| Mailgun | smtp.mailgun.org | 587 | TLS | رائع للبريد التحويلي |
| Amazon SES | email-smtp.{region}.amazonaws.com | 587 | TLS | فعّال من حيث التكلفة على نطاق واسع |
| SendGrid | smtp.sendgrid.net | 587 | TLS | استخدم apikey كاسم مستخدم |
| Postmark | smtp.postmarkapp.com | 587 | TLS | أفضل إمكانية توصيل |
| Mailtrap | sandbox.smtp.mailtrap.io | 587 | TLS | للاختبار فقط! |
لا تستطيع إعداد البريد الآن؟ يمكنك تخطي هذه الخطوة وإعدادها لاحقًا في
الإدارة ← الإعدادات ← البريد الإلكتروني. ستعمل المنصة بدون بريد إلكتروني، لكن ميزات مثل الدعوات والملخصات وإعادة تعيين كلمة المرور لن تعمل.
الخطوة 6: اكتمال التثبيت!
ستظهر صفحة نجاح تتضمن:
- قاعدة البيانات مُع دَّة وتم ترحيلها
- حساب المشرف منشأ
- البريد الإلكتروني مُعدَّ
- ملف
installed.lockمنشأ - برامج تشغيل الجلسة والذاكرة المؤقتة مُبدَّلة إلى
database CRON_TOKENمُنشأ تلقائيًا لـ cron المستند إلى الويب- إشعار الاستضافة المشتركة (إذا لم يُنشأ الرابط الرمزي)
تعليمات إعداد Cron Job (تُعرض على صفحة الاكتمال)
تعرض صفحة الاكتمال خيارَي إعداد cron مع أوامر للنسخ واللصق:
-
أمر CLI — لخوادم VPS/المخصصة:
* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1 -
URL/wget — للاستضافة المشتركة (يستخدم
CRON_TOKENالمُنشأ تلقائيًا):wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
احفظها! انسخ أمر cron من صفحة الاكتمال قبل المغادرة. يمكنك أيضًا العثور على
CRON_TOKENفي ملف.env.
ملف installed.lock
ينشئ المثبّت storage/installed.lock لمنع أي شخص من إعادة تشغيل المثبّت. هذا إجراء أمني.
لإعادة تشغيل المثبّت (مثلاً للتثبيت الجديد)، احذف هذا الملف:
rm storage/installed.lockثم ز ر
/installمرة أخرى.
قائمة تحقق ما بعد التثبيت
بعد اكتمال المثبّت:
- إعداد cron job باستخدام التعليمات المعروضة على صفحة الاكتمال (راجع Cron Jobs وعمال قائمة الانتظار)
- سجّل الدخول على
https://yourdomain.com/loginببيانات المشرف العام - زر
الإدارة ← الخطط— راجع وخصّص خطط الاشتراك - زر
الإدارة ← الإعدادات ← المدفوعات— اربط Stripe/PayPal - زر
الإدارة ← الإعدادات ← البريد الإلكتروني— أرسل بريدًا اختباريًا - زر
الإدارة ← صفحة الهبوط— خصّص صفحتك الرئيسية العامة - إعداد SSL (راجع شهادات SSL)
- إعداد DNS الشامل اختياريًا (راجع إعداد DNS الشامل)
الخطوات التالية
- إعداد Apache أو إعداد Nginx
- متغيرات البيئة — ضبط
.envالخاص بك - Cron Jobs وعمال قائمة الانتظار — إعداد المهام التلقائية