Zinn Digital® modulu WHMCS-in öz düymələrini platformamızda real əməliyyatlara çevirir. Sifariş müştərinizin hostinqini təmin edir. WHMCS-in vaxtı keçmiş hesab-faktura avtomatlaşdırması onu dayandırır. Hesab-fakturanın ödənildi kimi qeyd edilməsi onu aktivləşdirir. Ləğvetmə silinməni planlaşdırır. Müştəriniz isə müştəri panelində onları birbaşa sistemə daxil edən Hostinq panelinə daxil ol düyməsi əldə edir.
Bu pulsuzdur, GPL-2.0-və-ya-daha-sonrakı lisenziyasına malikdir və platformamıza heç bir imtiyazlı çıxış yoluna sahib deyil: etdiyi hər bir çağırış, öz API açarınızla şəxsən edə biləcəyiniz sənədləşdirilmiş son nöqtədir.
Başlamazdan əvvəl
Sizə iki şey lazımdır və ikincisi insanları çaşdırır.
- Aktiv proqramı olan Zinn® reseller hesabı. zinndigital.com
saytında qeydiyyatdan keçin və reseller xidmətini aktivləşdirin.
- Sayt limiti olan reseller planı. Müştərilərinizin sifariş etdiyi saytlar sizin
planınızdan çıxılır, buna görə də daxilində yer olan bir plana ehtiyacınız var.
⚠️ Test Connection sifarişin uğurlu olub-olmayacağını sizə deyə bilməz. O, proqramınızı oxuyur və heç nə təmin etmir, buna görə də hələ heç nə sata bilməyən saz active hesab barədə məlumat verir. Əgər ilk sifarişiniz "This organization has no hosting plan, so it cannot host a site yet" xətası ilə uğursuz olarsa, baş verən məhz budur — reseller planınızı alın və ya müddətini uzadın və sifarişi yenidən yerləşdirin. Modulda heç bir problem yoxdur.
1. API açarını yaradın
Zinn® idarəetmə panelinizdə API keys bölməsini açın və tam olaraq bu on bir icazəyə malik bir açar yaradın:
| İcazə | Niyə lazımdır |
|---|
org.create | İlk sifarişində müştərinizin Zinn® hesabını açmaq üçün. |
org.read | Müştəri hesablarınızı oxumaq üçün. |
sites.create | Saytı təmin etmək üçün. |
sites.view | Xidməti və onun istifadəsini oxumaq üçün. |
sites.delete | Xitam vermək üçün. |
reseller.view | Nə satdığınızı siyahıya almaq, disk və şəbəkə trafikini oxumaq üçün. |
reseller.provision | Müştərini dayandırmaq, aktivləşdirmək, sistemə daxil etmək, planını təyin etmək və paketini dəyişmək üçün. |
billing.view | Yeniləməni həyata keçirməzdən əvvəl onun nə qədər başa gələcəyini oxumaq üçün. |
sites.manage | Düymələrdən keş təmizləmək və nüsxə çıxarmaq üçün. |
sites.panel_access | WordPress inzibatçısının şifrəsini dəyişmək üçün. |
hosting.php.manage | Planı yüksəltdikdə və ya endirdikdə PHP versiyasını dəyişmək üçün. |
⛔ reseller.manage icazəsini verməyin. Ödəniş panelinə daxil edilmiş açar ödənişin edilməməsinə görə müştərini dayandıra və onu sistemə daxil edə bilməlidir. O, sizin öz ödəniş şlüzü məlumatlarınızı oxuya və yenidən yaza bilməməlidir. Daha böyük icazəni verməyə məcbur qalmayasınız deyə reseller.provision mövcuddur. ⛔ org.create könüllü deyil. Onsuz modul hesablarınızı oxuya bilir, lakin hesab aça bilmir, buna görə Test Connection uğurla keçir və ilk sifariş 403 cavabını verir. ⛔⛔ Bütün cədvələ icazə verin və nəzərə alın ki, vermədiyiniz təqdirdə Test Connection bunu sizə deyə bilməz. O, reseller proqramınızı oxuyur və heç nə təmin etmir, buna görə də bunlardan hər hansı biri çatışmayan açar üçün yaşıl yanır. Bunun əvəzinə əldə etdiyiniz şey, aylar sonra bir müştəridən gələn, çatışmayan icazənin əhatə etdiyi tək bir əməliyyatda 403 xətası olur.
2. Modulu quraşdırın
- Modulu yükləyin və arxivdən çıxarın.
zinn qovluğunu WHMCS quraşdırmanıza yükləyin ki, modul faylı
modules/servers/zinn/zinn.php ünvanına düşsün.
⛔ Qovluq zinn adlanmalıdır. WHMCS təminat modulunun funksiya adlarını onun qovluq adından götürür, ona görə də onu zinn-whmcs və ya zinndigital olaraq yenidən adlandırmaq WHMCS-in siyahıya aldığı, seçməyinizə imkan verdiyi və sonra heç vaxt çağırmadığı bir modul yaradır — heç bir yerdə heç bir xəta olmadan. Arxiv artıq düzgün adla açılır; sadəcə adını dəyişməyin.
3. Serveri əlavə edin
WHMCS-də: Configuration → System Settings → Servers → Add New Server.
- Name: istənilən ad, məsələn,
Zinn Digital®
- Hostname:
api.zinndigital.com
- Type:
Zinn Digital®
- Password: 1-ci addımdakı API açarınız
⛔ Açar, WHMCS-in şifrələnmiş şəkildə saxladığı Password sahəsinə daxil edilir. Onu məhsulun konfiqurasiya seçiminə qoymayın — bunlar verilənlər bazasında açıq mətndir və hər bir inzibatçıya görünür, bu giriş məlumatı isə müştərilərinizin hostinqini yarada və silə bilər.
Test Connection düyməsini sıxın. O, sahələrin doldurulduğunu yoxlamaq əvəzinə, real bir çağırış edir və platformamızın nə bildirdiyini qeyd edir.
4. Məhsulu yaradın
Configuration → System Settings → Products/Services, sonra Module Settings bölməsini indicə əlavə etdiyiniz serverə təyin edin. Sahələr bunlardır:
| Sahə | Məcburidir | Nədir |
|---|
| Product line | bəli | Satdığınız Zinn® xətti — mainstream (idarə olunan WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail və ya reseller. |
| Stack | bəli | Nəyin qurulduğu: wordpress (standart), woocommerce, php, static, node, one_click, headless_cms, nextcloud və ya owncloud. |
| Application | xeyr | Yalnız one_click və headless_cms stəkləri üçün — hansı tətbiqin quraşdırılacağı. İstənilən digər stəkdə bir ad göstərmək rədd edilir, çünki həmin stək artıq nəyin quraşdırılacağını müəyyənləşdirir. |
| PHP version | xeyr | məsələn, 8.3. Xəttin standartı üçün boş buraxın. Xəttin təklif etmədiyi versiya, təklif etdiklərinin siyahısı ilə birlikdə rədd edilir. |
| Plan code | bəli | Bu məhsulun satdığı Zinn® planı. GET /v1/reseller/prices sizinkiləri siyahıya alır. O olmadan sifariş rədd edilir — aşağıdakı xəbərdarlığa baxın. |
| Billing interval | xeyr | monthly (standart) və ya annual — bu müştəri üçün sizin topdansatış xəttinizin hesablandığı interval. Öz müştərinizdən nə qədər alacağınız WHMCS məhsulunda təyin edilir və təsirlənmir. |
⛔⛔ Plan code məcburidir və bu kod olmadan sifariş qəsdən rədd edilir. 2026-09-01 tarixinə qədər sahə dekorativ idi və heç nə onu oxumurdu, buna görə də modul heç bir plan daşımayan hostinq sifariş edirdi — və bunun hər bir nəticəsi səssiz qalırdı. Sizin topdansatış hesabatınız müştərilərinizin aktiv abunəliklərindən formalaşır, buna görə də xidmət üçün heç bir sətir yox idi və işlədiyi müddətcə sizə heç bir faktura çıxarılmırdı; müştəriniz heç bir limit əldə etmirdi, buna görə də onların saytına heç bir disk və ya fayl kvotası tətbiq olunmurdu; və Change Package əməliyyatının dəyişdirəcəyi heç nə yox idi, buna görə də satdığınız yüksəltmə icra edilə bilmirdi. Sayt bütün bu müddət ərzində təmin olunur və problemsiz xidmət göstərirdi.
Modul artıq bunun əvəzinə sifarişi rədd edir, çünki onun təxmin etməsi üçün təhlükəsiz heç bir plan yoxdur: təxmin etmək, seçmədiyiniz və qiymətləndirmədiyiniz bir planda hostinqi təmin edərdi və — dərhal oxuduğunuz rədd cavabından fərqli olaraq — bu, yalnız hesabat gəldikdə üzə çıxardı, əgər ümumiyyətlə çıxardısa.
Auto Setup seçimini hansına üstünlük verirsinizsə ona təyin edin — modul WHMCS xidmət identifikatoru üzrə idempotentdir, buna görə də yenidən cəhd edilən təminat sizi ikinci bir sayt üçün fakturalandırmaq əvəzinə eyni saytı qaytarır.
Hər bir WHMCS əməliyyatı nə edir
| WHMCS əməliyyatı | Bizim tərəfdə nə baş verir |
|---|
| Create | Müştərinin Zinn® hesabını yaradır (və ya artıq sahib olduqlarını təkrar istifadə edir) və onların saytını təmin edir. |
| Suspend | Saytı ödəniş edilməməsi səbəbindən dayandırmaya qoyur. Məzmun saxlanılır; heç nə silinmir. |
| Unsuspend | Sizin dayandırmanızı ləğv edir. |
| Terminate | Güzəşt müddəti ilə saytın silinməsini planlaşdırır. Tarix müştəri panelində göstərilir. |
| Usage update | Hər bir xidmətdə gündə bir dəfə disk və şəbəkə trafikini yeniləyir. |
| Log in to hosting panel | Birbaşa müştərinizin panelinə daxil olan birdəfəlik, tək istifadəlik giriş linki açır. |
| Change Package | Xidməti yüksəldir və ya endirir. Paketi və yeni məhsul birini göstərirsə, PHP versiyasını dəyişir. |
| Change Password | WordPress administrator's şifrəsini təyin edir. Belə bir hesabı olmayan stəklərdə qutu görünmür. |
| Renew | Xidmətin hələ də mövcud olduğunu təsdiqləyir. Zinn® hostinqi fasiləsizdir, buna görə də uzadılacaq uzaqdan müddət yoxdur. |
| Sync Usage / Purge Cache / Take Backup | İnzibatçı xidmət səhifəsindəki düymələr. Müştəriniz öz müştəri panelində Purge Cache və Take Backup əldə edir. |
| Service tab | Status, plan, disk, şəbəkə trafiki, hər hansı planlaşdırılmış silinmə və dayandırmanı kimin tətbiq etdiyi. |
| Import | ListAccounts hər səhifəni oxuyur, buna görə idxal səssizcə birincidə dayana bilməz. |
Yüksəltmələr: kim kimdən ödəniş alır
Sifarişdə və ya yüksəltmədə müştərinizə heç vaxt Zinn® tərəfindən hesab-faktura təqdim edilmir. Siz onlara WHMCS vasitəsilə hesab təqdim edirsiniz; biz isə sizə, topdansatış hesabatınızda hesab təqdim edirik. Beləliklə, Change Package müştərinizin hüquqlarını və növbəti hesabatınızdakı sətri dəyişir və heç bir karta toxunmur — WHMCS artıq müştərinizin pulunu alıb və öz mütənasib bölgüsünü hesablayıb.
Müştərinin ikinci xidməti. Eyni planda bu, həmin planın öz sayt limiti çərçivəsində başqa bir saytdır və əlavə heç nə verilmir. Fərqli planda bu rədd edilir: aktiv planı əvəzləmək iki xidmətdən birini hesab-fakturasız qoyardı. Ya hər ikisini eyni planda satın, ya da müştərini WHMCS-də ayrıca müştəri qeydi kimi quraşdırın.
Change Password yalnız WordPress üçün mövcuddur. Zinn® hostinqinin vahid "xidmət şifrəsi" yoxdur — müştəriniz öz panelinə giriş düyməsi ilə daxil olur — və php və ya static saytın dəyişdiriləcək tətbiq hesabı yoxdur. WHMCS işləyə bilməyən bir qutunu göstərməkdənsə, onu tamamilə gizlədir.
İkiyə endirməməli olduğunuz üç cavab
- Unsuspend rədd cavabı ilə cavab verə bilər. Bu o deməkdir ki, sayt sizin tərəfinizdən deyil,
bizim sui-istifadə komandamız tərəfindən dayandırılıb və heç bir ödəniş paneli onu aktivləşdirə bilməz. Mesajda bu bildirilir; yenidən cəhd etməkdənsə, bunu inzibatçınıza göstərin.
- Terminate silinməni icra etmir, planlaşdırır. Tarix
pending_deletion_at kimi qayıdır və
müştəri paneli bunu göstərir. Müştəriyə məlumatlarının hələ silinmədiyi halda artıq getdiyini demək, heç nə deməməkdən daha pisdir.
- Disk və şəbəkə trafiki naməlum ola bilər və naməlum sıfır demək deyil. Göstəricini oxuya bilmədiyimiz
zaman modul 0 yazmaq əvəzinə rəqəmə toxunmur — əks halda WHMCS müştərinizə heç bir göstərici almadığımız sayt üçün arxayınlaşdırıcı boş istifadə zolağı göstərərdi.
Problemlərin aradan qaldırılması
Test Connection uğurla keçir və ilk sifariş icazə xətası ilə uğursuz olur. API açarında org.create çatışmır. Modul saytını yaratmazdan əvvəl müştərinin hesabını açmalıdır.
Sifariş təşkilatın hostinq planının olmadığını bildirərək uğursuz olur. Reseller planınızda heç bir sayt limiti qalmayıb və ya hələ birinə sahib deyilsiniz. Yuxarıdakı Başlamazdan əvvəl bölməsinə baxın.
Sifariş stəki qeyd edərək uğursuz olur. Məhsuldakı Stack sahəsi boşdur və ya bizim qurmadığımız bir şeyi adlandırır. Başqa bir şey satmırsınızsa, onu wordpress olaraq təyin edin.
Ləğvetmələr uğursuz olur. Modulun 1.0.0 və ya daha sonrakı versiyasında olduğunuzdan əmin olun. Əvvəlki buraxılışlar heç bir silinmə təsdiqi göndərmirdi və hər bir xitam rədd edilirdi, bu da xidməti işlək və hesablanan vəziyyətdə qoyurdu.
Sahəni adlandıran rədd cavabı. Doğrulama xətalarımız mesajdan sonra mötərizədə sahəni və səbəbi adlandırır, məsələn, (php_version: 7.2 is not offered on this product line). Bu, tədbir görülə bilən hissədir — onun qarşısındakı cümlə qəsdən ümumidir.
Yükləmənizi yoxlayın
Hər bir arxiv öz host adımızdan TLS vasitəsilə təqdim edilir və heç vaxt üçüncü tərəf hostuna yönləndirilmir. Onun SHA-256 yoxlama cəmi yükləmələr səhifəsində yükləmə linkinin yanında qeyd olunub. Yüklədikdən sonra onu müqayisə edin:
- macOS və ya Linux:
shasum -a 256 zinn-whmcs-1.0.0.zip
- Windows:
certutil -hashfile zinn-whmcs-1.0.0.zip SHA256
WHMCS istifadə etmirsiniz?
Digər hər şey üçün HostBill modulu və tək fayllı PHP müştərisi var, hər ikisi pulsuzdur və hər ikisi eyni yükləmələr səhifəsindədir. Modulların istifadə etdiyi hər bir son nöqtə API sorğu kitabçasındadır.