م ماژول WHMCS

وحدة WHMCS الخاصة بـ Domain Name API هي إضافة Registrar تربط تثبيت WHMCS الخاص بك مباشرةً بالبنية التحتية لتسجيل النطاقات وSSL الخاصة بـ Domain Name API. بعد التثبيت، يقوم WHMCS تلقائيًا بتنفيذ تسجيل النطاقات، والتجديد، والنقل، وإدارة DNS، وتحديثات WHOIS نيابةً عن عملائك — دون الحاجة إلى أي إجراء يدوي من جانبك أو من جانب فريقك. كما تتم إدارة الفوترة، وتتبع المدفوعات، وإشعارات تاريخ انتهاء الصلاحية بشكل تلقائي.

تدعم الوحدة أكثر من 800 امتداد نطاق، بما في ذلك جميع نطاقات gTLD الرئيسية مثل .com و.net و.org، بالإضافة إلى نطاقات ccTLD الإقليمية مثل .tr و.com.tr و.de و.uk و.us و.cn و.ru و.in و.ge. وهي متوافقة مع cPanel وPlesk وDirectAdmin وSolusVM وجميع لوحات تحكم الاستضافة الرئيسية.

💡 يمكنك اعتبار وحدة WHMCS بمثابة الجسر بين واجهة متجرك وجهة تسجيل النطاقات. من دونها، يتطلب كل طلب معالجة يدوية؛ وبعد تثبيتها، يعمل نشاطك بالكامل في مجال النطاقات على الطيار الآلي. بالنسبة للوكلاء المستهدفين لتركيا ومنطقة الشرق الأوسط وشمال إفريقيا، فإن الدعم المدمج لـ .tr و.com.tr مع مطابقة حقول رقم الهوية التركي والرقم الضريبي يسهّل الامتثال القانوني منذ البداية.

يستغرق التثبيت أقل من 15 دقيقة. يتوفر دليل التثبيت خطوة بخطوة على العنوان domainnameapi.com/tr/bilgi-bankasi/moduller/whmcs-nasil-kurulur، كما يتوفر الشرح بالفيديو على العنوان youtube.com/watch?v=LEw_iMnquSo.

قم بتنزيل أحدث حزمة للوحدة من github.com/domainreseller.

افتح ملف ZIP وانسخ مجلد modules إلى الدليل الذي تم تثبيت WHMCS فيه (على سبيل المثال /home/whmcs/public_html). لا تحذف ملفات .gitignore وREADME.md وLICENSE.

في لوحة إدارة WHMCS، انتقل إلى إعدادات النظام > مسجلو النطاقات. إذا تم وضع الملفات في الدليل الصحيح، فسيظهر "Domain Name API" في القائمة.

فعّل الوحدة وأدخل اسم المستخدم وكلمة المرور المقدَّمين من Domain Name API. بعد الحفظ، سيظهر رصيدك على الشاشة.

إذا كنت تبيع نطاقات .tr، فقم بمطابقة حقول رقم الهوية التركي والرقم الضريبي مع حقول العميل المخصصة في WHMCS.

أدخل الأسعار يدويًا أو قم باستيراد الأسعار المباشرة بشكل جماعي مع إعدادات هامش الربح عبر Utilities > Registrar TLD Sync > DomainNameApi.

من إعدادات النظام > الإعدادات العامة > Domains، فعّل تسجيل النطاقات، وأذونات النقل، وطلبات التجديد، والتجديد التلقائي عند الدفع، ومزامنة النطاقات، ودعم IDN.

ضمن إعدادات الأتمتة، فعّل خياري Domain Sync وSync Next Due Date.

مهم: إذا كنت تجري تحديثًا، فقم بعمل نسخة احتياطية من ملفات الوحدة الحالية قبل الكتابة فوقها.

💡 الخطأ الأكثر شيوعًا في التثبيت هو رفع ملفات الوحدة إلى الدليل الخاطئ — وفي هذه الحالة يفشل WHMCS بصمت. بعد التثبيت، تأكد من ظهور رصيد Domain Name API في شاشة إعدادات الـ registrar. ولحل المشكلات، استخدم قسم Utilities > Logs > Module Log مع تفعيل debug logging. أبقِ debug logging مغلقًا في بيئة الإنتاج.

متطلبات وحدة WHMCS الخاصة بـ Domain Name API:

WHMCS الإصدار 7.8 أو أحدث (يوصى بأحدث إصدار مستقر)

PHP الإصدار 7.4 أو أحدث (يوصى بـ PHP 8.1)

يجب أن تكون إضافة PHP SOAPClient مفعلة على الخادم

حقول عميل مخصصة لرقم الهوية التركي، والرقم الضريبي، ودائرة الضرائب — وهي إلزامية لتسجيل نطاقات .tr

💡 استخدم دائمًا أحدث إصدار مستقر من WHMCS؛ إذ يتم نشر تحديثات الأمان بانتظام. إذا كنت تخدم السوق التركية، فإن حقول رقم الهوية التركي والرقم الضريبي تعد متطلبًا قانونيًا لتسجيل .tr. قم بتعريف هذه الحقول في مرحلة الإعداد قبل أن يكون لديك عملاء فعليون.

يُعد WHMCS أكثر منصات أتمتة الاستضافة استخدامًا على مستوى العالم بفضل نموذج الترخيص الميسور، والنظام البيئي الواسع للتكاملات، والبنية التحتية الناضجة للأتمتة. يقوم تثبيت واحد لـ WHMCS بإدارة سجلات العملاء، والفوترة، وتفعيل الخدمات تلقائيًا، وتتبع المدفوعات، ومسارات التعليق/الإيقاف. كما يقوم نظام الإشعارات عبر البريد الإلكتروني والرسائل القصيرة بإبلاغ العملاء في كل خطوة دون الحاجة إلى تدخل يدوي.

💡 إن الترخيص مدى الحياة الذي كان يُقدَّم حتى عام 2017 جعل قاعدة مستخدمي WHMCS مستقرة للغاية. وبالنسبة للشركات الجديدة التي تقيّم الخيارات في 2025–2026، ينبغي مقارنة التكلفة الشهرية لـ WHMCS مع WiseCP (المنافس في السوق التركية ومنطقة الشرق الأوسط وشمال إفريقيا) وBlesta (دفعة واحدة مع ملكية قوية للبيانات). تدعم Domain Name API المنصات الثلاث جميعها عبر وحداتها الخاصة.

بدائل WHMCS المتوافقة بالكامل مع Domain Name API والتي يجري تطويرها بنشاط:

Blesta — مناسب للمطورين، ترخيص بدفعة واحدة، وقابلية قوية لنقل البيانات

HostBill — مستوى مؤسسي، أكثر من 150 تكاملًا، مثالي للوكلاء ذوي الحجم المرتفع

WiseCP — واجهة حديثة، وينمو بسرعة في تركيا ومنطقة الشرق الأوسط وشمال إفريقيا

ClientExec — مجموعة ميزات أبسط، خيار بداية اقتصادي

HostFact — شائع في هولندا وأوروبا الغربية

أما المنصات القديمة مثل AWBS وWHMAutoPilot وLpanel وModernbill وPerlBill فلم تعد تُطوَّر بنشاط ولا يُنصح بها للتركيبات الجديدة.

💡 يجب أن يعتمد اختيار المنصة على السوق المستهدف. يُعد WHMCS الخيار الأكثر أمانًا للعمليات العالمية. ويُعد WiseCP بديلًا بارزًا بسرعة بين الوكلاء في السوق التركية، كما أنه مدعوم بالكامل عبر وحدة WiseCP الخاصة بـ Domain Name API. ويُنصح بـ HostBill للوكلاء المؤسسيين الذين يحتاجون إلى أكثر من 150 تكاملًا، بينما يناسب Blesta المشغلين الذين يبحثون عن ملكية كاملة للبيانات وتكلفة تُدفع مرة واحدة.

WHMCS هو برنامج مرخّص مدفوع ذو خطط متدرجة بحسب عدد العملاء النشطين: Starter وPlus وBusiness وDirect. تتم الفوترة على أساس شهري. وتتوفر فترة تجريبية مجانية لتقييم المنصة قبل الالتزام.

تقدم Domain Name API باقات تثبيت WHMCS Starter وMega، والتي تأتي مع إعداد القالب وتكوين الوحدة بشكل مكتمل مسبقًا. تقلل هذه الباقات بشكل كبير من الوقت والتكلفة اللازمة لإطلاق مشروع جديد لوكالة بيع نطاقات.

💡 إذا كنت تبدأ للتو، فإن خطة WHMCS Starter تكفي حتى 250 عميلًا نشطًا. وتلغي الباقات الجاهزة من Domain Name API مدة إعداد تتراوح بين يومين إلى ثلاثة أيام كانت تُستهلك عادة في تثبيت القالب وربط الوحدة؛ ويمكنك إطلاق واجهة بيع تحمل علامتك التجارية خلال ساعات قليلة.

نعم. يمكنك الانتقال في أي وقت بين مستويات ترخيص WHMCS وباقات تثبيت WHMCS الخاصة بـ Domain Name API. ويسري التغيير في فترة الفاتورة التالية. كما أن وحدة WHMCS الخاصة بـ Domain Name API متوافقة مع جميع مستويات ترخيص WHMCS، بما في ذلك Starter وPlus وBusiness وDirect.

💡 ابدأ بـ WHMCS Starter. وعندما تتجاوز قاعدة عملائك 250 عميلًا، قم بالترقية إلى Plus أو Business للحصول على تسجيل غير محدود للعملاء والخدمات. وتوفر باقات Starter وMega من Domain Name API بيئة بيع جاهزة لمن لا يرغب في إعداد كل شيء من الصفر.

تدعم وحدة WHMCS الخاصة بـ Domain Name API أكثر من 800 امتداد نطاق، بما في ذلك جميع نطاقات gTLD الرئيسية مثل .com و.net و.org و.info و.biz، بالإضافة إلى .tr و.com.tr و.de و.uk و.us و.cn و.ru و.in و.ge والعديد من نطاقات ccTLD الأخرى. كما يتم دعم تسجيل النطاقات المميزة للجهات التي تقدم تسعيرًا مميزًا.

💡 ينبغي للوكلاء الذين يستهدفون أسواقًا جغرافية محددة تنظيم جداول أسعار TLD الخاصة بهم بحيث تعطى الأولوية للامتدادات المحلية. ويجب على الوكلاء في تركيا إبراز .tr و.com.tr — فهذه الامتدادات تُنشئ إشارات ثقة قوية لدى العملاء المحليين وتزيد معدلات التحويل. ويُعد التموضع المحلي لامتدادات TLD أحد أعلى الأساليب تحقيقًا للعائد في حملات SEO الموجهة جغرافيًا.

بشكل افتراضي، يتحقق WHMCS من تواريخ انتهاء صلاحية النطاقات عبر cron job تلقائي يعمل كل خمس دقائق. وعندما يقترب تاريخ انتهاء نطاق ما، يقوم WHMCS تلقائيًا بإنشاء فاتورة تجديد للعميل، ويرسل إشعارات انتهاء الصلاحية على فترات قابلة للتخصيص (عادة قبل 60 و30 و14 و7 أيام)، وينفذ التجديد تلقائيًا إذا كان هناك رصيد كافٍ في حساب العميل أو وسيلة دفع صالحة.

ولكي تعمل هذه العملية بشكل صحيح، يجب أن يكون خيار Domain Sync مفعلًا ضمن إعدادات النظام > الإعدادات العامة > Domains، بحيث يحصل WHMCS دائمًا على تواريخ انتهاء الصلاحية المحدثة من Domain Name API.

💡 إن تسلسل 4 رسائل بريد إلكتروني على 60/30/14/7 يومًا يقلل معدل فقدان النطاقات بنسبة تصل إلى 60% مقارنةً بتذكير واحد فقط. كما ينبغي تفعيل خيار Sync Next Due Date ضمن إعدادات الأتمتة — إذ إن عدم تطابق التواريخ بين WHMCS وجهة التسجيل يعد من أكثر أسباب فقدان النطاقات غير المتوقع شيوعًا.

يمكن إدخال أسعار النطاقات يدويًا لكل TLD أو استيرادها تلقائيًا عبر أداة Registrar TLD Sync. ولأجل المزامنة التلقائية: انتقل إلى Utilities > Registrar TLD Sync، واختر DomainNameApi، ثم انتظر حتى تكتمل المقارنة. تعرض شاشة النتائج هوامش الربح/الخسارة لكل امتداد وتتيح لك استيراد الأسعار بشكل جماعي.

يمكنك أيضًا تعيين Domain Name API كمزوّد Lookup Provider (إعدادات النظام > أسعار النطاقات > Lookup Provider > تغيير > DomainNameApi). وبهذه الطريقة يتم إجراء استعلامات التوفر في الوقت الفعلي عبر بنية Domain Name API بدلًا من خوادم WHOIS العامة.

💡 تُعد المزامنة التلقائية للأسعار واحدة من أقل ميزات WHMCS استخدامًا. إن تشغيل TLD Sync شهريًا يضمن بقاء أسعار التجزئة لديك فوق التكلفة حتى بعد تغييرات أسعار المورّد. وتساعد قاعدة هامش ثابت (مثل التكلفة + 25%) على حماية الربحية عبر أكثر من 800 امتداد دون الحاجة إلى مراجعة يدوية.

يوفر WHMCS نظام سجلات مدمجًا للوحدات لتشخيص مشكلات التكامل. انتقل إلى Utilities > Logs > Module Log. وإذا كان زر Enable Debug Logging ظاهرًا، فانقر عليه لتفعيل التسجيل. وبعد التفعيل، يتم تسجيل جميع الطلبات والردود بين WHMCS وDomain Name API. ويمكنك النقر على تاريخ أي سجل لعرض تفاصيل الطلب والرد والرد المُفلتر بالكامل.

المشكلات الشائعة:

تحميل ملفات الوحدة إلى دليل خاطئ — لا يتعرّف WHMCS على الوحدة ولا يعرض خطأً واضحًا

بيانات API غير صحيحة — لا يظهر الرصيد بعد الحفظ

تعطيل Domain Sync — تصبح تواريخ انتهاء الصلاحية قديمة وتفشل عمليات التجديد بصمت

💡 قبل التواصل مع فريق الدعم، احصل على سجل Module Log الخاص بالعملية الفاشلة. يعرض قسم الرد المُفلتر الخطأ الذي أعادته Domain Name API بشكل دقيق؛ وفي معظم الحالات يتضح سبب المشكلة فورًا. إن توفر هذا السجل لديك يختصر وقت الحل بشكل كبير. ولتجنب أي تأثير على الأداء، أبقِ debug logging مغلقًا في بيئة الإنتاج.

تتم معالجة عمليات نقل النطاقات تلقائيًا عبر وحدة الـ registrar. وعندما يبدأ أحد العملاء نقلًا واردًا، يقوم WHMCS بإرسال طلب النقل إلى Domain Name API باستخدام رمز تفويض EPP الذي يقدمه العميل. ويمكن عرض حالة النقل وتواريخ البدء/الانتهاء الفعلية في الوقت الفعلي من لوحة الإدارة. كما يمكن للمسؤولين إنشاء طلب إلغاء نقل مباشرةً من لوحة إدارة النطاق.

💡 تحدث حالات فشل النقل غالبًا بسبب انتهاء صلاحية رموز EPP، أو وجود أقفال نقل لدى جهة التسجيل الحالية، أو فترة ICANN lock البالغة 60 يومًا بعد تسجيل حديث. انتبه بشكل خاص عند نقل نطاقات .tr: يجب أن تتطابق معلومات رقم الهوية التركي والرقم الضريبي في حساب العميل المستلم مع السجلات الموجودة لدى جهة التسجيل؛ لأن حالات عدم التطابق قد تؤدي إلى رفض النقل بصمت، وهو ما يصعب تشخيصه دون فحص السجلات.