Zinn Digital® मोड्युलले WHMCS का आफ्नै बटनहरूलाई हाम्रो प्लेटफर्ममा वास्तविक कार्यहरूमा रूपान्तरण गर्दछ। एउटा अर्डरले तपाईंको ग्राहकको होस्टिङ प्रोभिजन गर्दछ। WHMCS को ओभरड्यू-इनभ्वाइस स्वचालनले यसलाई निलम्बन गर्दछ। इनभ्वाइसलाई भुक्तानी गरिएको भनी चिन्ह लगाउनाले यसलाई खुला गर्दछ। रद्द गर्नाले मेटाउने कार्य निर्धारित गर्दछ। र तपाईंको ग्राहकले आफ्नो क्लाइन्ट एरियामा Log in to hosting panel बटन प्राप्त गर्नुहुन्छ जसले उहाँहरूलाई सिधै साइन इन गराउँछ।
यो निःशुल्क छ, GPL-2.0-or-later इजाजतपत्र प्राप्त छ, र हाम्रो प्लेटफर्ममा यसको कुनै विशेषाधिकार प्राप्त मार्ग छैन: यसले गर्ने प्रत्येक कल एक कागजात गरिएको एन्डपोइन्ट हो जुन तपाईं आफैंले आफ्नै API कुञ्जी मार्फत गर्न सक्नुहुन्छ।
तपाईंले सुरु गर्नु अघि
तपाईंलाई दुईवटा कुराहरू चाहिन्छ, र दोस्रोले मानिसहरूलाई अन्योलमा पार्छ।
- सक्रिय कार्यक्रम भएको Zinn® रिसेलर खाता। zinndigital.com मा साइन अप गर्नुहोस् र रिसेलिङ सक्रिय गर्नुहोस्।
- साइट सीमा (साइट एलोवेन्स) भएको रिसेलर योजना। तपाईंका ग्राहकहरूले अर्डर गर्ने साइटहरू तपाईंको योजनाबाट घट्नेछन्, त्यसैले तपाईंलाई थप स्थान भएको योजना चाहिन्छ।
⚠️ Test Connection ले अर्डर सफल हुनेछ कि छैन भनी बताउन सक्दैन। यसले तपाईंको कार्यक्रम पढ्छ र केही पनि प्रोभिजन गर्दैन, त्यसैले यसले स्वस्थ active खाता देखाउँछ जसले अझै केही बेच्न सक्दैन। यदि तपाईंको पहिलो अर्डर "This organization has no hosting plan, so it cannot host a site yet" भन्दै असफल भयो भने, त्यही भएको हो — आफ्नो रिसेलर योजना किन्नुहोस् वा नवीकरण गर्नुहोस् र पुन: अर्डर गर्नुहोस्। मोड्युलमा कुनै समस्या छैन।
1. API कुञ्जी सिर्जना गर्नुहोस्
तपाईंको Zinn® ड्यासबोर्डमा, API keys खोल्नुहोस् र ठ्याक्कै यी एघारवटा अनुमतिहरू सहित एउटा कुञ्जी सिर्जना गर्नुहोस्:
| अनुमति | यो किन आवश्यक छ |
|---|
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 ऐच्छिक होइन। यस बिना मोड्युलले तपाईंका खाताहरू पढ्न सक्छ तर खाता खोल्न सक्दैन, त्यसैले Test Connection सफल हुन्छ र पहिलो अर्डरले 403 जवाफ दिन्छ। ⛔⛔ तालिकाका सबै अनुमतिहरू दिनुहोस्, र याद गर्नुहोस् कि तपाईंले नदिएको खण्डमा Test Connection ले तपाईंलाई सचेत गराउन सक्दैन। यसले तपाईंको रिसेलर कार्यक्रम पढ्छ र केही पनि प्रोभिजन गर्दैन, त्यसैले यी मध्ये कुनै अनुमति नहुँदा पनि यो हरियो नै देखिन्छ। यसको सट्टा तपाईंले हराएको अनुमति अन्तर्गत पर्ने कार्य गर्दा महिनांै पछि ग्राहकबाट 403 त्रुटि प्राप्त गर्नुहुनेछ।
2. मोड्युल स्थापना गर्नुहोस्
- मोड्युल डाउनलोड गर्नुहोस् र यसलाई अनजिप गर्नुहोस्।
zinn डाइरेक्टरीलाई आफ्नो WHMCS स्थापनामा अपलोड गर्नुहोस् ताकि मोड्युल फाइल modules/servers/zinn/zinn.php मा पुगोस्।
⛔ डाइरेक्टरीको नाम zinn नै हुनुपर्छ। WHMCS ले प्रोभिजनिङ मोड्युलका प्रकार्य नामहरू यसको डाइरेक्टरीको नामबाट निकाल्छ, त्यसैले यसको नाम zinn-whmcs वा zinndigital मा परिवर्तन गर्दा WHMCS ले मोड्युललाई सूचीकृत गर्छ, तपाईंलाई चयन गर्न दिन्छ, तर कहिल्यै कल गर्दैन — कतै कुनै त्रुटि नदेखाईकन। जिप फाइल पहिले नै सही नाममा अनप्याक हुन्छ; केवल यसको नाम परिवर्तन नगर्नुहोस्।
3. सर्भर थप्नुहोस्
WHMCS मा: Configuration → System Settings → Servers → Add New Server।
- Name: जे पनि, जस्तै
Zinn Digital®
- Hostname:
api.zinndigital.com
- Type:
Zinn Digital®
- Password: चरण १ बाट तपाईंको API कुञ्जी
⛔ कुञ्जी Password फिल्डमा जान्छ, जसलाई WHMCS ले इन्क्रिप्ट गरेर भण्डारण गर्दछ। यसलाई उत्पादन कन्फिगरेसन विकल्पमा नराख्नुहोस् — ती डाटाबेसमा सादा पाठको रूपमा रहन्छन् र प्रत्येक व्यवस्थापकलाई देखिने हुन्छन्, र यो प्रमाणले तपाईंका ग्राहकहरूको होस्टिङ सिर्जना तथा नष्ट गर्न सक्छ।
Test Connection थिच्नुहोस्। यसले फिल्डहरू भरिएका छन् कि छैनन् भनी जाँच गर्नुको सट्टा, वास्तविक कल गर्दछ र हाम्रो प्लेटफर्मले के जवाफ दियो सो रिपोर्ट गर्दछ।
4. उत्पादन सिर्जना गर्नुहोस्
Configuration → System Settings → Products/Services मा जानुहोस्, त्यसपछि Module Settings लाई तपाईंले भर्खरै थप्नुभएको सर्भरमा सेट गर्नुहोस्। फिल्डहरू यस प्रकार छन्:
| फिल्ड | आवश्यक | यो के हो |
|---|
| Product line | हो | तपाईंले बेच्दै गर्नुभएको 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। |
| Stack | हो | के निर्माण हुन्छ: wordpress (पूर्वनिर्धारित), woocommerce, php, static, node, one_click, headless_cms, nextcloud वा owncloud। |
| Application | होइन | केवल one_click र headless_cms स्ट्याकहरूका लागि — कुन अनुप्रयोग स्थापना गर्ने। अन्य कुनै पनि स्ट्याकमा नाम दिँदा अस्वीकार गरिन्छ, किनकि त्यो स्ट्याकले के स्थापना गर्ने भन्ने कुरा पहिले नै निर्धारण गरिसकेको हुन्छ। |
| PHP version | होइन | जस्तै 8.3। लाइनको पूर्वनिर्धारितका लागि खाली छोड्नुहोस्। लाइनले प्रस्ताव नगरेको संस्करण दिइएमा त्यसले प्रस्ताव गर्ने संस्करणहरूको सूची सहित अस्वीकार गरिन्छ। |
| Plan code | हो | यो उत्पादनले बेच्ने Zinn® योजना। GET /v1/reseller/prices ले तपाईंको योजना सूचीकृत गर्दछ। यो बिनाको अर्डर अस्वीकार गरिन्छ — तल दिइएको चेतावनी हेर्नुहोस्। |
| Billing interval | होइन | monthly (पूर्वनिर्धारित) वा annual — यस ग्राहकका लागि तपाईंको थोक लाइन जारी गरिने अन्तराल। तपाईंले आफ्ना ग्राहकसँग के शुल्क लिनुहुन्छ भन्ने कुरा WHMCS उत्पादनमा सेट गरिन्छ र यो अप्रभावित रहन्छ। |
⛔⛔ Plan code अनिवार्य छ, र यो बिनाको अर्डर जानीजानी अस्वीकार गरिन्छ। २०२६-०९-०१ सम्म यो फिल्ड सजावटी मात्र थियो र कसैले पनि यसलाई पढ्दैनथ्यो, त्यसैले मोड्युलले कुनै पनि योजना नभएको होस्टिङ अर्डर गर्दथ्यो — र त्यसको प्रत्येक परिणाम मौन हुन्थ्यो। तपाईंको थोक विवरण तपाईंका ग्राहकहरूको सक्रिय सदस्यताहरूबाट तयार पारिन्छ, त्यसैले सेवाका लागि कुनै लाइन हुँदैनथ्यो र यो चलिरहेसम्म तपाईंलाई कुनै इनभ्वाइस जारी गरिँदैनथ्यो; तपाईंको ग्राहकले कुनै सीमा (एलोवेन्स) प्राप्त गर्नुहुन्नथ्यो, त्यसैले उहाँहरूको साइटमा कुनै डिस्क वा फाइल कोटा लागू हुँदैनथ्यो; र Change Package सँग परिवर्तन गर्नका लागि केही हुँदैनथ्यो, त्यसैले तपाईंले बेच्नुभएको अपग्रेड लागू हुन सक्दैनथ्यो। यद्यपि साइट प्रोभिजन भयो र सुरुदेखि अन्त्यसम्म पूर्ण रूपमा सञ्चालन भयो।
मोड्युलले अब यसको सट्टा अर्डर अस्वीकार गर्दछ, किनकि यसले अनुमान गर्नका लागि कुनै सुरक्षित योजना छैन: अनुमान गर्दा तपाईंले चयन नगर्नुभएको र मूल्य निर्धारण नगरेको योजनामा होस्टिङ प्रोभिजन हुन सक्दछ, र — तत्कालै देखिने अस्वीकृतिको विपरीत — यो विवरण प्राप्त भएपछि मात्र देखिनेछ, यदि देखियो भने।
Auto Setup लाई आफूलाई मनपर्ने विकल्पमा सेट गर्नुहोस् — मोड्युल WHMCS सेवा आईडीमा आइडम्पोटेन्ट हुन्छ, त्यसैले पुन: प्रयास गरिएको प्रोभिजनले तपाईंलाई दोस्रो पटक बिलिङ गर्नुको सट्टा उही साइट फर्काउँछ।
प्रत्येक WHMCS कार्यले के गर्छ
| WHMCS कार्य | हाम्रो तर्फ के हुन्छ |
|---|
| Create | ग्राहकको Zinn® खाता सिर्जना गर्दछ (वा उहाँहरूसँग पहिले नै भएको खाता पुन: प्रयोग गर्दछ) र उहाँहरूको साइट प्रोभिजन गर्दछ। |
| Suspend | गैर-भुक्तानीका कारण साइटलाई रोक (होल्ड) मा राख्छ। सामग्री सुरक्षित राखिन्छ; केही पनि मेटाइँदैन। |
| Unsuspend | तपाईंको रोक हटाउँछ। |
| Terminate | निश्चित सहुलियत अवधिसहित साइट मेटाउने तालिका निर्धारण गर्दछ। मिति क्लाइन्ट एरियामा देखिन्छ। |
| Usage update | दिनमा एक पटक, प्रत्येक सेवामा डिस्क र ब्यान्डविथ ताजा गर्दछ। |
| Log in to hosting panel | तपाईंको ग्राहकको प्यानलमा सिधै जाने एक पटक मात्र प्रयोग गर्न मिल्ने साइन-इन लिङ्क खोल्छ। |
| Change Package | सेवा अपग्रेड वा डाउनग्रेड गर्दछ। प्याकेज सार्छ, र नयाँ उत्पादनले नाम तोकेको भए PHP संस्करण पनि बदल्छ। |
| Change Password | WordPress प्रशासकको पासवर्ड सेट गर्दछ। यस्तो खाता नभएका स्ट्याकहरूमा यो बाकस देखिँदैन। |
| Renew | सेवा अझै अवस्थित छ भनी पुष्टि गर्दछ। Zinn® होस्टिङ निरन्तर हुन्छ, त्यसैले थप गर्नुपर्ने कुनै रिमोट अवधि हुँदैन। |
| Sync Usage / Purge Cache / Take Backup | व्यवस्थापक सेवा पृष्ठका बटनहरू। तपाईंको ग्राहकले आफ्नो क्लाइन्ट एरियामा Purge Cache र Take Backup प्राप्त गर्नुहुन्छ। |
| Service tab | स्थिति, योजना, डिस्क, ब्यान्डविथ, कुनै निर्धारित मेटाउने कार्य, र निलम्बन कसले गर्यो भन्ने विवरण। |
| Import | ListAccounts ले प्रत्येक पृष्ठ पढ्छ, त्यसैले आयात कार्य पहिलो पृष्ठमै मौन रूपमा रोकिन सक्दैन। |
अपग्रेडहरू: कसले कोसँग शुल्क लिन्छ
Zinn® द्वारा तपाईंको ग्राहकलाई अर्डर वा अपग्रेडमा कहिल्यै इनभ्वाइस पठाइँदैन। तपाईंले उहाँहरूलाई WHMCS मार्फत बिल गर्नुहुन्छ; हामी तपाईंलाई तपाईंको थोक विवरणमा बिल गर्छौं। त्यसैले Change Package ले तपाईंको ग्राहकको अधिकार र तपाईंको अर्को विवरणको लाइनलाई सार्छ, र कुनै कार्डलाई छुँदैन — WHMCS ले पहिले नै तपाईंको ग्राहकको रकम लिइसकेको हुन्छ र आफ्नै समानुपातिक गणना गरिसकेको हुन्छ।
ग्राहकको दोस्रो सेवा। एउटै योजनामा यो त्यस योजनाको आफ्नै साइट सीमा अन्तर्गत अर्को साइट हुन्छ, र थप केही पनि प्रदान गरिँदैन। फरक योजनामा यसलाई अस्वीकार गरिन्छ: सक्रिय योजना प्रतिस्थापन गर्दा दुई मध्ये एउटा सेवा बिलिङ हुनबाट छुट्नेछ। या त दुवैलाई एउटै योजनामा बेच्नुहोस्, वा ग्राहकलाई WHMCS मा छुट्टै ग्राहक रेकर्डको रूपमा सेट गर्नुहोस्।
Change Password केवल WordPress का लागि मात्र उपलब्ध छ। Zinn® होस्टिङमा कुनै एकल "सेवा पासवर्ड" हुँदैन — तपाईंको ग्राहक साइन-इन बटन मार्फत आफ्नो प्यानलमा पुग्नुहुन्छ — र php वा static साइटमा परिवर्तन गर्नका लागि कुनै अनुप्रयोग खाता हुँदैन। काम नगर्ने बाकस देखाउनुको सट्टा WHMCS ले यसलाई पूर्ण रूपमा लुकाउँछ।
तीनवटा जवाफ जसलाई तपाईंले दुईवटामा सीमित गर्नु हुँदैन
- Unsuspend ले अस्वीकृतिको जवाफ दिन सक्छ। यसको अर्थ साइट तपाईंले नभई हाम्रो दुरुपयोग (एब्यूज) टोलीले निलम्बन गरेको हो, र कुनै पनि बिलिङ प्यानलले यसलाई खुला गर्न पाउँदैन। सन्देशले त्यही भन्छ; पुन: प्रयास गर्नुको सट्टा यसलाई आफ्नो व्यवस्थापकलाई देखाउनुहोस्।
- Terminate ले मेटाउने कार्य निर्धारित गर्दछ, यो तुरुन्तै मेटाउँदैन। मिति
pending_deletion_at को रूपमा फिर्ता आउँछ र क्लाइन्ट एरियाले यसलाई देखाउँछ। ग्राहकलाई उहाँहरूको डेटा मेटिइसकेको छैन तर मेटिसक्यो भन्नु केही नभन्नु भन्दा खराब हो।
- डिस्क र ब्यान्डविथ अज्ञात हुन सक्छन्, र अज्ञात भनेको शून्य होइन। जब हामीले विवरण लिन सकेनौं भने मोड्युलले
0 लेख्नुको सट्टा तथ्याङ्कलाई त्यत्तिकै छोडिदिन्छ — अन्यथा WHMCS ले तपाईंको ग्राहकलाई हामीसँग कुनै विवरण नभएको साइटको लागि भ्रमपूर्ण रूपमा खाली प्रयोग पट्टी (युसेज बार) देखाउनेछ।
समस्या निवारण
Test Connection सफल हुन्छ तर पहिलो अर्डर अनुमति त्रुटिसहित असफल हुन्छ। API कुञ्जीमा org.create छुटेको छ। मोड्युलले ग्राहकको साइट सिर्जना गर्न सक्नु अघि उहाँहरूको खाता खोल्नु पर्छ।
संस्थासँग कुनै होस्टिङ योजना छैन भन्दै अर्डर असफल हुन्छ। तपाईंको रिसेलर योजनामा कुनै साइट सीमा बाँकी छैन, वा तपाईंसँग अझै कुनै योजना छैन। माथिको तपाईंले सुरु गर्नु अघि हेर्नुहोस्।
स्ट्याक उल्लेख गर्दै अर्डर असफल हुन्छ। उत्पादनमा रहेको Stack फिल्ड खाली छ वा हामीले निर्माण नगर्ने कुराको नाम दिइएको छ। तपाईंले अरू केही बेच्दै हुनुहुन्न भने यसलाई 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 reference मा छ।