Prodajte Zinn® hosting sa WHMCS platforme

Zinn Digital® modul pretvara sopstvena dugmad WHMCS-a u stvarne akcije na našoj platformi. Porudžbina obezbeđuje hosting za vašeg klijenta. WHMCS-ova automatizacija za prekoračene fakture ga suspenduje. Označavanje fakture kao plaćene ga ponovo aktivira. Otkazivanje zakazuje brisanje. A vaš klijent dobija dugme Prijavite se na hosting panel u svom klijentskom delu koje ga direktno prijavljuje.

Besplatan je, licenciran pod GPL-2.0-or-later i nema privilegovanu putanju do naše platforme: svaki poziv koji uputi predstavlja dokumentovan krajnji tačku koju biste sami mogli da kreirate sa sopstvenim API ključem.

Pre nego što počnete

Potrebne su vam dve stvari, a druga često zbunjuje ljude.

1. Zinn® nalog preprodavca sa aktivnim programom. Prijavite se na

zinndigital.com i uključite preprodaju.

2. Paket preprodavca sa dodeljenim sajtom. Sajtovi koje vaši klijenti naruče troše prostor na vašem

paketu, tako da vam je potreban paket koji ima slobodnog mesta.

⚠️ Testiranje veze ne može da vam kaže da li će porudžbina biti uspešna. Ono čita vaš program i ne obezbeđuje ništa, tako da prijavljuje zdrav active nalog koji još uvek ne može da proda ništa. Ako vaša prva porudžbina ne uspede sa porukom "Ova organizacija nema hosting paket, tako da još uvek ne može da hostuje sajt", to je ono što se desilo — kupite ili produžite svoj preprodajni paket i ponovo pošaljite porudžbinu. Sa modulom nije ništa u kvaru.

1. Kreirajte API ključ

U svojoj Zinn® kontrolnoj tabli otvorite stavku API ključevi i kreirajte ključ sa tačno ovih jedanaest dozvoła:

| Dozvolјa | Zašto je potrebna | | -------------------- | ----------------------------------------------------------- | | org.create | Otvorite Zinn® nalog vašeg klijenta prilikom njihove prve porudžbine. | | org.read | Čitajte naloge vaših klijenata. | | sites.create | Obezbedite sajt. | | sites.view | Čitajte uslugu i njenu iskorišćenost. | | sites.delete | Okončajte uslugu. | | reseller.view | Izlistajte ono što ste prodali i pročitajte disk i protok. | | reseller.provision | Suspendujte, pustite u rad, prijavite klijenta, podesite mu paket i promenite ga. | | billing.view | Pročitajte koliko bi nadogradnja koštala pre nego što je izvršite. | | sites.manage | Očistite keš memoriju i napravite rezervnu kopiju pomoću dugmadi. | | sites.panel_access | Promenite lozinku WordPress administratora. | | hosting.php.manage | Promenite verziju PHP-a prilikom nadogradnje ili smanjenja verzije. |

⛔ Nemojte dodeljivati dozvolu reseller.manage. Ključ nalepljen u panel za naplatu treba da bude u stanju da blokira klijenta zbog neplaćanja i da ga prijavi. On ne treba da bude u stanju da čita i prepisuje akreditive vašeg sopstvenog platnog prolaza. reseller.provision postoji da ne biste morali da dodeljujete veću dozvolu. ⛔ org.create nije opcionalna. Bez nje modul može da čita vaše naloge, ali ne može da otvori novi, pa testiranje veze prolazi, a prva porudžbina vraća odgovor 403. ⛔⛔ Dodatno odobrite celu tabelu i imajte na umu da testiranje veze ne može da vam kaže ako to niste uradili. Ono čita vaš program preprodavca i ne obezbeđuje ništa, tako da je zeleno za ključu kojem nedostaje bilo koja od ovih dozvola. Ono što umesto toga dobijate jeste greška 403 za onu operaciju koju pokriva nedostajuća dozvola, nekoliko meseci kasnije, od nekog kupca.

2. Instalirajte modul

1. Preuzmite modul i raspakujte ga.
2. Otpremite direktorijum zinn u vašu WHMCS instalaciju tako da fajl modula dospe na putanju

modules/servers/zinn/zinn.php.

⛔ Direktorijum se mora zvati zinn. WHMCS izvodi imena funkcija modula za obezbeđivanje iz imena njegovog direktorijuma, tako da preimenovanje u zinn-whmcs ili zinndigital proizvodi modul koji WHMCS prikazuje, dozvoljava vam da ga izaberete, a zatim ga nikada ne poziva — bez ikakve greške igde. Arhiva se već raspakuje pod pravim imenom; samo ga nemojte preimenovati.

3. Dodajte server

U WHMCS-u: Konfiguracija → Sistemska podešavanja → Serveri → Dodaj novi server.

• Naziv: bilo šta, npr. Zinn Digital®
• Ime hosta: api.zinndigital.com
• Tip: Zinn Digital®
• Lozinka: vaš API ključ iz 1. koraka

⛔ Ključ se unosi u polje Lozinka, koje WHMCS čuva u šifrovanom obliku. Nemojte ga stavljati u opciju konfiguracije proizvoda — one su u običnom tekstu u bazi podataka i vidljive su svakom administratoru, a ovi akreditivi mogu da kreiraju i unište hosting vaših klijenata.

Pritisnite dugme Testiraj vezu. Ono obavlja stvarni poziv i izveštava šta je naša platforma odgovorila, umesto samo da provera da li su polja popunjena.

4. Kreirajte proizvod

Konfiguracija → Sistemska podešavanja → Proizvodi/Usluge, a zatim postavite Podešavanja modula na server koji ste upravo dodali. Polja su:

| Polje | Obavezno | Šta je to | | ---------------- | -------- | -------------------------------------------------------------------------- | | Linija proizvoda | da | Zinn® linija koju prodajete — mainstream (upravljani WordPress), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail ili reseller. | | Okruženje (Stack) | da | Ono što se gradi: wordpress (podrazumevano), woocommerce, php, static, node, one_click, headless_cms, nextcloud ili owncloud. | | Aplikacija | ne | Samo za okruženja one_click i headless_cms — koju aplikaciju treba instalirati. Navođenje aplikacije na bilo kom drugom okruženju se odbija, jer to okruženje već odlučuje šta se instalira. | | Verzija PHP-a | ne | npr. 8.3. Ostavite prazno za podrazumevanu verziju linije. Verzija koju linija ne nudi se odbija uz spisak onih koje nudi. | | Kod paketa | da | Zinn® paket koji ovaj proizvod prodaje. GET /v1/reseller/prices izlistava vaše. Porudžbina bez njega se odbija — pogledajte upozorenje u nastavku. | | Interval naplate | ne | monthly (podrazumevano) ili annual — interval na koji se fakturiše vaša veleprodajna linija za ovog klijenta. Ono što naplaćujete sopstvenom klijentu podešava se na WHMCS proizvodu i na to se ne utiče. |

⛔⛔ Kod paketa je obavezan, a porudžbina bez njega se namerno odbija. Sve do 2026-09-01 ovo polje je bilo dekorativno i ništa ga nije čitalo, pa je modul naručivao hosting koji nije nosio nikakav paket — i svaka posledica toga je prolazila tiho. Vaš veleprodajni izveštaj se gradi na osnovu aktivnih pretplata vaših klijenata, tako da nije bilo stavke za uslugu i za nju vam nije fakturisano ništa sve dok je radila; vaš klijent nije nasledio nikakve pogodnosti, tako da nikakva kvota za disk ili fajlove nije primenjena na njegov sajt; i Promena paketa nije imala šta da promeni, tako da nadogradnja koju ste prodali nije mogla da se izvrši. Sajt se uredno obezbedio i funkcionisao je savršeno sve vreme.

Modul sada umesto toga odbija porudžbinu, jer ne postoji bezbedan paket koji bi mogao da pogodi: pogađanje bi obezbedilo hosting na paketu koji niste izabrali i čiju cenu možda niste definisali, i — za razliku od odbijanja, koje vidite odmah — to bi se ispostavilo tek kada stigne obračun, ako se uopšte i pojavi.

Podesite Automatsko podešavanje na ono što vam više odgovara — modul je idempotentan u odnosu na ID WHMCS usluge, tako da ponovljeni pokušaj obezbeđivanja vraća isti sajt umesto da vam naplaćuje drugi.

Šta radi svaka WHMCS akcija

| WHMCS akcija | Šta se dešava sa naše strane | | --------------------------- | ---------------------------------------------------------------------------------------- | | Kreiranje (Create) | Kreira Zinn® nalog klijenta (ili ponovo koristi onaj koji već imaju) i obezbeđuje njihov sajt. | | Suspendovanje (Suspend) | Stavlja sajt u status blokade zbog neplaćanja. Sadržaj se čuva; ništa se ne briše. | | Uklanjanje suspenzije | Uklanja vašu blokadu. | | Okončanje (Terminate) | Zakazuje brisanje sajta uz grejs period. Datum se prikazuje u klijentskom delu. | | Ažuriranje iskorišćenosti | Osvežava disk i protok za svaku uslugu, jednom dnevno. | | Prijavite se na hosting panel | Otvara jednokratnu vezu za prijavljivanje direktno u panel vašeg klijenta. | | Promena paketa | Vrši nadogradnju ili smanjenje usluge. Premesta paket i PHP verziju ako novi proizvod navodi drugu. | | Promena lozinke | Postavlja lozinku administratorskog naloga za WordPress. Polje se ne pojavljuje na okruženjima koja nemaju takav nalog. | | Obnova | Potvrđuje da usluga i dalje postoji. Zinn® hosting je neprekidan, tako da ne postoji daljinski period koji se produžava. | | Sinhronizacija iskorišćenosti / Čišćenje keša / Kreiranje rezervne kopije | Dugmad na stranici usluge administratora. Vaš klijent dobija čišćenje keša i pravljenje rezervne kopije u svom klijentskom delu. | | Kartica usluge | Status, paket, disk, protok, eventualno zakazano brisanje i podatak ko je uveo suspenziju. | | Uvoz | Funkcija ListAccounts čita svaku stranicu, tako da uvoz ne može nečujno da se zaustavi na prvoj. |

Nadogradnje: ko kome naplaćuje

Zinn® nikada ne fakturiše vašem klijentu, ni prilikom porudžbine ni prilikom nadogradnje. Vi ih naplaćujete putem WHMCS-a; mi naplaćujemo vama, na vašem veleprodajnom izveštaju. Stoga Promena paketa premesta prava vašeg klijenta i stavku na vašem sledećem obračunu, a nijedna kartica se ne dira — WHMCS je već uzeo novac od vašeg klijenta i obračunao sopstvenu srazmeru.

Druga usluga klijenta. Na istom paketu to je još jedan sajt u okviru dozvoljenog broja sajtova tog paketa, i ništa dodatno se ne dodeljuje. Na drugom paketu se odbija: zamena aktivnog paketa bi ostavila jednu od dve usluge nefakturisanom. Ili prodajte oba na istom paketu, ili podesite klijenta kao poseban nalog klijenta u WHMCS-u.

Promena lozinke postoji samo za WordPress. Zinn® hosting nema jedinstvenu „lozinku usluge“ — vaš klijent pristupa svom panelu pomoću dugmeta za prijavljivanje — a sajt koji koristi php ili static nema nalog aplikacije čija bi se lozinka menjala. WHMCS u potpunosti sakriva ovo polje umesto da prikazuje ono koje ne može da radi.

Tri odgovora koja ne smete svesti na dva

• Uklanjanje suspenzije može vratiti odgovor sa odbijanjem. To znači da je sajt suspendovao naš

tim za zloupotrebe, a ne vi, i nijedan panel za naplatu ne može da ga odblokira. Poruka to i kaže; pokažite je svom administratoru umesto da pokušavate ponovo.

• Okončanje zakazuje brisanje, ono ga ne izvršava. Datum se vraća kao

pending_deletion_at i klijentski deo ga prikazuje. Reći kupcu da su njegovi podaci već nestali kada to nije slučaj gora je opcija nego mu ne reći ništa.

• Disk i protok mogu biti nepoznati, a nepoznato nije isto što i nula. Kada nismo mogli da

uzmemo očitanje, modul ostavlja vrednost neizmimenjenom umesto da upiše 0 — u suprotnom bi WHMCS prikazao vašem kupcu ohrabrujuću praznu traku iskorišćenosti za sajt za koji nemamo nikakvo očitanje.

Rešavanje problema

Testiranje veze prolazi, a prva porudžbina ne uspeva uz grešku dozvole. API ključ nema dozvolu org.create. Modul mora da otvori nalog klijenta pre nego što može da kreira njihov sajt.

Porudžbina ne uspeva uz poruku da organizacija nema hosting paket. Vaš paket preprodavca više nema slobodnih mesta za sajtove ili ga još uvek nemate. Pogledajte odeljak Pre nego što počnete iznad.

Porudžbina ne uspeva uz pominjanje okruženja (stack). Polje Okruženje (Stack) na proizvodu je prazno ili navodi nešto što mi ne gradimo. Postavite ga na wordpress osim ako ne prodajete nešto drugo.

Otkazivanja ne uspevaju. Uverite se da koristite verziju modula 1.0.0 ili noviju. Ranije verzije nisu slale potvrdu o brisanju i svako okončanje je bilo odbijeno, što je ostavljalo uslugu aktivnom i u procesu naplate.

Odbijanje koje navodi polje. Naše greške u validaciji navode polje i razlog u zagradama nakon poruke, npr. (php_version: 7.2 is not offered on this product line). To je korisna polovina — rečenica ispred nje je namerno generička.

Proverite svoje preuzimanje

Svaka arhiva se isporučuje preko TLS-a sa našeg sopstvenog imena hosta i nikada se ne preusmerava na host treće strane. Njen SHA-256 kontrolni zbir je odštampan pored veze za preuzimanje na stranici za preuzimanje. Uporedite ga nakon preuzimanja:

• macOS ili Linux: shasum -a 256 zinn-whmcs-1.0.0.zip
• Windows: certutil -hashfile zinn-whmcs-1.0.0.zip SHA256

Niste na WHMCS-u?

Postoji HostBill modul i PHP klijent u jednom fajlu za sve ostalo, oba besplatna i oba na istoj stranici za preuzimanje. Svaka krajnja tačka koju moduli koriste nalazi se u API referenci.