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. Модульді орнату
- Модульді жүктеп алып, архивтен шығарыңыз.
- WHMCS орнатылымыңызға
zinn каталогын модуль файлы
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: 1-қадамдағы API кілтіңіз
⛔ Кілт WHMCS шифрлап сақтайтын Password өрісіне жазылады. Оны өнімнің баптау опциясына қоймаңыз — олар дерекқорда қарапайым мәтін күйінде болады және әрбір әкімшіге көрінеді, ал бұл тіркелгі дерегі клиенттеріңіздің хостингін жасай да, жоя да алады.
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 service id бойынша идемпотентті, сондықтан қайталанған іске қосу сізге екінші сайт үшін ақы алудың орнына сол сайтты қайтарады.
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 қойындысы | Күйі, жоспары, дискісі, трафигі, кез келген жоспарланған жою және тоқтата тұруды кім орнатқаны. |
| 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 анықтамалығында берілген.