📥 التثبيت

يتم تثبيت PulseHub من خلال معالج عبر المتصفح في خطوتين. لا يوجد شيء لتجميعه ولا حاجة لأي وصول لسطر الأوامر.

---

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

1. قم بتحميل pulsehub-php.tar.gz واستخرجه على جهازك المحلي. ستحصل على مجلد باسم pulsehub-php/.
2. ارفع محتويات هذا المجلد (وليس المجلد نفسه) إلى جذر الويب. في معظم الاستضافات المشتركة هو public_html/ أو www/. على VPS هو المكان الذي يشير إليه المضيف الافتراضي (مثل /var/www/pulsehub/).

بعد الرفع، يجب أن يبدو جذر الويب كالتالي:

public_html/
├── index.php
├── .htaccess
├── cron.php
├── install/
├── app/
├── public/
├── config/        ← فارغ في هذه المرحلة، يُنشأ أثناء التثبيت
└── data/

التثبيت في مجلد فرعي: إذا أردت PulseHub على https://yourdomain.com/support/ بدلاً من الجذر، ارفع الملفات إلى public_html/support/. ملف .htaccess يتعامل مع المسار تلقائيًا.

---

الخطوة 2 — تشغيل مثبّت قاعدة البيانات

افتح المتصفح وانتقل إلى:

https://yourdomain.com/install/

المثبّت — الخطوة 1: إعداد قاعدة البيانات

املأ بيانات اعتماد MySQL:

الحقل	الوصف
Database Host	عادةً localhost. في بعض الاستضافات يكون عنوان IP — تحقق من وثائق مضيفك.
Port	الافتراضي 3306. غيّره فقط إذا كان مضيفك يستخدم منفذًا غير قياسي.
Database Name	اسم قاعدة البيانات التي سيستخدمها PulseHub. سيتم إنشاؤها تلقائيًا إذا كان مستخدم MySQL لديك يمتلك صلاحية CREATE DATABASE.
Database User	اسم مستخدم MySQL الذي يملك وصولاً كاملاً لقاعدة البيانات أعلاه.
Database Password	كلمة المرور لهذا المستخدم.

انقر على Connect & Create Tables →

المثبّت — الخطوة 2: حساب المسؤول

الحقل	الوصف
Workspace Name	اسم مؤسستك، يظهر في الشريط الجانبي.
Your Name	الاسم المعروض لأول مستخدم مسؤول.
Email Address	يُستخدم لتسجيل الدخول. يجب أن يكون بتنسيق بريد إلكتروني صالح.
Password	8 أحرف كحد أدنى. يُخزّن كتشفير bcrypt — لا يُحفظ كنص عادي أبدًا.
Confirm Password	يجب أن يتطابق تمامًا.

انقر على Create Account & Finish →

---

الخطوة 3 — تسجيل الدخول

انقر على Go to PulseHub → في شاشة النجاح، أو انتقل إلى https://yourdomain.com/. أدخل البريد الإلكتروني وكلمة المرور اللذين أنشأتهما.

---

بعد التثبيت: قفل المثبّت

يتوقف المثبّت تلقائيًا عن العمل بمجرد وجود config/database.php. كإجراء احترازي إضافي، يمكنك حذف دليل install/ بالكامل بعد الإعداد باستخدام مدير الملفات في لوحة الاستضافة أو عميل FTP.

---

التحقق من التثبيت الناجح

بعد تسجيل الدخول يجب أن ترى:

• الشريط الجانبي مع Inbox، Contacts، Channels، Automations، Analytics، Settings
• اسم مساحة العمل واسمك في تذييل الشريط الجانبي
• صندوق الوارد يعرض "Select a conversation" (فارغ — لا رسائل بعد)

---

تثبيت Nginx (VPS فقط — تخطَّ على الاستضافة المشتركة)

مستخدمو الاستضافة المشتركة: مضيفك يتعامل بالفعل مع تكوين خادم الويب. هذا القسم فقط لـ VPS أو الخوادم المخصصة التي تشغل Nginx. يمكنك تخطيه بالكامل.

إذا كنت تشغل Nginx + PHP-FPM، انسخ مثال التكوين المقدم:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/pulsehub;
    index index.php;

    location ~ ^/(config|app|data)/ {
        deny all;
    }

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.4-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

ثم فعّل الموقع وأعد تحميل Nginx (طرفية VPS):

sudo ln -s /etc/nginx/sites-available/pulsehub /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx