Shisni strehimin Zinn® nga WHMCS

Moduli Zinn Digital® i shndërron butonat e vetë WHMCS në veprime reale në platformën tonë. Një porosi siguron strehimin e klientit tuaj. Automatikimi i faturave të vonuara të WHMCS e pezullon atë. Shënimi i faturës si të paguar e liron atë. Anulimi planifikon fshirjen. Dhe klienti juaj merr një buton Hyni në panelin e strehimit në zonën e klientit të tij që e kyç drejtpërdrejt.

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

Para se të filloni

Ju duhen dy gjëra, dhe e dyta i zë në befasi njerëzit.

1. Një llogari rishitësi Zinn® me një program aktiv. Regjistrohuni në zinndigital.com dhe aktivizoni rishitjen.
2. Një plan rishitësi me kuotë faqesh. Faqet që porosisin klientët tuaj llogariten kundrejt planit tuaj, kështu që ju nevojitet një plan me hapësirë të lirë në të.

⚠️ Testimi i Lidhjes nuk mund t'ju tregojë nëse një porosi do të ketë sukses. Ai lexon programin tuaj dhe nuk siguron asgjë, kështu që raporton një llogari të shëndetshme active që ende nuk mund të theksojë asgjë për të shitur. Nëse porosia juaj e parë dështon me "Kjo organizatë nuk ka asnjë plan strehimi, kështu që nuk mund të strehojë ende një faqe", kjo është ajo që ka ndodhur — blini ose zgjatni planin tuaj të rishitësit dhe bëni sërish porosinë. Asgjë nuk është në rregull me modulin.

1. Krijoni çelësin e API-së

Në pultin tuaj Zinn®, hapni Çelësat e API-së dhe krijoni një me saktësisht këto njëmbëdhjetë leje:

| Leja | Pse nevojitet | | -------------------- | ----------------------------------------------------------- | | org.create | Hapni llogarinë Zinn® të klientit tuaj në porosinë e tyre të parë. | | org.read | Lexoni llogaritë e klientëve tuaj. | | sites.create | Siguroni faqen. | | sites.view | Lexoni një shërbim dhe përdorimin e tij. | | sites.delete | Mbyllni. | | reseller.view | Listoni atë që keni shitur dhe lexoni diskun dhe gjerësinë e brezit. | | reseller.provision | Pezulloni, lironi, kyçni një klient, caktoni planin e tyre dhe ndryshoni paketën e tyre. | | billing.view | Lexoni se sa do të kushtonte një përmirësim para se ta kryeni atë. | | sites.manage | Pastroni memorjen fshehëse (cache) dhe bëni një kopje rezervë nga butonat. | | sites.panel_access | Ndryshoni fjalëkalimin e administratorit të WordPress. | | hosting.php.manage | Ndryshoni versionin e PHP gjatë një përmirësimi ose uljeje. |

⛔ Mos jepni reseller.manage. Një çelës i ngjitur në një panel faturimi duhet të jetë në gjendje të mbajë një klient për mospagesë dhe t'i kyçë ata. Ai nuk duhet të mund të lexojë dhe të rishkruajë kredencialet tuaja të portës së pagesave. reseller.provision ekziston në mënyrë që të mos ju duhet të jepni atë më të madhen. ⛔ org.create nuk është opsionale. Pa të, moduli mund të lexojë llogaritë tuaja, por nuk mund të hapë një të tillë, kështu që Testimi i Lidhjes kalon dhe porosia e parë përgjigjet me 403. ⛔⛔ Jepni të gjithë tabelën dhe kini parasysh se Testimi i Lidhjes nuk mund t'ju tregojë nëse nuk e keni bërë këtë. Ai lexon programin tuaj të rishitësit dhe nuk siguron asgjë, kështu që është i gjelbër për një çelës që i mungon ndonjë prej këtyre. Ajo që merrni në vend të kësaj është një 403 në operacionin e vetëm që mbulon leja e munguar, muaj më vonë, nga një klient.

2. Instaloni modulin

1. Shkarkoni modulin dhe shpaketojeni.
2. Ngarkoni dosjen zinn në instalimin tuaj WHMCS në mënyrë që skedari i modulit të vendoset te modules/servers/zinn/zinn.php.

⛔ Dosja duhet të quhet zinn. WHMCS i nxjerr emrat e funksioneve të një moduli sigurimi nga emri i dosjes së tij, kështu që riemërtimi i tij në zinn-whmcs ose zinndigital prodhon një modul që WHMCS e liston, ju lejon ta zgjidhni dhe më pas nuk e thirr kurrë — pa asnjë gabim askund. Skedari zip tashmë shpaketojhet në emrin e duhur; thjesht mos e riemërtoni.

3. Shtoni serverin

Në WHMCS: Konfigurimi → Cilësimet e Sistemit → Serverët → Shto Server të Ri.

• Emri: çfarëdo, p.sh. Zinn Digital®
• Emri i hostit: api.zinndigital.com
• Lloji: Zinn Digital®
• Fjalëkalimi: çelësi juaj i API-së nga hapi 1

⛔ Çelësi shkon në fushën Fjalëkalimi, të cilën WHMCS 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ë dhe shkatërrojë strehimin e klientëve tuaj.

Shtypni Testo Lidhjen. Ai bën një thirrje reale dhe raporton atë që tha platforma jonë, në vend që të kontrollojë nëse fushat janë plotësuar.

4. Krijoni produktin

Konfigurimi → Cilësimet e Sistemit → Produktet/Shërbimet, pastaj vendosni Cilësimet e Modulit te serveri që sapo shtuat. Fushat janë:

| Fusha | Kërkohet | Çfarë është | | ---------------- | -------- | -------------------------------------------------------------------------- | | Linja e produktit | po | Linja Zinn® që po shitni — mainstream (WordPress i menaxhuar), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail ose reseller. | | Pakoja (Stack) | po | Çfarë ndërtohet: wordpress (parazgjedhje), woocommerce, php, static, node, one_click, headless_cms, nextcloud ose owncloud. | | Aplikacioni | jo | Vetëm për pakot one_click dhe headless_cms — cili aplikacion të instalohet. Emërtimi i njërit në çdo pako tjetër refuzohet, sepse ajo pako tashmë vendos se çfarë instalohet. | | Versioni i PHP | jo | p.sh. 8.3. Lëreni bosh për parazgjedhjen e linjës. Një version që linja nuk e ofron refuzohet me listën e atyre që ofron. | | Kodi i planit | po | Plani Zinn® që shet ky produkt. GET /v1/reseller/prices liston tuajin. Një porosii pa të refuzohet — shikoni paralajmërimin më poshtë. | | Intervali i faturimit | jo | monthly (parazgjedhje) ose annual — intervali në të cilin ngrihet linja juaaj me shumicë për këtë klient. Ajo që i faturoni klientit tuaj është vendosur në produktin WHMCS dhe mbetet e pandryshuar. |

⛔⛔ Kodi i planit kërkohet dhe një porosi pa të refuzohet qëllimisht. Deri më 2026-09-01 fusha ishte dekorative dhe asgjë nuk e lexonte atë, kështu që moduli porosiste strehim që nuk mbante asnjë plan fare — dhe çdo pasojë e kësaj ishte e heshtur. Deklarata juaj me shumicë ndërtohet nga abonimet e drejtpërdrejta të klientëve tuaj, kështu që nuk kishte asnjë rresht për shërbimin dhe nuk ju u faturua asgjë për aq kohë sa ai funksiononte; klienti juaj nuk trashëgoi asnjë kuotë, kështu që asnjë kuotë disku ose skedari nuk iu aplikua faqes së tyre; dhe Ndrysho Paketën nuk kishte asgjë për të ndryshuar, kështu që një përmirësim që keni shitur nuk mund të kryhej. Faqja u sigurua dhe u shërbeu në mënyrë të përkryer gjatë gjithë kohës.

Moduli tani e refuzon porosinë në vend të kësaj, sepse nuk ka asnjë plan të sigurt për të marrë me mend: një supozim do të siguronte strehim në një plan që ju nuk e zgjodhët dhe mund të mos e keni çmuar, dhe — ndryshe nga një refuzim, të cilin e lexoni menjëherë — ai do të shfaqej vetëm kur të mbërrinte një deklaratë, nëse shfaqej ndonjëherë.

Vendosni Konfigurimin Automatik sipas dëshirës suaj — moduli është idempotent në ID-në e shërbimit WHMCS, kështu që një sigurim i rivendosur kthen të njëjtën faqe në vend që t'ju faturojë për një të dytë.

Çfarë bën secili veprim i WHMCS

| Veprimi i WHMCS | Çfarë ndodh në anën tonë | | --------------------------- | ---------------------------------------------------------------------------------------- | | Krijo (Create) | Krijon llogarinë Zinn® të klientit (ose ripërdor atë që ata tashmë e kanë) dhe siguron faqen e tyre. | | Pezullo (Suspend) | Vendos faqen në një mbajtje për mospagesë. Përmbajtja ruhet; asgjë nuk fshihet. | | Zhblloko (Unsuspend) | Liron mbajtjen tuaj. | | Mbyll (Terminate) | Planifikon fshirjen e faqes, me një periudhë hirafati. Data shfaqet në zonën e klientit. | | Përditësimi i përdorimit | Përditëson diskun dhe gjerësinë e brezit në çdo shërbim, një herë në ditë. | | Hyni në panelin e strehimit | Hap një lidhje hyrjeje njëpërdorimëshe drejtpërdrejt në panelin e klientit tuaj. | | Ndrysho Paketën | Përmirëson ose ul shërbimin. Lëviz paketën dhe versionin e PHP nëse produkti i ri emërton një të tillë. | | Ndrysho Fjalëkalimin | Vendos fjalëkalimin e administratorit të WordPress. Kutia nuk shfaqet në pakot që nuk kanë një llogari të tillë. | | Rinovo | Konfirmon se shërbimi ekziston ende. Strehimi Zinn® është i vazhdueshëm, kështu që nuk ka asnjë afat të largët për t'u zgjatur. | | Sinkronizo përdorimin / Pastro memorjen fshehëse / Bëj kopje rezervë | Butonat në faqen e shërbimit të administratorit. Klienti juaj merr Pastro memorjen fshehëse (Cache) dhe Bëj kopje rezervë në zonën e tij të klientit. | | Skeda e shërbimit | Statusi, plani, disku, gjerësia e brezit, çdo fshirje e planifikuar dhe kush vendosi një pezullim. | | Importo | ListAccounts lexon çdo faqe, kështu që një import nuk mund të ndalet fshehurazi te e para. |

Përmirësimet: kush e faturon kë

Klienti juaj nuk faturohet kurrë nga Zinn®, në një porosi ose në një përmirësim. Ju i faturoni ata përmes WHMCS; ne ju faturojmë juve, në deklaratën tuaj me shumicë. Pra, Ndryshimi i Paketës lëviz të drejtat e klientit tuaj dhe rreshtin në deklaratën tuaj të radhës, dhe nuk prek asnjë kartë — WHMCS tashmë ka marrë paratë e klientit tuaj dhe ka llogaritur përpjesëtimin e tij.

Shërbimi i dytë i një klienti. Në të njëjtin plan është një faqe tjetër nën kuotën e faqeve të atij plani dhe asgjë më shumë nuk jepet. Në një plan të ndryshëm refuzohet: zëvendësimi i planit të drejtpërdrejtë do të linte njërin nga dy shërbimet të pafaturuar. Ose shitni të dyja në të njëjtin plan, ose vendosni klientin si një regjistrim klienti të veçantë në WHMCS.

Ndryshimi i Fjalëkalimit ekziston vetëm për WordPress. Strehimi Zinn® nuk ka asnjë "fjalëkalim shërbimi" të vetëm — klienti juaj arrin në panelin e tij me butonin e hyrjes — dhe një faqe php ose static nuk ka llogari aplikacioni për të ndryshuar. WHMCS e fsheh kutinë plotësisht në vend që të shfaqë një që nuk mund të funksionojë.

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

• Zhbllokimi (Unsuspend) mund të përgjigjet me një refuzim. Kjo do të thotë se faqja u pezullua nga ekipi ynë i abuzimit, jo nga ju, dhe asnjë panel faturimi nuk mund ta lirojë atë. Mesazhi e thotë këtë; tregojeni atë administratorit tuaj në vend që ta provoni përsëri.
• Mbyllja (Terminate) planifikon një fshirje, ajo nuk kryen një të tillë. Data kthehet si pending_deletion_at dhe zona e klientit e shfaq atë. T'i tregosh një klienti se të dhënat e tij tashmë janë zhdukur kur nuk janë, është më keq sesa të mos i tregosh asgjë.
• Disku dhe gjerësia e brezit mund të jenë të panjohura, dhe e panjohura nuk është zero. Kur nuk mund të bënim një lexim, moduli e lënë shifrën vetëm në vend që të shkruajë 0 — përndryshe WHMCS do t'i tregonte klientit tuaj një shirit përdorimi bosh qetësues për një faqe nga e cila nuk kemi asnjë lexim.

Zgjidhja e problemeve

Testimi i Lidhjes kalon dhe porosia e parë dështon me një gabim lejeje. Çelësit të API-së i mungon org.create. Moduli duhet të hapë llogarinë e klientit para se të mund të krijojë faqen e tyre.

Një porosi dështon duke thënë se organizata nuk ka asnjë plan strehimi. Plani juaj i rishitësit nuk ka më kuotë faqesh, ose ju nuk mbani ende një të tillë. Shikoni Para se të filloni më lart.

Një porosi dështon duke përmendur një pako (stack). Fusha Pakoja (Stack) në produkt është bosh ose emërton diçka që ne nuk e ndërtojmë. Vendoseni në wordpress nëse nuk po shitni diçka tjetër.

Anulimet po dështojnë. Sigurohuni që jeni në versionin e modulit 1.0.0 ose më vonë. Ndërtimet e mëparshme nuk dërguan asnjë konfirmim fshirjeje dhe çdo mbyllje u refuzua, gjë që la shërbimin në funksionim dhe duke u faturuar.

Një refuzim që emërton një fushë.

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

Verifikoni shkarkimin tuaj

Çdo arkiv shërbehet përmes TLS nga emri ynë i hostit dhe nuk ridrejtohet kurrë te një host i palës së tretë. Kontrolli i tij SHA-256 shtypet pranë lidhjes së shkarkimit në faqen e shkarkimeve. Krahasojeni 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 jeni në WHMCS?

Ekziston një modul HostBill dhe një klient PHP me një skedar të vetëm për çdo gjë tjetër, të dyja falas dhe të dyja në të njëjtën faqe shkarkimesh. Çdo pikë përfundimtare që përdorin modulet është në referencën e API-së.