بيعه استضافة Zinn® من خلال WHMCS

يقوم وحدة Zinn Digital® بتحويل أزرار WHMCS الخاصة إلى إجراءات حقيقية على منصتنا. يقوم الطلب بتوفير استضافة عميلك. تؤدي أتمتة الفواتير المتأخرة في WHMCS إلى تعليقها. يؤدي وضع علامة على الفوعة بأنها مدفوعة إلى تحريرها. يؤدي إلغاء الاشتراك إلى جدولة الحذف. ويحصل عميلك على زر تسجيل الدخول إلى لوحة الاستضافة في منطقة العملاء الخاصة بهم والذي يقوم بتسجيل دخولهم مباشرة.

إنها مجانية، مرخصة بموجب GPL-2.0-or-later، وليس لها مسار مميز في منصتنا: كل استدعاء تقوم به هو نقطة نهاية موثقة يمكنك إجراؤها بنفسك باستخدام مفتاح API الخاص بك.

قبل أن تبدأ

أنت بحاجة إلى أمرين، والثاني يوقع الناس في مشكلة.

1. حساب موزع Zinn® مع برنامج نشط. قم بالتسجيل على zinndigital.com وقم بتفعيل إعادة البيع.
2. خطة موزع مع مخصصات للمواقع. المواقع التي يطلبها عملاؤك تحتسب ضمن خطتك الخاصة بك، لذا فأنت بحاجة إلى خطة تحتوي على مساحة كافية.

⚠️ لا يمكن لاختبار الاتصال إخبارك ما إذا كان الطلب سينجح. إنه يقرأ برنامجك ولا يوفر أي شيء، لذلك فهو يبلغ عن حساب active سليم لا يمكنه بيع أي شيء حتى الآن. إذا فشل طلبك الأول برسالة "هذه المنظمة ليس لديها خطة استضافة، لذا لا يمكنها استضافة موقع حتى الآن", فهذا ما حدث تماماً — قم بشراء أو تمديد خطة الموزع الخاصة بك وأعد تقديم الطلب مرة أخرى. لا يوجد خطأ في الوحدة.

1. أنشئ مفتاح API

في لوحة تحكم Zinn® الخاصة بك، افتح مفاتيح API وأنشئ مفتاحاً بالأذونات الأحد عشر التالية بالضبط:

| الإذن | لماذا هو مطلوب | | -------------------- | ----------------------------------------------------------- | | org.create | افتح حساب عميلك Zinn® عند طلبه الأول. | | org.read | قراءة حسابات عملائك. | | sites.create | توفير الموقع. | | sites.view | قراءة الخدمة واستخدامها. | | sites.delete | إنهاء الخدمة. | | reseller.view | سرد ما بعته، وقراءة مساحة التخزين ونطاق التردد. | | reseller.provision | تعليق، تحرير، تسجيل دخول عميل، تعيين خطته وتغيير باقته. | | billing.view | قراءة تكلفة الترقية قبل تنفيذها. | | sites.manage | مسح ذاكرة التخزين المؤقت وأخذ نسخة احتياطية من الأزرار. | | sites.panel_access | تغيير كلمة مرور مسؤول WordPress. | | hosting.php.manage | تبديل إصدار PHP عند الترقية أو التخفيض. |

⛔ لا تمنح الإذن reseller.manage. يجب أن يكون المفتاح الملصق في لوحة الفوترة قادراً على تعليق عميل لعدم الدفع وتسجيل دخوله. يجب ألا يكون قادراً على قراءة وإعادة كتابة بيانات اعتماد بوابة الدفع الخاصة بك. تم إيجاد الإذن reseller.provision لكي لا تضطر إلى منح الإذن الأكبر. ⛔ الإذن org.create ليس اختيارياً. بدونه، يمكن للوحدة قراءة حساباتك ولكن لا يمكنها فتح حساب، لذا ينتهِ اختبار الاتصال بنجاح ويستجيب الطلب الأول بـ 403. ⛔⛔ منح الجدول بأكمله، ولاحظ أن اختبار الاتصال لا يمكنه إخبارك عما إذا لم تقم بذلك. إنه يقرأ برنامج الموزع الخاص بك ولا يوفر شيئاً، لذا فهو يظهر باللون الأخضر للمفتاح الذي يفتقد أيًا من هذه الأذونات. ما تحصل عليه بدلاً من ذلك هو خطأ 403 في العملية الوحيدة التي يغطيها الإذن المفقود، بعد أشهر، من أحد العملاء.

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

1. قم بتنزيل الوحدة وقم بفك ضغطها.
2. قم بتحميل الدليل zinn إلى تثبيت WHMCS الخاص بك بحيث يصل ملف الوحدة إلى modules/servers/zinn/zinn.php.

⛔ يجب أن يسمى الدليل zinn. يستمد WHMCS أسماء وظائف وحدة التوفير من اسم دليلها، لذا فإن إعادة تسميتها إلى zinn-whmcs أو zinndigital ينتج عنه وحدة يقوم WHMCS بسردها، ويتيح لك تحديدها، ثم لا يستدعها أبداً — دون أي خطأ في أي مكان. يتم بالفعل فك ضغط ملف الـ zip بالاسم الصحيح؛ فقط لا تقم بإعادة تسميته.

3. إضافة الخادم

في WHMCS: التكوين ← إعدادات النظام ← الخوادم ← إضافة خادم جديد.

• الاسم: أي شيء، على سبيل المثال Zinn Digital®
• اسم المضيف: api.zinndigital.com
• النوع: Zinn Digital®
• كلمة المرور: مفتاح API الخاص بك من الخطوة 1

⛔ يوضع المفتاح في حقل كلمة المرور، والذي يقوم WHMCS بتخزينه مشفراً. لا تضعه في خيار تكوين المنتج — فهذه تكون نصوصاً عادية في قاعدة البيانات ومرئية لكل مسؤول، ويمكن لبيانات الاعتماد هذه إنشاء وتدمير استضافة عملائك.

اضغط على اختبار الاتصال. إنه يقوم بعمل استدعاء حقيقي ويبلغ بما قالته منصتنا، بدلاً من مجرد التحقق من أن الحقول مملوءة.

4. أنشئ المنتج

التكوين ← إعدادات النظام ← المنتجات/الخدمات، ثم قم بتعيين إعدادات الوحدة النمطية إلى الخادم الذي أضفته للتو. الحقول هي:

| الحقل | مطلوب | ما هو | | ---------------- | -------- | -------------------------------------------------------------------------- | | خط المنتج | نعم | خط Zinn® الذي تبيعه — mainstream (WordPress مدار)، footprint_free، wordpress، linux، cloud، agency، app_hosting، ai_hosting، lms_hosting، managed_database، vector_hosting، zinn_compute، fleet_linux، fleet_enterprise، mail أو reseller. | | الحزمة التقنية | نعم | ما يتم بناؤه: wordpress (افتراضي)، woocommerce، php، static، node، one_click، headless_cms، nextcloud أو owncloud. | | التطبيق | لا | فقط للحزمتين one_click و headless_cms — التطبيق المراد تثبيته. يُرفض تحديد تطبيق على أي حزمة تقنية أخرى، لأن تلك الحزمة تقرر بالفعل ما يتم تثبيته. | | إصدار PHP | لا | على سبيل المثال 8.3. اتركه فارغاً للاستخدام الافتراضي للخط. يُرفض الإصدار الذي لا يقدمه الخط مع قائمة بالإصدارات التي يقدمها. | | رمز الخطة | نعم | خطة Zinn® التي يبيعها هذا المنتج. تعرض GET /v1/reseller/prices خططك. يتم رفض الطلب بدونها — انظر التحذير أدناه. | | فترة الفوترة | لا | monthly (افتراضي) أو annual — الفترة التي يتم تحصيل قيمة خط الجملة الخاص بك لهذا العميل بناءً عليها. ما تتقاضاه من عميلك الخاص يتم تعيينه على منتج WHMCS ولا يتأثر. |

⛔⛔ رمز الخطة مطلوب، ويتم رفض الطلب الذي لا يحتوي على رمز تعمداً. حتى 2026-09-01 كان الحقل ديكورياً ولم يقرأه أي شيء، لذلك طلبت الوحدة استضافة لا تحمل أي خطة على الإطلاق — وكل ما ترتب على ذلك مر بصمت. يتم بناء بيان الجملة الخاص بك من اشتراكات عملائك النشطة، لذلك لم تكن هناك أي خانة للخدمة ولم يتم فوترتك بأي شيء طالما استمرت في العمل؛ ولم يرث عميلك أي مخصصات، لذلك لم يتم تطبيق أي حصة قرص أو ملفات على موقعه؛ ولم يكن لدى تغيير الباقة ما يتم تغييره، لذا تعذّر تنفيذ الترقية التي بعتها. تم توفير الموقع وخدمته بشكل مثالي طوال الوقت.

ترفض الوحدة الطلب بدلاً من ذلك الآن، لأنه لا توجد خطة آمنة لتخمينها: سيؤدي التخمين إلى توفير الاستضافة على خطة لم تقترحتها وقد لا تكون قد سعّرتها، و — على عكس الرفض، الذي تقرأه فوراً — فلن يظهر إلا عند وصول كشف الحساب، إن ظهر من الأساس.

قم بتعيين الإعداد التلقائي أيهما تفضل — الوحدة متيدempotent على معرف خدمة WHMCS، لذا فإن التوفير المعاد محاولته يُرجع نفس الموقع بدلاً من مطالبتك بدفع فاتورة مقابل موقع ثاني.

ما يفعله كل إجراء من إجراءات WHMCS

| إجراء WHMCS | ما يحدث في جانبنا | | --------------------------- | ---------------------------------------------------------------------------------------- | | إنشاء | ينشئ حساب عميل Zinn® (أو يعيد استخدام الحساب الذي لديهم بالفعل) ويوفر موقعهم. | | تعليق | يضع الموقع في حالة تعليق لعدم الدفع. يتم الاحتفاظ بالمحتوى؛ ولا يتم حذف أي شيء. | | إلغاء التعليق | يحرر التعليق الخاص بك. | | إنهاء | يجدول حذف الموقع، مع فترة سماح. يظهر التاريخ في منطقة العملاء. | | تحديث الاستخدام | يحيّز القرص ونطاق التردد لكل خدمة، مرة واحدة يومياً. | | تسجيل الدخول إلى لوحة الاستضافة | يفتح رابط تسجّل دخول لمرة واحدة ومباشرة إلى لوحة عميلك. | | تغيير الباقة | ترقية أو تخفيض الخدمة. ينقل الباقة، وإصدار PHP إذا كان المنتج الجديد يسمي إصداراً. | | تغيير كلمة المرور | يحدد كلمة مرور مسؤول WordPress. لا يظهر المربع على الحزم التقنية التي ليس لها مثل هذا الحساب. | | تجديد | يؤكد أن الخدمة لا تزال موجودة. استضافة Zinn® مستمرة، لذلك لا توجد فترة زمنية بعيدة لتمديدها. | | مزامنة الاستخدام / مسح ذاكرة التخزين المؤقت / أخذ نسخة احتياطية | أزرار على صفحة خدمة المسؤول. يحصل عميلك على "مسح ذاكرة التخزين المؤقت" و"أخذ نسخة احتياطية" في منطقة العملاء الخاصة بهم. | | علامة تبويب الخدمة | الحالة، والخطة، والقرص، ونطاق التردد، وأي حذف مجدول، ومن الذي فرض التعليق. | | استيراد | يقرأ ListAccounts كل صفحة، بحيث لا يمكن للاستيراد التوقف صمتًا عند الصفحة الأولى. |

الترقيات: من يحاسب من

لا تتم فوترة عميلك أبداً بواسطة Zinn®، لا في طلب ولا في ترقية. أنت تتقاضى منهم عبر WHMCS؛ ونحن نفوتر لك، على بيان الجملة الخاص بك. لذا فإن "تغيير الباقة" ينقل استحقاقات عميلك والسطر في بيانك التالي، ولا يلمس أي بطاقة — فقد أخذ WHMCS بالفعل أموال عميلك وحسب نسبته الخاصة.

الخدمة الثانية للعميل. على نفس الخطة، تعتبر موقعاً آخر ضمن مخصصات المواقع الخاصة بتلك الخطة، ولا يتم منح أي شيء إضافي. على خطة مختلفة، يتم رفضها: استبدال الخطة الحية سيترك إحدى الخدمتين غير مفوترة. إما أن تبيع كليهما على نفس الخطة، أو تقوم بإعداد العميل كحساب عميل منفصل في WHMCS.

لا يوجد "تغيير كلمة المرور" إلا لـ WordPress. استضافة Zinn® ليس لها "كلمة مرور خدمة" واحدة — يصل عميلك إلى لوحته باستخدام زر تسجيل الدخول — وموقع php أو static ليس له حساب تطبيق لتغييره. يقوم WHMCS بإخفاء المربع بالكامل بدلاً من إظهار مربع لا يمكن أن يعمل.

ثلاث إجابات يجب ألا تختزلها إلى اثنتين

• يمكن أن يرد إلغاء التعليق بالرفض. هذا يعني أن الموقع تم تعليقه بواسطة فريق إساءة الاستخدام لدينا، وليس بواسطة أنت، ولا يجوز لأي لوحة فوترة تحريره. الرسالة تقول ذلك؛ اعرضها على مسؤولك بدلاً من إعادة المحاولة.
• الإنهاء يجدول الحذف، ولا ينفذه. يعود التاريخ كـ pending_deletion_at وتظهره منطقة العملاء. إخبار العميل أن بياناته قد ذهبت بالفعل بينما لم تحدث هو أسوأ من عدم إخباره بشيء.
• يمكن أن يكون القرص ونطاق التردد مجهولين، والمجهول ليس صفراً. عندما تعذر علينا أخذ قراءة، تترك الوحدة الرقم كما هو بدلاً من كتابة 0 — وإلا فإن WHMCS سيعرض لعميلك شريط استخدام فارغاً مطمئناً لموقع ليس لدينا أي قراءة عنه.

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

ينجح اختبار الاتصال وفشل الطلب الأول بسبب خطأ في الإذن. مفتاح API يفتقد الإذن org.create. يجب على الوحدة فتح حساب العميل قبل أن تتمكن من إنشاء موقعه.

يفشل الطلب مشيراً إلى أن المنظمة ليس لديها خطة استضافة. خطة الموزع الخاصة بك ليس لها مخصصات مواقع متبقية، أو أنك لا تملك واحدة حتى الآن. انظر قسم قبل أن تبدأ أعلاه.

يفشل الطلب مع ذكر حزمة تقنية. حقل الحزمة التقنية على المنتج فارغ أو يسمي شيئاً لا نبنيه. قم بتعيينه إلى wordpress ما لم تكن تبيع شيئاً آخر.

عمليات الإلغاء تفشل. تأكد من أنك على إصدار الوحدة 1.0.0 أو أحدث. الإصدارات الأقدم لم ترسل تأكيد الحذف وتم رفض كل عملية إنهاء، مما ترك الخدمة تعمل وتفوتر.

رفض يسمى حقلاً. تسمي أخطاء التحقق الخاصة بنا الحقل والسبب بين قوسين بعد الرسالة، على سبيل المثال (php_version: 7.2 is not offered on this product line). هذا هو النصف القابل للتنفيذ — الجملة الموجودة أمامه عامة عن قصد.

تحقق من تنزيلك

يتم تقديم كل أرشيف عبر TLS من اسم المضيف الخاص بنا ولا يتم إعادة توجيهه أطلاقاً إلى مضيف طرف ثالث. يتم طباعة فحص SHA-256 بجوار رابط التنزيل على صفحة التنزيلات. قارنه بعد التنزيل:

• macOS أو Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
• Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

لست على WHMCS؟

توجد وحدة HostBill وعميل PHP ملف واحد لأي شيء آخر، وكلاهما مجاني وكلاهما على نفس صفحة التنزيلات. كل نقطة نهاية تستخدمها الوحدات موجودة في مرجع API.