بوابة MPWA واتساب (CPanel)

دليل شامل لتثبيت MPWA على CPanel.

المقدمة

MPWA هو بوابة واتساب متعددة الأجهزة متينة مصممة للعمل بسلاسة على بيئات استضافة متعددة. يقدم هذا الدليل متطلبات التثبيت الأساسية ويوفر خطوات تفصيلية للحصول على MPWA وتشغيله بكفاءة.

الميزات

يمكنك رؤية الميزات هنا.

المتطلبات

قبل أن تبدأ، تأكد من أن بيئة CPanel لديك تلبي المتطلبات التالية:

  • PHP: الإصدار 8.1 أو أحدث.
  • Node.js: الإصدار 18 أو أحدث.
  • MySQL: إعداد قاعدة بيانات MySQL مهيأة.

هذه الأدوات ضرورية لوظائف MPWA ويجب تثبيتها وتكوينها بشكل صحيح على بيئة الاستضافة الخاصة بك.

التثبيت

الخطوة 1: إنشاء نطاق

  1. قم بتسجيل الدخول إلى CPanel الخاص بك.

  2. انتقل إلى Domains وقم بإنشاء نطاق جديد إذا لم تقم بذلك مسبقًا.

    Domains

الخطوة 2: إنشاء قاعدة بيانات

  1. انتقل إلى Manage My Database في CPanel.

    Manage My Database

  2. ضمن قسم New Database، أدخل اسمًا لقاعدة البيانات الخاصة بك، على سبيل المثال wa، ثم انقر على Create Database.

    New Database

  3. ارجع إلى صفحة Manage My Database وقم بإنشاء مستخدم جديد لقاعدة البيانات:

    • أدخل اسم المستخدم وكلمة المرور في قسم Add New User.
    • انقر على Create User.

    Create User

  4. قم بربط المستخدم بقاعدة البيانات:

    • في قسم Add User to Database، حدد قاعدة البيانات والمستخدم الذين قمت بإنشائهما للتو.
    • انقر على Add.

    Add User to Database

  5. في صفحة Manage User Privileges، حدد ALL PRIVILEGES لمنح الوصول الكامل.

    • انقر على Make Changes.

    Manage User Privileges

الخطوة 3: تنزيل ملفات MPWA

  1. قم بتنزيل أحدث إصدار من MPWA من الرابط التالي:
    تنزيل أحدث إصدار

  2. افتح File Manager في CPanel وانتقل إلى مجلد النطاق الذي قمت بإنشائه.

    File Manager

  3. قم برفع ملف ZIP الذي تم تنزيله إلى هذا المجلد عن طريق النقر على Upload، ثم استخرج الملفات باستخدام خيار Extract.

    Extract

الخطوة 4: بدء التثبيت

  1. قم بزيارة عنوان URL لموقعك. ستفتح صفحة المثبّت تلقائيًا.

    Installation

  2. في صفحة المثبّت، ستظهر لك التكوينات المطلوبة، بما في ذلك إصدار PHP، وإصدار MySQL، والوظائف المطلوبة.

    • إذا كانت جميع الفحوصات تحمل علامة خضراء، انقر على Next للمتابعة.
    • إذا كانت أي من الوظائف المطلوبة معطلة، فاتصل بمزود الاستضافة الخاص بك لتمكينها.

الخطوة 5: تكوين قاعدة البيانات

  1. أدخل بيانات قاعدة البيانات التي قمت بإنشائها سابقًا، بما في ذلك:
    • مضيف قاعدة البيانات (Database Host)
    • اسم مستخدم قاعدة البيانات (Database Username)
    • كلمة مرور قاعدة البيانات (Database Password)
    • اسم قاعدة البيانات (Database Name)

انقر على Next للمتابعة.

Configure the Database

الخطوة 6: إعداد تفاصيل المسؤول

  1. في الصفحة التالية، أدخل التفاصيل الخاصة بحساب المسؤول:

    • اسم المستخدم للمسؤول (Admin Username)
    • كلمة المرور للمسؤول (Admin Password)
    • عنوان البريد الإلكتروني (Email Address)

    Set Admin Details

  2. بعد إكمال النموذج، انقر على Submit. سيتم إنهاء عملية التثبيت وستتم إعادة توجيهك إلى لوحة التحكم الإدارية الخاصة بـ MPWA.

    dashboard

الخطوة 7: تكوين نوع الخادم

  1. في لوحة إدارة MPWA، انتقل إلى Admin > Server Settings.

  2. اختر نوع الخادم المناسب:

    • Localhost: للاستخدام الشخصي على جهازك الخاص.
    • Hosting: لبيئات الاستضافة المشتركة.
    • Other: لـ VPS، VDS، أو الخوادم المخصصة.

    ملاحظة:
    إذا اخترت Other، فسيستخدم السكربت بروتوكولات ws أو wss. هذا الخيار غير متاح على الاستضافة المشتركة لأنه يتطلب الوصول إلى منافذ محددة. بالنسبة للاستضافة المشتركة، اختر دائمًا Hosting.

  3. أدخل رقم المنفذ (Port) (على سبيل المثال: 3100، 3121، أو أي رقم مكون من 4 أرقام باستثناء 8080 أو 3306).

    port

  4. لمستخدمي Nginx: إذا كانت الاستضافة المشتركة لديك تستخدم Nginx، استخدم https بدلاً من http حيث يقوم Nginx بتحويل الطلبات تلقائيًا من http إلى https.

الخطوة 8: تحقق من إعدادات .env

  1. افتح File Manager في CPanel.
  2. حدد موقع ملف .env في المجلد الرئيسي لمشروعك.
  3. تحقق من الإعدادات وقم بتحديثها على النحو التالي:

للاستضافة المشتركة:

APP_URL=https://yoursite.com
WA_URL_SERVER=https://yoursite.com
PORT_NODE=3100
TYPE_SERVER=hosting

لـ VPS، VDS، أو الخوادم المخصصة:

APP_URL=https://yoursite.com
WA_URL_SERVER=https://yoursite.com:3100
PORT_NODE=3100
TYPE_SERVER=other

مهم:
إذا كنت تستخدم https لتطبيق Node.js الخاص بك، فتأكد من تثبيت شهادات SSL. بالنسبة للاستضافة المشتركة أو الخوادم التي تستخدم Nginx، لا تحتاج إلى ملفات SSL منفصلة لـ Node.js. لمستخدمي Apache، راجع الدليل التالي لإعداد SSL لـ Node.js:
[دليل SSL لـ Node.js](?doc=Node.js SSL Guide)

الخطوة 9: إعداد Node.js

  1. في CPanel، انتقل إلى Setup Node.js App.

    Set Up Node.js

  2. انقر على CREATE APPLICATION وأدخل التفاصيل التالية:

    • إصدار Node.js: اختر 20.17.0 أو أي إصدار أعلى من 18.
    • وضع التطبيق (Application mode): قم بتعيينه إلى Production.
    • المجلد الجذر للتطبيق (Application root): أدخل المسار إلى دليل مشروعك، مثل /home/username/mpwa.my.id.
    • رابط التطبيق (Application URL): اختر اسم النطاق الخاص بك.
    • ملف بدء التشغيل (Application startup file): أدخل server.js.

انقر على CREATE في الأعلى لإكمال إعداد التطبيق.

CREATE APPLICATION

  1. بعد إنشاء التطبيق، انقر على START APP لتشغيل تطبيق Node.js.

    START APP

الخطوة 10: إنهاء التثبيت

تهانينا! تم تثبيت MPWA بنجاح. يمكنك الآن تسجيل الدخول إلى لوحة الإدارة والقيام بالخطوات التالية:

  1. أضف رقم هاتفك.

  2. قم بإنشاء رمز QR لربط حساب واتساب الخاص بك.

    Add your phone number

    QR code

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

إذا واجهت أي مشكلات أثناء عملية التثبيت:

  • تأكد من أن جميع وظائف PHP المطلوبة و Node.js تم تكوينها بشكل صحيح.
  • تحقق من أن بيئة الاستضافة الخاصة بك تدعم التكوينات المطلوبة.
  • يمكنك زيارة صفحة استكشاف الأخطاء وإصلاحها للحصول على الإجابات.
  • إذا لزم الأمر، تواصل مع مزود الاستضافة الخاص بك للحصول على المساعدة بشأن الأذونات أو التكوينات.

أنت جاهز الآن! استمتع باستخدام MPWA لإدارة اتصالاتك عبر واتساب بكفاءة.

كيفية الاستخدام →