Zinn Digital® մոդուլը WHMCS-ի կոճակները վերածում է իրական գործողությունների մեր հարթակում: Պատվերը ապահովում է Ձեր հաճախորդի հոսթինգը: WHMCS-ի ժամկետանց հաշիվ-ապրանքագրերի ավտոմատացումը կասեցնում է այն: Հաշիվ-ապրանքագիրը վճարված նշելը ապակասեցնում է այն: Չեղարկումը պլանավորում է ջնջումը: Իսկ Ձեր հաճախորդն իր հաճախորդի տարածքում ստանում է Մուտք գործել հոսթինգի կառավարման վահանակ կոճակ, որն անմիջապես մուտք է գործում համակարգ:
Այն անվճար է, լիցենզավորված է GPL-2.0-or-later-ով և չունի արտոնյալ մուտքի ուղի դեպի մեր հարթակ. յուրաքանչյուր հարցում, որ այն կատարում է, փաստաթղթավորված վերջնակետ է, որը Դուք ինքներդ կարող եք կատարել Ձեր սեփական API բանալիով:
Նախքան սկսելը
Ձեզ անհրաժեշտ է երկու բան, և երկրորդը հաճախ անակնկալի է բերում մարդկանց:
- Zinn® ռեսելլերի հաշիվ՝ ակտիվ ծրագրով: Գրանցվեք
zinndigital.com կայքում և միացրեք վերավաճառքը (reselling):
- Ռեսելլերի սակագնային պլան՝ կայքերի սահմանաչափով (site allowance): Ձեր հաճախորդների պատվիրած կայքերը հաշվառվում են Ձեր
սակագնային պլանի հաշվին, ուստի Ձեզ անհրաժեշտ է ազատ տեղ ունեցող պլան:
⚠️ 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-ը կամընտիր չէ: Առանց դրա մոդուլը կարող է կարդալ Ձեր հաշիվները, բայց չի կարող բացել նորը, ուստի 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 բանալին 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 հավաքակազմերի (stacks) համար՝ որ հավելվածը տեղադրել: Որևէ այլ հավաքակազմի վրա հավելված նշելը մերժվում է, քանի որ այդ հավաքակազմն արդեն որոշում է, թե ինչ է տեղադրվում: |
| 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 ծառայության 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 tab | Կարգավիճակ, պլան, սկավառակ, թողունակություն, ցանկացած պլանավորված ջնջում և այն, թե ով է կիրառել կասեցումը: |
| Import | ListAccounts-ը կարդում է յուրաքանչյուր էջ, ուստի ներմուծումը չի կարող լռելյայն կանգ առնել առաջինի վրա: |
Արդիականացումներ. ով ումից է գանձում
Ձեր հաճախորդին երբեք հաշիվ չի ներկայացվում Zinn®-ի կողմից՝ ո՛չ պատվերի, ո՛չ էլ արդիականացման ժամանակ: Դուք նրանցից գանձում եք WHMCS-ի միջոցով. մենք գանձում ենք Ձեզանից՝ Ձեր մեծածախ քաղվածքում: Այսպիսով, Change Package-ը փոխում է Ձեր հաճախորդի իրավասությունները և Ձեր հաջորդ քաղվածքի տողը, և չի շոշափում որևէ քարտ — WHMCS-ն արդեն վերցրել է Ձեր հաճախորդի գումարը և հաշվարկել իր սեփական համամասնական բաշխումը (proration):
Հաճախորդի երկրորդ ծառայությունը: Նույն պլանի դեպքում դա մեկ այլ կայք է այդ պլանի սեփական կայքերի սահմանաչափի ներքո, և ավելին ոչինչ չի տրամադրվում: Այլ պլանի դեպքում այն մերժվում է. գործող պլանի փոխարինումը երկու ծառայություններից մեկը կթողներ չվճարված: Կամ վաճառեք երկուսն էլ նույն պլանով, կամ կարգավորեք հաճախորդին որպես առանձին հաճախորդի գրառում WHMCS-ում:
Change Password-ը գոյություն ունի միայն WordPress-ի համար: Zinn® հոսթինգը չունի մեկ ընդհանուր «ծառայության գաղտնաբառ» — Ձեր հաճախորդն իր վահանակ է հասնում մուտքի կոճակով — իսկ php կամ static կայքը չունի հավելվածի հաշիվ, որը կարելի է փոխել: WHMCS-ը լիովին թաքցնում է դաշտը, քան ցույց է տալիս այնպիսին, որը չի կարող աշխատել:
Երեք պատասխան, որոնք չպետք է նույնացնեք երկուսի հետ
- Unsuspend-ը կարող է պատասխանել մերժմամբ: Դա նշանակում է, որ կայքը կասեցվել է չարաշահումների դեմ պայքարի մեր
թիմի կողմից, այլ ոչ թե Ձեր, և ոչ մի հաշվարկային վահանակ չի կարող այն ապակասեցնել: Հաղորդագրությունն ասում է այդ մասին. ցույց տվեք այն Ձեր ադմինիստրատորին՝ կրկին փորձելու փոխարեն:
- Terminate-ը պլանավորում է ջնջում, այն չի իրականացնում այն: Ամսաթիվը վերադառնում է որպես
pending_deletion_at, և հաճախորդի տարածքը ցույց է տալիս այն: Հաճախորդին ասելը, որ նրա տվյալներն արդեն ջնջված են, երբ դա այդպես չէ, ավելի վատ է, քան նրան ոչինչ չասելը:
- Սկավառակը և թողունակությունը կարող են անհայտ լինել, իսկ անհայտը զրո չէ: Երբ մենք չենք կարողացել
ցուցանիշ վերցնել, մոդուլը թողնում է թիվն անփոփոխ, այլ ոչ թե գրում է 0 — հակառակ դեպքում WHMCS-ը Ձեր հաճախորդին ցույց կտա հանգստացնող դատարկ օգտագործման սանդղակ այն կայքի համար, որից մենք ցուցանիշ չունենք:
Խնդիրների լուծում
Test Connection-ն անցնում է, իսկ առաջին պատվերը ձախողվում է թույլտվության սխալով: API բանալուն պակասում է org.create թույլտվությունը: Մոդուլը պետք է բացի հաճախորդի հաշիվը, նախքան կկարողանա ստեղծել նրա կայքը:
Պատվերը ձախողվում է՝ նշելով, որ կազմակերպությունը չունի հոսթինգի պլան: Ձեր ռեսելլերի պլանում կայքերի սահմանաչափ չի մնացել, կամ Դուք դեռ չունեք այդպիսի պլան: Տես վերևում՝ Նախքան սկսելը բաժինը:
Պատվերը ձախողվում է՝ նշելով հավաքակազմը (stack): Ապրանքի վրա 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 տեղեկատուում: