Zinn Digital® модул претвара сопствене WHMCS дугмиће у стварне радње на нашој платформи. Поруџбина омогућава хостинг Вашег клијента. WHMCS аутоматизација за неплаћене рачуне га суспендује. Означавање рачуна као плаћеног га поново активира. Отказивање заказује брисање. А Ваш клијент у својој корисничкој зони добија дугме Пријавите се на контролну таблу хостинга које га директно пријављује.
Бесплатан је, лиценциран под GPL-2.0-or-later и нема повлашћен приступ нашој платформи: сваки позив који упућује јесте документована крајња тачка коју бисте могли сами позвати сопственим API кључем.
Пре него што почнете
Потребне су Вам две ствари, а друга често изненади кориснике.
- Zinn® налог за препродавце са активним програмом. Региструјте се на zinndigital.com и укључите препродају.
- План за препродавце са дозвољеним бројем сајтова. Сајтови које Ваши клијенти поруче урачунавају се у Ваш план, па Вам је потребан онај са слободним капацитетом.
⚠️ Тестирање везе не може Вам рећи да ли ће поруџбина успети. Оно очитава Ваш програм и не покреће ништа, па пријављује исправан active налог који још увек не може ништа да продаје. Ако Ваша прва поруџбина не успе уз поруку „Ова организација нема хостинг план, тако да још увек не може да хостује сајт“, управо се то догодило — купите или проширите свој план за препродавце и поново пошаљите поруџбину. Са модулом је све у реду.
1. Креирајте API кључ
На својој Zinn® контролној табли отворите API кључеви и креирајте један са тачно ових једанаест дозвола:
| Дозвола | Зашто је потребна |
|---|
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. Инсталирајте модул
- Преузмите модул и распакујте га.
- Отпремите директоријум
zinn у своју WHMCS инсталацију тако да датотека модула буде смештена на modules/servers/zinn/zinn.php.
⛔ Директоријум се мора звати zinn. WHMCS изводи називе функција модула за обезбеђивање ресурса из назива његовог директоријума, па преименовање у zinn-whmcs или zinndigital ствара модул који WHMCS приказује на листи, дозвољава вам да га изаберете, а затим га никада не позива — без икакве грешке било где. Zip архива се већ распакује са исправним називом; само је немојте преименовати.
3. Додајте сервер
У WHMCS-у: Конфигурација → Подешавања система → Сервери → Додај нови сервер.
- Назив: било шта, нпр.
Zinn Digital®
- Име хоста:
api.zinndigital.com
- Врста:
Zinn Digital®
- Лозинка: ваш API кључ из корака 1
⛔ Кључ се уноси у поље Лозинка, које WHMCS чува шифровано. Немојте га стављати у опцију за конфигурацију производа — оне су у бази података у обичном тексту и видљиве су сваком администратору, а ови акредитиви могу да креирају и униште хостинг ваших клијената.
Притисните Тестирај везу. Ово шаље прави позив и обавештава о томе шта је наша платформа одговорила, уместо да само проверава да ли су поља попуњена.
4. Креирајте производ
Конфигурација → Системска подешавања → Производи/Услуге, а затим подесите Подешавања модула на сервер који сте управо додали. Поља су:
| Поље | Обавезно | Шта представља |
|---|
| Линија производа | да | Zinn® линија коју продајете — mainstream (управљани WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, mail или reseller. |
| Стек | да | Шта се гради: wordpress (подразумевано), woocommerce, php, static, node, one_click, headless_cms, nextcloud или owncloud. |
| Апликација | не | Само за стекове one_click и headless_cms — коју апликацију инсталирати. Навођење на било ком другом стеку биће одбијено, јер тај стек већ одређује шта се инсталира. |
| PHP верзија | не | нпр. 8.3. Оставите празно за подразумевану верзију дате линије. Верзија коју линија не нуди биће одбијена уз листу оних које нуди. |
| Шифра плана | да | Zinn® план који овај производ продаје. GET /v1/reseller/prices наводи ваше. Поруџбина без ње биће одбијена — погледајте упозорење испод. |
| Интервал наплате | не | monthly (подразумевано) или annual — интервал према ком се издаје ваша велепродајна линија за овог клијента. Оно што наплаћујете сопственом клијенту подешава се на WHMCS производу и остаје непромењено. |
⛔⛔ Код плана је обавезан, а поруџбина без њега се намерно одбија. До 2026-09-01 ово поље је било само декоративно и ништа га није читало, па је модул наручивао хостинг који није имао никакав план — а свака последица тога била је неприметна. Ваш велепродајни обрачун се формира на основу активних претплата ваших клијената, тако да није било ставке за ову услугу и ништа вам није фактурисано све време док је била активна; ваш клијент није наследио никакве ресурсе, па на његов сајт није примењена никаква квота за диск или датотеке; а опција Промени пакет није имала шта да промени, па надоградња коју сте продали није могла да се изврши. Сајт се све време беспрекорно покретао и радио.
Модул сада уместо тога одбија поруџбину, јер не постоји безбедан план који би могао да нагађа: нагађање би покренуло хостинг са планом који нисте изабрали и за који можда нисте одредили цену, и — за разлику од одбијања, које одмах видите — то би се приметило тек када стигне обрачун, ако и тада.
Подесите Аутоматско подешавање на шта год желите — модул је идемпотентан у односу на WHMCS id услуге, па поновљени покушај покретања враћа исти сајт уместо да вам наплати други.
Шта ради свака WHMCS акција
| WHMCS радња | Шта се дешава са наше стране |
|---|
| Креирај | Креира клијентов Zinn® налог (или поново користи постојећи) и припрема њихов сајт. |
| Суспендуј | Ставља сајт на чекање због неплаћања. Садржај се задржава; ништа се не брише. |
| Укини суспензију | Уклања вашу суспензију. |
| Окончај | Заказује брисање сајта, уз грејс период. Датум се приказује у корисничком делу. |
| Ажурирање потрошње | Освежава податке о диску и протоку за сваку услугу, једном дневно. |
| Пријавите се на контролни панел хостинга | Отвара једнократни линк за пријаву директно у панел вашег клијента. |
| Промени пакет | Надограђује или умањује ниво услуге. Премешта пакет, као и PHP верзију ако је нови производ наводи. |
| Промени лозинку | Поставља лозинку за WordPress администратора. Поље се не приказује на системима који немају такав налог. |
| Обнови | Потврђује да услуга и даље постоји. Zinn® хостинг је континуиран, тако да нема удаљеног рока за продужење. |
| Синхронизуј потрошњу / Очисти кеш / Направи резервну копију | Дугмад на администраторској страници услуге. Ваш клијент добија Очисти кеш и Направи резервну копију у свом корисничком делу. |
| Картица Услуга | Статус, план, диск, проток, свако заказано брисање и податак о томе ко је поставио суспензију. |
| Увези | ListAccounts чита сваку страницу, тако да увоз не може тихо стати на првој. |
Надоградње: ко коме наплаћује
Вашем клијенту Zinn® никада не шаље фактуру, ни при наруџбини ни при надоградњи. Ви им наплаћујете путем WHMCS-а; ми наплаћујемо вама, на вашем велепродајном изводу. Дакле, Промени пакет преноси права вашег клијента и ставку на вашем следећем изводу, и не дира ниједну картицу — WHMCS је већ наплатио новац од вашег клијента и израчунао своју сразмерну наплату.
Друга услуга клијента. На истом тарифном пакету то је још један сајт у оквиру дозвољеног броја сајтова за тај пакет, и ништа додатно се не одобрава. На различитом пакету се одбија: замена активног пакета оставила би једну од две услуге ненаплаћеном. Или продајте обе на истом пакету, или подесите клијента као засебан запис клијента у WHMCS-у.
Промени лозинку постоји само за WordPress. Zinn® хостинг нема јединствену „лозинку за услугу“ — ваш клијент приступа свом панелу помоћу дугмета за пријављивање — а php или static сајт нема кориснички налог апликације који би се мењао. WHMCS у потпуности сакрива то поље уместо да приказује оно које не може да функционише.
Три одговора која не смете свести на два
- Укидање суспензије може одговорити одбијањем. То значи да је сајт суспендовао наш тим за злоупотребе, а не ви, и ниједан панел за наплату га не може ослободити. Порука то и наводи; покажите је свом администратору уместо да покушавате поново.
- Прекид услуге заказује брисање, али га не извршава. Датум се враћа као
pending_deletion_at и кориснички панел га приказује. Рећи клијенту да су његови подаци већ обрисани када нису је горе него не рећи му ништа.
- Диск и проток могу бити непознати, а непознато није нула. Када нисмо могли да очитамо вредности, модул оставља број онаквим какав јесте уместо да упише
0 — у супротном би WHMCS вашем клијенту приказао умирујућу празну траку потрошње за сајт за који немамо очитавање.
Решавање проблема
Тест повезивања успева, а прва поруџбина не успева уз грешку о дозволама. API кључу недостаје org.create. Модул мора да отвори налог клијента пре него што може да креира његов сајт.
Поруџбина не успева уз поруку да организација нема хостинг пакет. Ваш риселер пакет нема преосталих дозвољених сајтова, или га још увек немате. Погледајте одељак Пре него што почнете изнад.
Поруџбина не успева уз помињање стека. Поље Стек на производу је празно или наводи нешто што ми не правимо. Поставите га на 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 референци.