Модули Zinn Digital® тугмаҳои худи WHMCS-ро ба амалҳои воқеӣ дар платформаи мо табдил медиҳад. Як фармоиш хостинги муштарии шуморо фаъол месозад. Автоматикунонии ҳисобномаҳои аз муҳлат гузаштаи WHMCS онро муваққатан бозмедорад. Ҳамчун пардохтшуда қайд кардани ҳисобнома онро аз боздорӣ озод мекунад. Бекор кардан несткуниро ба нақша мегирад. Ва муштарии шумо дар қисмати муштарии худ тугмаи Ба панели хостинг ворид шавед-ро дастрас менамояд, ки ӯро мустақиман ворид месозад.
Он ройгон аст, таҳти иҷозатномаи 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 | Арзиши такмилро (upgrade) қабл аз иҷрои он бихонед. |
sites.manage | Тоза кардани кэш ва гирифтани нусхаи эҳтиётӣ аз тугмаҳо. |
sites.panel_access | Гузарвожаи маъмури WordPress-ро тағйир диҳед. |
hosting.php.manage | Ҳангоми такмил ё поин бурдани тарофа нусхаи PHP-ро иваз кунед. |
⛔ Ба reseller.manage иҷозат надиҳед. Калиде, ки ба панели ҳисоббаробаркунӣ гузошта мешавад, бояд тавонад муштариро барои пардохт накардан боздорад ва ӯро ворид созад. Он набояд тавонад маълумоти воридшавии дарвозаи пардохти худи шуморо бихонад ва аз нав бинависад. reseller.provision маҳз барои он вуҷуд дорад, ки ба шумо лозим наояд иҷозати калонтарро пешниҳод кунед. ⛔ org.create ихтиёрӣ нест. Бе он модул метавонад ҳисобҳои шуморо бихонад ва наметавонад ҳисоберо кушояд, бинобар ин Санҷиши пайвастшавӣ бомуваффақият мегузарад ва фармоиши аввал бо 403 ҷавоб медиҳад. ⛔⛔ Ба тамоми ҷадвал иҷозат диҳед ва ба назар гиред, ки Санҷиши пайвастшавӣ ба шумо гуфта наметавонад, ки оё шумо инро накардаед. Он барномаи реселлерии шуморо мехонад ва чизеро омода намесозад, бинобар ин барои калиде, ки яке аз инҳоро надорад, сабз нишон медиҳад. Ба ҷои ин, шумо танҳо пас аз моҳҳо аз ҷониби як муштарӣ ҳангоми иҷрои ҳамон як амалиёте, ки иҷозати намерасида онро фаро мегирад, хатои 403 мегиред.
2. Модулро насб кунед
- Модулро зеркашӣ кунед ва онро аз бойгонӣ кушоед.
- Папкаи
zinn-ро ба насби WHMCS-и худ бор кунед, то файли модул дар
modules/servers/zinn/zinn.php ҷойгир шавад.
⛔ Папка бояд zinn номида шавад. WHMCS номҳои функсияҳои модули таъминотиро аз номи папкаи он мегирад, бинобар ин тағйир додани номи он ба zinn-whmcs ё zinndigital модулеро ба вуҷуд меорад, ки WHMCS онро номбар мекунад, имкони интихобро медиҳад ва сипас ҳеҷ гоҳ онро даъват намекунад — бе ягон хато дар ягон ҷо. Файли zip аллакай бо номи дуруст кушода мешавад; танҳо номи онро иваз накунед.
3. Серверро илова кунед
Дар WHMCS: Configuration → System Settings → Servers → Add New Server.
- Name: дилхоҳ чиз, масалан
Zinn Digital®
- Hostname:
api.zinndigital.com
- Type:
Zinn Digital®
- Password: калиди API-и шумо аз қадами 1
⛔ Калид ба майдони 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) ҳатмист ва фармоиши бидуни он қасдан рад карда мешавад. То санаи 2026-09-01 ин майдон ороишӣ буд ва чизе онро намехонд, бинобар ин модул хостингеро фармоиш медод, ки умуман ягон тарофа надошт — ва ҳама оқибатҳои ин бе огоҳӣ рух медоданд. Ҳисоботи яклухти шумо аз обунаҳои фаъоли муштариёнатон тартиб дода мешавад, бинобар ин барои ин хизматрасонӣ сатре вуҷуд надошт ва то даме ки он кор мекард, ба шумо ҳеҷ гуна ҳисобнома пешниҳод намешуд; муштарии шумо ҳеҷ гуна маҳдудиятро ба мерос намегирифт, аз ин рӯ ба сомонаи онҳо ягон квотаи диск ё файл татбиқ намешуд; ва 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 барои сомонае, ки мо аз он ягон хониш надорем, ба муштарии шумо рахи истифодаи холии таскинбахшро нишон медод.
Баррасии мушкилот
Санҷиши пайвастшавӣ муваффақ мешавад ва фармоиши аввал бо хатои иҷозат ноком мегардад. Дар калиди 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 оварда шудааст.