Shisni hostim Zinn® nga WHMCS

Moduli Zinn Digital® i shndërron butonat e vetë WHMCS-it në veprime reale në platformën tonë. Një porosi ofron shërbimin e hosting-ut për klientin tuaj. Automatizimi i faturave të vonuara të WHMCS-it e pezullon atë. Shënimi i faturës si e paguar e çliron atë. Anulimi planifikon fshirjen. Dhe klienti juaj merr një buton Log in to hosting panel në zonën e tij të klientit që e identifikon menjëherë brenda.

Është falas, i licencuar sipas GPL-2.0-or-later, dhe nuk ka asnjë rrugë të privilegjuar në platformën tonë: çdo thirrje që bën është një endpoint i dokumentuar që mund ta bëni vetë me çelësin tuaj API.

Përpara se të filloni

Ju nevojiten dy gjëra, dhe e dyta shpesh i kap njerëzit në befasi.

1. Një llogari rishitësi Zinn® me një program aktiv. Regjistrohuni në

zinndigital.com dhe aktivizoni rishitjen.

2. Një plan rishitësi me hapësirë të lejuar për faqe. Faqet që porosisin klientët tuaj zbriten nga plani

juaj, kështu që ju duhet një plan me vend të lirë.

⚠️ Test Connection nuk mund t'ju tregojë nëse një porosi do të ketë sukses. Ai lexon programin tuaj dhe nuk ofron asnjë shërbim, prandaj raporton një llogari të shëndetshme active që ende nuk mund të shesë asgjë. Nëse porosia juaj e parë dështon me "This organization has no hosting plan, so it cannot host a site yet", kjo është ajo që ka ndodhur — blini ose zgjeroni planin tuaj të rishitësit dhe bëni porosinë përsëri. Moduli nuk ka asnjë problem.

1. Krijoni çelësin API

Në panelin tuaj kryesor të Zinn®, hapni API keys dhe krijoni një me saktësisht këto njëmbëdhjetë leje:

⛔ Mos jepni lejen reseller.manage. Një çelës i vendosur në një panel faturimi duhet të jetë në gjendje të pezullojë një klient për mospagesë dhe ta identifikojë atë. Ai nuk duhet të jetë në gjendje të lexojë dhe të rishkruajë kredencialet tuaja të portës së pagesave. reseller.provision ekziston në mënyrë që të mos keni nevojë të jepni lejen më të madhe. ⛔ org.create nuk është opsionale. Pa të, moduli mund të lexojë llogaritë tuaja, por nuk mund të hapë një të tillë, kështu që Test Connection kalon me sukses dhe porosia e parë përgjigjet me 403. ⛔⛔ Jepni të gjitha lejet e tabelës, dhe vini re se Test Connection nuk mund t'ju tregojë nëse nuk e keni bërë këtë. Ai lexon programin tuaj të rishitësit dhe nuk ofron asnjë shërbim, kështu që del i gjelbër edhe për një çelës të cilit i mungon cilado nga këto. Ajo që merrni në vend të kësaj është një gabim 403 në operacionin e vetëm që mbulon leja që mungon, muaj më vonë, nga një klient.

2. Instaloni modulin

1. Shkarkoni modulin dhe çipaketojeni atë.
2. Ngarkoni direktorinë zinn brenda instalimit tuaj të WHMCS-it në mënyrë që skedari i modulit të vendoset te

modules/servers/zinn/zinn.php.

⛔ Direktoria duhet të quhet zinn. WHMCS-i i nxjerr emrat e funksioneve të një moduli shërbimesh nga emri i direktorisë së tij, kështu që riemërtimi i saj në zinn-whmcs ose zinndigital prodhon një modul të cilin WHMCS-i e liston, ju lejon ta zgjidhni, dhe më pas nuk e thërret kurrë — pa shfaqur asnjë gabim askund. Skedari zip tashmë çipaketohet me emrin e duhur; thjesht mos e riemërtoni.

3. Shtoni serverin

Në WHMCS: Configuration → System Settings → Servers → Add New Server.

• Name: çfarëdo, p.sh. Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: çelësi juaj API nga hapi 1

⛔ Çelësi vendoset në fushën Password, të cilën WHMCS-i e ruan të enkriptuar. Mos e vendosni atë në një opsion konfigurimi produkti — ato janë tekst i thjeshtë në bazën e të dhënave dhe të dukshme për çdo administrator, dhe ky kredencial mund të krijojë e të shkatërrojë hosting-un e klientëve tuaj.

Shtypni Test Connection. Ai kryen një thirrje reale dhe raporton atë që tha platforma jonë, në vend që thjesht të kontrollojë nëse fushat janë të plotësuara.

4. Krijoni produktin

Configuration → System Settings → Products/Services, më pas caktoni Module Settings te serveri që sapo shtuat. Fushat janë:

⛔⛔ Kodi i planit (Plan code) është i detyrueshëm, dhe një porosi pa të refuzohet me qëllim. Deri më 2026-09-01 fusha ishte thjesht dekorative dhe asgjë nuk e lexonte, kështu që moduli porosiste hosting që nuk mbante asnjë plan fare — dhe çdo pasojë e kësaj kalonte në heshtje. Pasqyra juaj e faturimit me shumicë ndërtohet nga abonimet aktive të klientëve tuaj, kështu që nuk kishte asnjë zë për shërbimin dhe ju nuk faturoheshit me asgjë për aq kohë sa ai funksiononte; klienti juaj nuk trashëgonte asnjë limit, kështu që asnjë kuotë disku apo skedarësh nuk zbatohej në faqen e tyre; dhe Change Package nuk kishte asgjë për të ndryshuar, kështu që një ngritje niveli që kishit shitur nuk mund të kryhej. Faqja u ofrua dhe funksionoi në mënyrë të përsosur gjatë gjithë kohës.

Moduli tani e refuzon porosinë në vend të kësaj, sepse nuk ka asnjë plan të sigurt që mund të hamendësojë: një hamendësim do të ofronte shërbimin e hosting-ut në një plan që nuk e keni zgjedhur dhe mund të mos e keni çmuar, dhe — ndryshe nga një refuzim, të cilin e lexoni menjëherë — kjo do të dilte në dritë vetëm kur të vinte një pasqyrë faturimi, nëse do të dilte.

Caktoni Auto Setup në cilëndo që preferoni — moduli është idempotent me ID-në e shërbimit në WHMCS, kështu që një provë e përsëritur e shërbimit kthen të njëjtën faqe në vend që t'ju faturojë për një të dytë.

Çfarë bën secili veprim i WHMCS-it

Përmirësimet: kush e faturon kë

Klienti juaj nuk faturohet kurrë nga Zinn®, as gjatë një porosie dhe as gjatë një përmirësimi. Ju i faturoni ata përmes WHMCS-it; ne ju faturojmë juve, në pasqyrën tuaj të faturimit me shumicë. Kështu që një Change Package zhvendos të drejtat e klientit tuaj dhe rreshtin në pasqyrën tuaj të ardhshme, dhe nuk prek asnjë kartë — WHMCS-i tashmë i ka marrë paratë e klientit tuaj dhe ka llogaritur pjesëtimin proporcional (proration) të vet.

Shërbimi i dytë i një klienti. Në të njëjtin plan, është thjesht një faqe tjetër brenda hapësirës së lejuar të vetë atij plani, dhe asgjë më tej nuk jepet. Në një plan të ndryshëm, kjo refuzohet: zëvendësimi i planit aktiv do të linte një nga dy shërbimet të pafaturuar. Ose shitini të dyja në të njëjtin plan, ose regjistrojeni klientin si një profil klienti më vete në WHMCS.

Change Password ekziston vetëm për WordPress. Hosting-u i Zinn® nuk ka një "fjalëkalim shërbimi" të vetëm — klienti juaj hyn në panelin e tij me butonin e identifikimit — dhe një faqe php ose static nuk ka një llogari aplikacioni për t'u ndryshuar. WHMCS-i e fsheh fushën plotësisht në vend që të shfaqë një fushë që nuk mund të funksionojë.

Tri përgjigje që nuk duhet t'i thjeshtoni në dy

• Unsuspend mund të përgjigjet me një refuzim. Kjo do të thotë se faqja u pezullua nga ekipi ynë

i abuzimeve, jo nga ju, dhe asnjë panel faturimi nuk mund ta çlirojë atë. Mesazhi e thotë këtë; tregojani atë administratorit tuaj në vend që të provoni përsëri.

• Terminate planifikon një fshirje, nuk e kryen atë menjëherë. Data kthehet si

pending_deletion_at dhe zona e klientit e shfaq atë. T'i thuash klientit se të dhënat e tij tashmë janë fshirë kur nuk janë fshirë është më keq sesa të mos i thuash asgjë.

• Disku dhe bandwidth-i mund të jenë të panjohur, dhe e panjohur nuk do të thotë zero. Kur nuk mundëm të merrnim

një matje, moduli e lë shifrën të paprekur në vend që të shkruajë 0 — përndryshe WHMCS-i do t'i shfaqte klientit tuaj një shirit përdorimi bosh qetësues për një faqe nga e cila nuk kemi asnjë matje.

Zgjidhja e problemeve

Test Connection kalon me sukses dhe porosia e parë dështon me një gabim lejeje. Çelësit API i mungon org.create. Moduli duhet të hapë llogarinë e klientit përpara se të mund të krijojë faqen e tyre.

Një porosi dështon duke thënë se organizata nuk ka plan hosting-u. Planit tuaj të rishitësit nuk i ka mbetur hapësirë e lejuar për faqe, ose nuk keni ende një të tillë. Shikoni Përpara se të filloni më lart.

Një porosi dështon duke përmendur një stack. Fusha Stack te produkti është bosh ose përmend diçka që ne nuk e ndërtojmë. Caktojeni në wordpress përveç nëse po shisni diçka tjetër.

Anulimet po dështojnë. Sigurohuni që jeni në versionin 1.0.0 ose më të ri të modulit. Versionet e mëparshme nuk dërgonin konfirmim fshirjeje dhe çdo ndërprerje refuzohej, gjë që e linte shërbimin aktiv dhe në faturim.

Një refuzim që përmend një fushë. Gabimet tona të vlefshmërisë tregojnë fushën dhe arsyen në kllapa pas mesazhit, p.sh. (php_version: 7.2 is not offered on this product line). Kjo është gjysma vepruese — fjalia para saj është qëllimisht e përgjithshme.

Verifikoni shkarkimin tuaj

Çdo arkiv shërbehet përmes TLS-it nga vetë hostname-i ynë dhe nuk ridrejtohet kurrë te një server i palëve të treta. Vlera e tij përmbledhëse SHA-256 është e shfaqur pranë lidhjes së shkarkimit në faqen e shkarkimeve. Krahasoni atë pas shkarkimit:

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

Nuk përdorni WHMCS?

Ekziston një modul HostBill dhe një klient PHP me një skedar të vetëm për çdo sistem tjetër, të dy falas dhe të dy në të njëjtën faqe shkarkimesh. Çdo endpoint që përdorin modulet gjendet në referencën e API-së.