Фурӯши мизбонии Zinn® тавассути WHMCS

Модули Zinn Digital® тугмаҳои худи WHMCS-ро дар платформаи мо ба амалҳои воқеӣ табдил медиҳад. Супориш ҳостинги муштарии шуморо фаъол мекунад. Автоматизатсияи ҳисобҳои дермондаи WHMCS онро боздорад (муваққатан хомӯш) мекунад. Нишон додани ҳисоб ба унвони пардохтшуда онро озод мекунад. Бекоркунӣ несткуниро ба нақша мегирад. Ва муштарии шумо дар минтақаи муштарии худ тугмаи Воридшавӣ ба панели ҳостинг-ро мегирад, ки онҳоро мустақиман ворид мекунад.

Он ройгон аст, дорои литсензияи GPL-2.0-or-later мебошад ва ба платформаи мо ягон роҳи имтиёзнок надорад: ҳар як дархосте, ки он мекунад, як нуқтаи ниҳоии ҳуҷҷатгузоришуда аст, ки шумо метавонед худатон бо калиди API-и худ иҷро кунед.

Пеш аз он ки оғоз кунед

Ба шумо ду чиз лозим аст ва чизи дуюм одамонро ба фиреб меандозад.

1. Ҳисоби фурӯшандаи Zinn® бо барномаи фаъол. Дар сайти zinndigital.com сабти ном кунед ва фурӯшро фаъол созед.
2. Нақшаи фурӯшанда бо меъёри сайтҳо. Сайтҳое, ки муштариёни шумо супориш медиҳанд, ба нақшаи шумо ҳисоб карда мешаванд, бинобар ин ба шумо нақшае лозим аст, ки дар он ҷои холӣ бошад.

⚠️ Санҷиши пайвастшавӣ (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. Насб кардани модул

1. Модулро боргирӣ кунед ва онро аз архив бароред.
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 танзим карда мешавад ва бетағйир мемонад. |

⛔⛔ Коди нақша маҷбурӣ аст ва супориши бе он мақсаднок рад карда мешавад. Таърихи 2026-09-01 майдон ороишӣ буд ва ҳеҷ чиз онро намехонд, бинобар ин модул ҳостингеро супориш медод, ки ягон нақша надошт — ва ҳама оқибатҳои он хомӯш буданд. Баёноти оптомии шумо аз обунаҳои зиндаи муштариёни шумо сохта мешавад, бинобар ин барои хизматрасонӣ ягон сатр набуд ва ба шумо ҳеҷ чиз ҳисоб карда нашудааст то даме ки он кор мекард; муштарии шумо ҳеҷ гуна имтиёзҳоро ба мерос нагирифтааст, бинобар ин ба сайти онҳо квотаи диск ё файл татбиқ карда нашудааст; ва Change Package ҳеҷ чизе барои тағир додан надошт, бинобар ин афзоиши нақшае, ки шумо фурӯхтаед, иҷро карда нашуд. Сайт дар давоми ин давра комилан фаъол буд ва хизмат мерасонд.

Модул акнун супоришро рад мекунад, зеро ҳеҷ як нақшаи бехатаре барои тахмин кардани он вуҷуд надорад: тахмин ҳостингро дар нақшае, ки шумо интихоб накардаед ва шояд нархгузорӣ накардаед, фаъол мекунад ва — бархилофи радкунӣ, ки шумо фавран мехонед — он танҳо ҳангоми расидани баёнот пайдо мешавад, агар умуман пайдо шавад.

Auto Setup-ро ба ҳар кадоме, ки мехоҳед танзим кунед — модул дар ID-и хизматрасонии 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 аллакай пулҳои муштарии шуморо гирифтааст ва ҳисоботи худро ҳисоб кардааст.

Хизматрасонии дуюми муштарӣ. Дар ҳамон нақша он сайти дигаре мебошад, ки зери меъёри сайти худи ҳамон нақша аст ва ҳеҷ чизи дигаре дода намешавад. Дар нақшаи дигар он рад карда мешавад: иваз кардани нақшаи фаъол яке аз ду хизматрасониро бе ҳисоб мегузорад. Ё ҳардуро дар як нақша фурӯшед, ё муштариро ба unвони сабти муштарии алоҳида дар 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 мебошад.