Modül Kurulum Rehberi - WHMCS, WordPress & WiseCP

تنزيل وحدة WHMCS (v5.9.0) تنزيل إضافة WordPress (v5.9.0) WiseCP Modülünü İndir (v5.9.0)

البنية بلا خوادم: تحمل الوحدات بيانات اعتماد API الخاصة بك مدمجة بداخلها. لا حاجة لإضافة خادم أو إدخال API URL أو API Key. يتم إنشاء الوحدة التي تنزّلها خصيصاً لحساب الموزّع الخاص بك.

متطلبات النظام

WHMCS

WHMCS 7.x أو 8.x أو 9.x
PHP 7.2 أو أحدث (مع دعم PHP 8.x)
إضافة cURL لـ PHP
امتداد JSON PHP
وصول FTP/SFTP أو cPanel

WordPress

WordPress 5.8 أو أحدث
WooCommerce 6.0 أو أحدث
PHP 7.4 أو أحدث
wp_remote_request() (الافتراضي)
وصول FTP/SFTP أو wp-admin

حساب DATASSL

حساب موزّع نشط
مفتاح API (يُضمَّن تلقائيًا)
رصيد كافٍ
مجموعة المنتجات المعرّفة

خطوات التثبيت

نزّل الوحدة

سجّل الدخول إلى لوحة الموزّع الخاصة بك و تنزيل الوحدة نزّل وحدة WHMCS من القسم. أو يمكنك التنزيل مباشرة باستخدام الزر أدناه.

تنزيل وحدة WHMCS

يحمل ملف ZIP الذي تم تنزيله مفتاح API الخاص بك مضمّنًا بداخله. ولا تحتاج إلى إدخال مفتاح API بشكل منفصل.

فك ضغط ملف ZIP

الذي قمت بتنزيله datassl_whmcs_v5.9.0.zip افتح الملف. ستجد بداخله البنية التالية:

📁 modules/
  📁 servers/
    📁 datassl/ ← وحدة الخادم (Provisioning)
      📄 datassl.php — الملف الرئيسي للوحدة
      📁 lib/
        📄 ApiClient.php — فئة عميل API
      📄 hooks.php — WHMCS hooks
      📁 templates/
        📄 clientarea.tpl — قالب لوحة العميل
        📄 admin.tpl — قالب لوحة الإدارة
        📄 overview.tpl — قالب النظرة العامة
  📁 addons/
    📁 datassl/ ← وحدة إدارة Addon
      📄 datassl.php — الملف الرئيسي للـ Addon
      📄 hooks.php — Addon hooks
      📄 cron.php — cron مزامنة الطلبات
      📁 lib/
        📄 ApiClient.php — فئة عميل API
        📄 Helper.php — دوال مساعدة
📄 README.md
📄 CHANGELOG.md

ارفع الملفات إلى WHMCS

الموجود داخل ملف ZIP modules ارفع المجلد إلى مجلد تثبيت WHMCS لديك. يمكنك استخدام FTP أو SFTP أو مدير ملفات cPanel.

FTP / SFTP


                                # انسخ المجلدين كليهما إلى دليل WHMCS:

                                modules/servers/datassl/ → /home/user/public_html/whmcs/modules/servers/datassl/

                                modules/addons/datassl/ → /home/user/public_html/whmcs/modules/addons/datassl/

هام: WHMCS الحالي modules من المجلد داخل انسخ. لا تكتب فوق المجلد، بل فقط servers/datassl و addons/datassl أضف المجلدات الفرعية.

أذونات الملفات: لملفات PHP 644، للمجلدات 755 الإذن كافٍ.

فعّل وحدة Addon

انتقل إلى لوحة إدارة WHMCS وفعّل وحدة addon:

إدارة WHMCS سجّل الدخول إلى اللوحة
Setup → Addon Modules انتقل إلى الصفحة
"DATASSL SSL Certificates" ابحث عن الوحدة
"Activate" انقر على الزر
Access Control اختر أدوار المسؤول من القسم (مثال: Full Administrator)
"Save Changes" احفظه باستخدام

التثبيت التلقائي: أثناء التفعيل تقوم الوحدة تلقائيًا بما يلي:

تنشئ جداول قاعدة البيانات (mod_datassl_orders, mod_datassl_logs, mod_datassl_settings)
ينشئ 5 قوالب بريد إلكتروني (SSL Configuration, Issued, Expiry, Renewed, Reissued)

إنشاء المنتج (الطريقة 1: لوحة Addon - موصى بها)

في لوحة Addon منشئ المنتجات أضف المنتجات بشكل جماعي باستخدام:

Addons → DATASSL SSL Certificates انتقل إلى القائمة
من القائمة اليسرى "منشئ المنتجات" افتح الصفحة
المكان الذي ستُضاف إليه المنتجات مجموعة منتجات WHMCS اختر (أنشئه أولًا إن لم يكن موجودًا)
نسبة هامش الربح (Markup) حدّد (مثال: 20%)
المنتجات التي تريد إضافتها اختر
"إضافة المنتجات المحددة إلى WHMCS" انقر على الزر

التسعير التلقائي: يقوم منشئ المنتجات بالتسعير تلقائيًا بجميع العملات وفقًا لنسبة الربح (Markup) التي تحددها. وبالنسبة للمنتجات التي تدعم SAN يتم إنشاء Configurable Options تلقائيًا.

إنشاء المنتج (الطريقة 2: يدوي)

يمكنك أيضًا إنشاء المنتجات يدويًا واحدًا تلو الآخر:

Setup → Products/Services → Products/Services انتقل إلى الصفحة
"Create a New Product" انقر على الزر
Product Type: أخرى اختر
حدّد مجموعة المنتج واسمه، "Continue" انقر
Module Settings انتقل إلى علامة التبويب
Module Name: "DATASSL SSL Certificates" اختر
"منتج DATASSL" اختر منتج الشهادة من القائمة المنسدلة
"Save Changes" احفظه باستخدام

تُعرض في القائمة المنسدلة للمنتجات بجوار أسماء المنتجات نوع التحقق (DV/OV/EV) ومعلومات SAN وسعر الموزّع. إذا كانت القائمة المنسدلة فارغة، فتحقق من اتصال API.

إعداد Cron (موصى به)

أضف مهمة cron مستقلة لمزامنة حالات الطلبات تلقائياً. تتحقق مهمة cron هذه عبر API من حالة جميع الطلبات وتحدّث حالات خدمات WHMCS.

Crontab


                                # تشغيل كل 6 ساعات (موصى به)

                                0 */6 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php


                                # أو كل 4 ساعات

                                0 */4 * * * php /home/user/public_html/whmcs/modules/addons/datassl/cron.php

البديل: حتى إن لم تضف مهمة Cron، فإن مهمة Cron اليومية الخاصة بـ WHMCS (DailyCronJob hook) تتم مزامنة الطلبات تلقائيًا مرة واحدة يوميًا. ولكن يُوصى باستخدام cron مستقل للحصول على تحديثات أكثر تكرارًا.

اختبر التثبيت

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

Addons → DATASSL SSL Certificates انتقل إلى القائمة
نظرة عامة تحقق من حالة API والرصيد والإحصائيات في الصفحة
من القائمة اليسرى الإعدادات انتقل إلى الصفحة
"اختبار الاتصال" انقر على الزر — يجب أن ترى علامة تحقق خضراء
إذا ظهر اسم الموزّع والرصيد ونسبة الخصم بشكل صحيح فقد اكتمل الإعداد

تهانينا! تم تثبيت وحدة WHMCS بنجاح. يمكنك الآن البدء ببيع شهادات SSL.

صفحات لوحة Addon

نظرة عامة

حالة API، والرصيد، وإحصاءات الطلبات، وآخر الطلبات، واختصارات الوصول السريع

منشئ المنتجات

أضف منتجات API إلى WHMCS بشكل جماعي. ضبط الهامش (Markup)، وأتمتة SAN والتسعير

الطلبات

أدر جميع طلبات SSL من شاشة واحدة. التصفية والبحث ومزامنة الحالة

سجلات العمليات

سجلات نشاط مفصّلة واستدعاءات API وتتبع الأخطاء

الإعدادات

اختبار اتصال API، ومعلومات الوحدة، وإعداد Cron، وحالة قاعدة البيانات

تنزيل الإضافة

سجّل الدخول إلى لوحة الموزّع الخاصة بك و تنزيل الوحدة نزّل إضافة WordPress من القسم.

تنزيل إضافة WordPress

يحمل ملف ZIP الذي تم تنزيله مفتاح API الخاص بك مضمّنًا فيه. يمكنك تغييره من صفحة إعدادات WordPress.

فك ضغط ملف ZIP

الذي قمت بتنزيله datassl_wordpress_v5.9.0.zip يحتوي الملف على البنية التالية:

📁 datassl/ ← مجلد الإضافة
  📄 datassl.php — الملف الرئيسي للإضافة
  📄 uninstall.php — إلغاء تثبيت نظيف
  📁 includes/
    📄 class-api-client.php — فئة عميل API
    📄 class-admin.php — لوحة الإدارة
    📄 class-orders.php — إدارة الطلبات
    📄 class-woocommerce.php — تكامل WooCommerce
    📄 class-cron.php — المهام المجدولة
  📁 assets/
    📁 css/ — ملفات الأنماط
    📁 js/ — ملفات JavaScript

تثبيت الإضافة

يمكنك استخدام إحدى طريقتين:

الطريقة 1: WordPress Admin

الإضافات → إضافة جديدة → رفع إضافة → اختر ملف ZIP → تثبيت

الطريقة 2: FTP / SFTP

datassl/ → /home/user/public_html/wp-content/plugins/datassl/

بعد الرفع الإضافات من الصفحة DATASSL SSL Certificates الإضافة فعّلها.

WooCommerce مطلوب: تعمل هذه الإضافة مع WooCommerce. إذا لم يكن WooCommerce مثبّتًا ونشطًا، فتعرض الإضافة لوحة المسؤول فقط.

اضبط الإعدادات

في القائمة اليسرى لـ WordPress DATASSL → الإعدادات افتح الصفحة:

API URL

يأتي مدمجاً تلقائياً

مفتاح API

يأتي مدمجاً تلقائياً

اختبار الاتصال

تحقق عبر API بنقرة واحدة

أنشئ منتج WooCommerce

أنشئ منتجاً جديداً من WooCommerce واختر نوع المنتج شهادة DATASSL SSL اختره كـ:

المنتجات → إضافة جديد
في القائمة المنسدلة «بيانات المنتج»، "شهادة DATASSL SSL" اختر
"منتج DATASSL API" من علامة التبويب، اختر شهادة SSL التي تريد بيعها
املأ السعر والتفاصيل الأخرى
حفظ ونشر

منتج افتراضي: يُصنَّف منتج SSL تلقائيًا كمنتج افتراضي (virtual). لا يتطلب شحنًا.

اختبر التثبيت

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

DATASSL → نظرة عامة في الصفحة، تحقق من معلومات حسابك
اختبار الاتصالقم بتشغيله
DATASSL → المنتجات تحقق من إدراج منتجات API في الصفحة
في حساب العميل، حسابي → شهادات SSL تحقق من ظهور القائمة
تحقق من المسار بأكمله عبر إنشاء طلب تجريبي

تهانينا! تم تثبيت إضافة WordPress بنجاح. يمكنك الآن البدء ببيع شهادات SSL عبر WooCommerce.

ميزات لوحة العميل

تكوين SSL

إعداد سهل من صفحة حسابي → شهادات SSL عبر إدخال CSR واختيار النطاق وطريقة DCV

تتبّع الحالة

فحص تلقائي للحالة كل 30 ثانية، وخيارات تغيير طريقة DCV وإلغاء الطلب

عرض الشهادة

أزرار نسخ ملفات Certificate وCA Bundle وPrivate Key بنقرة واحدة (عرض الوضع الداكن)

إعادة النشر

إعادة إصدار الشهادة (CSR جديد اختياري)، تغيير طريقة DCV، إلغاء الطلب

مقارنة الوحدات

الميزة	وحدة WHMCS	إضافة WordPress
الإصدار	v5.9.0	v1.0.0
البنية	Server + Addon (2 وحدات)	وحدة المنتج
متطلبات إعدادات الخادم	✓ غير مطلوب (Serverless)	✓ غير مطلوب (Serverless)
تضمين مفتاح API تلقائيًا	✓ نعم	✓ نعم
منشئ المنتجات (جماعي)	✓ من لوحة Addon	✗ إنشاء يدوي
لوحة إدارة Addon	✓ لوحة كاملة من 5 صفحات	✓ لوحة من 4 صفحات (Dashboard، الطلبات، المنتجات، الإعدادات)
مزامنة الطلبات	✓ Cron + cron WHMCS اليومي	✓ مزامنة WP Cron اليومية
قوالب البريد الإلكتروني	✓ 5 قوالب تلقائية	wp_mail ile süre uyarıları
دعم SAN (Multi-Domain)	✓ عبر Configurable Options	✓ نعم
دعم Wildcard SAN	✓ نعم	✓ نعم
دعم متعدد السنوات	✓ نعم	✓ نعم
إعداد SSL للعملاء	معالج من 3 خطوات	نموذج لوحة العميل
تنزيل الشهادة / نسخها	✓ نعم	✓ نعم
عرض حالة المسؤول	✓ مرمّز بالألوان	✓ مرمّز بالألوان
منطق إعادة المحاولة	✓ 2 محاولات إعادة	2 tekrar
دعم اللغات	الإنجليزية (لغة WHMCS)	التركية + الإنجليزية
تذكير بانتهاء الصلاحية	✓ 30/14/7/3/1 يوم	wp_mail ile süre uyarıları

نزّل الوحدة

سجّل الدخول إلى لوحة الموزّع الخاصة بك و تنزيل الوحدة bölümünden WiseCP modülünü indirin. Ya da aşağıdaki butonu kullanarak doğrudan indirebilirsiniz.

WiseCP Modülünü İndir

يحمل ملف ZIP الذي تم تنزيله مفتاح API الخاص بك مضمّنًا بداخله. ولا تحتاج إلى إدخال مفتاح API بشكل منفصل.

فك ضغط ملف ZIP

İndirdiğiniz ZIP dosyasını açın. İçinde şu yapıyı göreceksiniz:

📂 coremio/modules/Product/DATASSL/

├── DATASSL.php — الملف الرئيسي للوحدة

├── api.php — API istemcisi

├── config.php — الإعدادات

├── logo.png — شعار الوحدة

📂 controllers/

└── test_connection.php

📂 pages/

├── settings.php

├── product-detail.php

├── order-detail.php

└── ac-order-detail.php

📂 lang/

├── tr.php

└── en.php

ارفع الملفات

الموجود داخل ملف ZIP coremio/ klasörünü WiseCP kurulum dizininizin kök klasörüne FTP / dosya yöneticisi ile yükleyin. Mevcut coremio/ المجلد الموجود.

                            
                                /home/kullanici/public_html/

                                ├── coremio/

                                │   ├── modules/

                                │   │   └── Product/

                                │   │       └── DATASSL/ ← تم الرفع هنا

                                │   ├── ...

                                └── index.php

هام: coremio/modules/Product/DATASSL/ المجلد: تأكد من رفع جميع الملفات الموجودة تحته بالكامل.

إعداد إعدادات الوحدة

سجّل الدخول إلى لوحة إدارة WiseCP واتبع الخطوات التالية:

الإعدادات → وحدات المنتجات قسم — انتقل إليه
DATASSL modülünü listede bulun ve الإعدادات ikonuna tıklayın
API URL و مفتاح API alanlarını kontrol edin (otomatik gömülüdür)
اختبار الاتصال انقر على الزر
بعد ظهور رسالة «تم الاتصال بنجاح!» حفظ— انقر عليه

تم تضمين بيانات API الخاصة بك تلقائيًا في الوحدة التي نزّلتها. إذا لم تكن هناك مشكلة في اختبار الاتصال فلا حاجة إلى تغييرها.

إنشاء منتج SSL

أنشئ منتج SSL جديدًا من لوحة إدارة WiseCP:

المنتج/الخدمة → المنتجات والخدمات قسم — انتقل إليه
اختر شهادة SSL كنوع للمنتج
كوحدة DATASSL اختر
الأتمتة التبويب: اربط منتج DATASSL API
حدّد الأسعار واحفظ

دعم SAN (Multi-Domain)

Multi-domain SSL satmak istiyorsanız:

في صفحة تعديل المنتج، الخيارات القابلة للتهيئة'a gidin
كنوع، الكمية (Quantity) اختر
من أيقونة الترس للإعدادات، اضبط قيمة sans_count على 1 نفّذ ذلك
احفظ — ستضيف كل وحدة من الخيار 1 نطاق SAN إضافيًا

مسار عملية SSL

بعد تفعيل الوحدة، تتم معالجة طلبات SSL وفق المسار التالي:

1 الطلب — يختار العميل المنتج ويدخل النطاق وCSR

2 اختيار DCV — يتم اختيار طريقة EMAIL أو HTTP أو HTTPS أو DNS

3 التحقق — يُكمل العميل خطوات طريقة DCV التي اختارها

4 الشهادة — يتم تنزيل الشهادة عبر الفحص التلقائي وتسليمها للعميل

Müşteri İşlemleri

يمكن للعملاء القيام بما يلي من صفحة تفاصيل الطلب:

تغيير طريقة DCV: يمكنه تغيير طريقة التحقق الحالية (مثال: EMAIL → DNS)
إعادة إرسال التحقق: يمكنه إعادة إرسال التحقق عبر البريد الإلكتروني
إعادة الإصدار (Reissue): يمكنه إعادة إصدار الشهادة بواسطة CSR جديد
تنزيل الشهادة: يمكنه تنزيل الشهادة الصادرة
التحقق من الحالة: يمكنه التحقق من حالة SSL فوريًا

تُنفَّذ جميع هذه العمليات تلقائيًا عبر DATASSL API. لا حاجة إلى تدخل يدوي.

الأسئلة الشائعة

هل أحتاج إلى إضافة خادم؟

لا. تعمل جميع الوحدات ببنية بلا خوادم (serverless). يتم تضمين API URL وAPI Key تلقائياً في ملفات الوحدات. لا حاجة إلى لمس قسم "Servers" في WHMCS ولا الإعدادات الإضافية في WordPress.

أين يجب أن أدخل مفتاح API الخاص بي؟

لا حاجة لإدخاله في أي مكان. عند تنزيل الوحدة من لوحة الموزّع في DATASSL، يتم تضمين مفتاح API الخاص بك تلقائياً في ملفات الوحدة. وعند تشغيل الوحدة تستخدم هذا المفتاح المدمج.

ماذا يجب أن أفعل لتحديث الوحدة؟

نزّل الإصدار الجديد من لوحة DATASSL الخاصة بك وارفعه فوق الملفات الموجودة. تتحقق وحدة WHMCS addon تلقائياً من جداول قاعدة البيانات وقوالب البريد الإلكتروني أثناء التحديث وتضيف المفقود منها. تبقى بياناتك محفوظة.

لا يظهر أي منتج في القائمة المنسدلة للمنتجات، ماذا أفعل؟

يشير هذا عادةً إلى مشكلة في اتصال API. تحقق مما يلي:

إضافة cURL نشط؟ (php -m | grep curl)
جدار حماية الخادم هل يحظر الاتصالات الخارجية؟
حساب الموزّع الخاص بك نشط وهل مجموعة المنتجات معرّفة؟
في WHMCS: في لوحة Addon الإعدادات → اختبار الاتصال نفّذ ذلك
من لوحة المسؤول "تحديث قائمة المنتجات" انقر على الزر (يتم مسح ذاكرة التخزين المؤقت)

هل يمكن للعميل تقديم طلب دون إدخال CSR؟

نعم. إذا لم يتم إدخال CSR أثناء الطلب فإن الخدمة "في انتظار الإعداد" يتم التفعيل في حالة (awaiting_configuration). يمكن للعميل لاحقًا إكمال إعداد SSL من لوحته (Client Area) عبر إدخال CSR.

كيف أفعّل دعم SAN (نطاقات إضافية)؟

WHMCS: إذا أضفت المنتجات باستخدام منشئ المنتجات في لوحة Addon، فسيتم إنشاء Configurable Options تلقائيًا للمنتجات التي تدعم SAN. وإذا كنت تنشئها يدويًا، فبإضافة Configurable Options Group san_count و san_domains عرّف الحقول.

WordPress: يأتي دعم SAN مدمجًا في الإضافة. أثناء إتمام الطلب يُدخل العميل نطاقاته الإضافية.

هل يُخصم رصيدي تلقائياً من الطلبات؟

نعم. في جميع الطلبات التي تُنشأ عبر API يُخصم المبلغ تلقائيًا من رصيدك. إذا لم يكن الرصيد كافيًا فلن يُنشأ الطلب (يُرجَع خطأ HTTP 402). تعرض الوحدات ذلك للعميل في صورة رسالة خطأ واضحة.

هل شهادات توقيع الكود (Code Signing) مدعومة؟

نعم. شهادات Code Signing وEV Code Signing مدعومة بالكامل. لا تتطلب أنواع المنتجات هذه التحقق من النطاق (DCV) ويتم إخفاء حقل النطاق. يكفي CSR ومعلومات الاتصال فقط.

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

المشكلة	الحل
WHMCS: Addon لا يظهر في القائمة	تأكد من تفعيلها من Setup → Addon Modules ومن اختيار أدوار المسؤول
WHMCS: تعذّر إنشاء المنتج	يجب إنشاء مجموعة منتجات في WHMCS (Product Group) أولًا
WHMCS: لا تظهر الوحدة في Module Settings	`modules/servers/datassl/datassl.php` تحقق من أن الملف في المسار الصحيح
خطأ اتصال API	تأكد من أن خادمك لا يحظر الاتصالات الخارجية. `curl` و `json` تحقق من إضافات PHP
تعذّر إنشاء الطلب	WHMCS: اطّلع على الخطأ التفصيلي من Utilities → Logs → Module Log. تحقق من رصيدك
تعذّر تنزيل الشهادة	قد لا تكون الشهادة جاهزة بعد. زامن حالة الطلب وانتظر حتى تتحول إلى "active/issued"
Cron لا يعمل	تأكد من صحة مسار PHP: `which php`. تحقق من سجلات Cron: `/var/log/cron`

هل تحتاج إلى مساعدة؟
إذا واجهت مشكلة في التثبيت، فتواصل مع فريق الدعم لدينا.
إنشاء تذكرة دعم

دليل تثبيت الوحدة

متطلبات النظام

WHMCS

WordPress

حساب DATASSL

خطوات التثبيت

نزّل الوحدة

فك ضغط ملف ZIP

ارفع الملفات إلى WHMCS

فعّل وحدة Addon

إنشاء المنتج (الطريقة 1: لوحة Addon - موصى بها)

إنشاء المنتج (الطريقة 2: يدوي)

إعداد Cron (موصى به)

اختبر التثبيت

صفحات لوحة Addon

نظرة عامة

منشئ المنتجات

الطلبات

سجلات العمليات

الإعدادات

تنزيل الإضافة

فك ضغط ملف ZIP

تثبيت الإضافة

اضبط الإعدادات

أنشئ منتج WooCommerce

اختبر التثبيت

ميزات لوحة العميل

تكوين SSL

تتبّع الحالة

عرض الشهادة

إعادة النشر

مقارنة الوحدات

نزّل الوحدة

فك ضغط ملف ZIP

ارفع الملفات

إعداد إعدادات الوحدة

إنشاء منتج SSL

دعم SAN (Multi-Domain)

مسار عملية SSL

Müşteri İşlemleri

الأسئلة الشائعة

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