Ilé ìmọ̀
Ta aṣọ ìpèsè Zinn® jáde láti WHMCS
Fi module ìpèsè Zinn Digital ọfẹ sori WHMCS: bọ́tìnnì API ati àwọn àṣẹ meje ti o nilo, ibi ti abala module yẹ ki o lọ ati idi ti orukọ rẹ ṣe ṣe pataki, àwọn aaye ọja, ati ohun ti bọ́tìnnì WHMCS kọọkan ṣe gangan.
Modulu Zinn Digital® yipada awọn bọtini WHMCS sọ di iṣe gidi lori pẹpẹ wa. Aṣẹ kan n pese alejò (hosting) alabara rẹ. Aifọwọyi iwe-owo ti o ti kọja akoko ti WHMCS fi n da a duro. Titọ iwe-owo na bii eyiti a san n tu silẹ. Ifagile n ṣeto piparẹ na. Ati pe alabara rẹ gba bọtini Wọle si nronu alejò kan ni agbegbe alabara wọn eyiti o wọle taara fun wọn.
O jẹ ọfẹ, o ni iwe-ašẹ labẹ GPL-2.0-or-later, ko si si ọna pataki kan si pẹpẹ wa: gbogbo ipe ti o ṣe jẹ ipari ti a kọ silẹ eyiti o le ṣe fun ara rẹ pẹlu bọtini API tirẹ.
Ṣaaju ki o to bẹrẹ
O nilo nkan meji, eyiti ekeji si n da awọn eniyan ru.
- Akọọlẹ alagbata Zinn® kan pẹlu eto ti nṣiṣẹ lọwọ. Forukọsilẹ ni zinndigital.com ki o tan tita alagbata.
- Eto alagbata kan pẹlu aye aaye intanẹẹti (site allowance). Awọn aaye ti awọn alabara rẹ paṣẹ nka lodi si eto tirẹ, nitorina o nilo ọkan ti o ni aye ninu rẹ.
⚠️ Idanwo Asopọ kii le sọ fun ọ boya aṣẹ kan yoo yọrisi. O ka eto rẹ ko si pese ohunkohun, nitorina o royin akọọlẹ
activekan ti o ni ilera ti ko le ta ohunkohun sibẹsibẹ. Ti aṣẹ akọkọ rẹ ba kuna pẹlu "Ajo yii ko ni eto alejò kankan, nitorina ko le ṣalejo aaye kan sibẹsibẹ", iyẹn ni ohun ti o ṣẹlẹ — ra tabi fa eto alagbata rẹ gun ki o paṣẹ lẹẹkan si. Ko si nkan ti ko tọ si pẹlu modulu naa.
1. Ṣẹda bọtini API
Ninu daṣibọọdu Zinn® rẹ, ṣii Awọn bọtini API ki o ṣẹda ọkan pẹlu awọn aṣẹ mọkanla wọnyi pato:
| Àṣẹ | Idi ti o fi nilo | | -------------------- | ----------------------------------------------------------- | | org.create | Ṣii akọọlẹ Zinn® alabara rẹ lori aṣẹ akọkọ wọn. | | org.read | Ka awọn akọọlẹ alabara rẹ. | | sites.create | Pese aaye intanẹẹti naa. | | sites.view | Ka iṣẹ kan ati lilo rẹ. | | sites.delete | Fagile. | | reseller.view | Ṣe akojọ ohun ti o ti ta, ki o si ka disiki ati iwọn bandi. | | reseller.provision | Da duro, tu silẹ, wọ alabara wọle, ṣeto eto wọn ki o yipada idii wọn. | | billing.view | Ka ohun ti igbega soke yoo na ṣaaju ṣiṣe rẹ. | | sites.manage | Pa kaṣe rẹ (cache) rẹ mọ ki o si ṣe afẹyinti (backup) lati awọn bọtini. | | sites.panel_access | Yipada ọrọ igbaniwọle olùṣakoso WordPress. | | hosting.php.manage | Yi ẹya PHP pada lori igbega soke tabi isalẹ. |
⛔ Maṣe funni ni
reseller.manage. Bọtini kan ti a lẹ mọ ninu nronu iwe-owo yẹ ki o ni anfani lati dimu alabara fun aisan sanwo ki o wọle fun wọn. Ko yẹ ki o ni anfani lati ka ki o kọ awọn iwe-ẹri ẹnu-ọna sisanwo tirẹ.reseller.provisionwa ki o má ba ni lati fun ni eyiti o tobi julọ. ⛔org.createkii ṣe aṣayan. Laisi rẹ modulu le ka awọn akọọlẹ rẹ ṣugbọn ko le ṣii ọkan, nitorina Idanwo Asopọ kọja ati aṣẹ akọkọ dahun403. ⛔⛔ Funni ni tabili lapapọ, ki o si ṣe akiyesi pe Idanwo Asopọ kii le sọ fun ọ ti o ko ba ti ṣe bẹ. O ka eto alagbata rẹ ko si pese ohun kan, nitorina o jẹ alawọ ewe fun bọtini ti o padanu eyikeyi ninu iwọnyi. Ohun ti o gba dipo jẹ403lori iṣẹ kan ṣoṣo ti aṣẹ ti o padanu bo, awọn oṣu nigbamii, lati ọdọ alabara kan.
2. Fi modulu naa sori ẹrọ
- Gba modulu naa silẹ ki o yọ aṣọ idalẹnu (unzip) rẹ.
- Agbejade ilana
zinnsori fifi sori ẹrọ WHMCS rẹ ki faili modulu na ba le de simodules/servers/zinn/zinn.php.
⛔ Ilana naa gbọdọ jẹ pe
zinn. WHMCS n fa awọn orukọ iṣẹ ti modulu ipese lati inu orukọ ilana rẹ, nitorina sísọ dizinn-whmcstabizinndigitaln mu modulu kanjade ti WHMCS ṣe akojọ rẹ, jẹ ki o yan, lẹhinna ko pe e lailai — laisi aṣiṣe kankan nibikibi. Zip naa ti tu silẹ tẹlẹ si orukọ tito; kan maṣe fun ni orukọ miiran.
3. Fi súpà (server) naa kun
Ninu WHMCS: Atunto → Awọn Eto Eto → Awọn Súpà → Fi Súpà Titun Kun.
- Orukọ: ohunkohun, apẹẹrẹ
Zinn Digital® - Orukọ Súpà:
api.zinndigital.com - Iru:
Zinn Digital® - Ọrọ igbaniwọle: bọtini API rẹ lati igbesẹ 1
⛔ Bọtini naa lọ sinu aaye Ọrọ igbaniwọle, eyiti WHMCS n tọju pẹlu igbekun koodu (encrypted). Maṣe fi si inu aṣayan atunto ọja — awọn wọnyẹn jẹ ọrọ pẹtẹlẹ ninu ibi ipamọ data ati pe o han si gbogbo olùṣakoso, ati pe iwe-ẹri yii le ṣẹda ati run alejò awọn alabara rẹ.
Tẹ Idanwo Asopọ. O ṣe ipe gidi kan o si royin ohun ti pẹpẹ wa sọ, dipo ṣayẹwo pe awọn aaye ti kun.
4. Ṣẹda ọja naa
Atunto → Awọn Eto Eto → Awọn Ọja/Awọn iṣẹ, lẹhinna ṣeto Awọn Eto Modulu si súpà ti o ṣafikun bayi. Awọn aaye ni:
| Aaye | Ti nilo | Kini o jẹ | | ---------------- | -------- | -------------------------------------------------------------------------- | | Ila ọja | bẹẹni | Ila Zinn® ti o n ta — mainstream (WordPress ti a nṣakoso), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail tabi reseller. | | Ipile (Stack) | bẹẹni | Ohun ti a kọ: wordpress (àiyọ̀sílẹ̀), woocommerce, php, static, node, one_click, headless_cms, nextcloud tabi owncloud. | | Ohun elo | rara | Nikan fun awọn ipile one_click ati headless_cms — iru ohun elo wo ni lati fi sori ẹrọ. Sísọ ọkan lori eyikeyi ipile miiran ni a kọ, nitorina ipile yẹn ti pinnu tẹlẹ ohun ti a fi sori ẹrọ. | | Ẹya PHP | rara | fun apẹẹrẹ 8.3. Fi silẹ ni ṣofo fun aiyọ̀sílẹ̀ ila naa. Ẹya ti ila na ko funni ni a kọ pẹlu atokọ ti awọn ti o ṣe. | | Koodu eto | bẹẹni | Eto Zinn® ti ọja yii n ta. GET /v1/reseller/prices ṣe akojọ awọn ti tirẹ. Aṣẹ kan laisi rẹ ni a kọ — wo ikilọ ni isalẹ. | | Aarin iwe-owo | rara | monthly (aiyọ̀sílẹ̀) tabi annual — aarin ti o n gba owo ila osunwon tirẹ fun alabara yii. Ohun ti o gba lati ọdọ alabara tirẹ ni a ṣeto sori ọja WHMCS ko si ni ipa. |
⛔⛔ Koodu eto jẹ dandan, ati aṣẹ laisi ọkan ni a kọ mọọmọ. Titi di 2026-09-01 aaye naa jẹ ohun ọṣọ ko si si ohun ti o ka a, nitorina modulu na paṣẹ alejò ti ko gbe eto kankan rara — ati pe gbogbo abajade iyẹn jẹ idakẹjẹ. Gbólóhùn osunwon rẹ ni a kọ lati inu awọn alabapin ifiwe yẹn ti awọn alabara rẹ, nitorina ko si ila fun iṣẹ na ati pe a ko gba ọ ni owo kankan niwọn igba ti o ti nṣiṣẹ; alabara rẹ ko jogun awọn iyọọda kankan, nitorina ko si kuota disiki tabi faili ti a lo si aaye wọn; ati pe Yi Idiipada pada ko ni nkan lati yipada, nitorina igbega soke ti o ta ko le ṣee ṣe. Aaye naa pese ati sin ni pipe ni gbogbo akoko naa.
Modulu na ti kọ aṣẹ na nipa dipo bẹẹ, nitorina ko si eto ailewu fun u lati ro: arojinle yoo pese alejò lori eto kan ti o ko yan ti o si le ma ni idiyele, ati pe — ko dabi kiko, eyiti o ka lẹsẹkẹsẹ — yoo jade nikan nigbati alaye ba de, ti o ba de rara.
Ṣeto Ipese Aifọwọyi si eyikeyi ti o fẹ — modulu na jẹ bakanna lori idanimọ iṣẹ WHMCS, nitorina ipese ti a tun gbiyanju da aaye kanna pada dipo gbigba owo lọwọ rẹ fun ekeji.
Ohun ti iṣẹ WHMCS kọọkan n ṣe
| Iṣẹ WHMCS | Ohun ti o ṣẹlẹ ni apa wa | | --------------------------- | ---------------------------------------------------------------------------------------- | | Ṣẹda | Ṣẹda akọọlẹ Zinn® alabara rẹ (tabi tun lo eyiti wọn ti ni tẹlẹ) o si pese aaye wọn. | | Duro duro | Fi aaye naa sori idaduro ti kii ṣe sisanwo. A da akoonu duro; a ko pa ohunkohun rẹ. | | Tu silẹ | Tu idaduro tirẹ silẹ. | | Fagile | Ṣeto piparẹ aaye naa, pẹlu akoko ore-ọfẹ. Ọjọ naa han ni agbegbe alabara. | | Imudojuiwọn lilo | Tun disiki ati iwọn bandi sọtun lori gbogbo iṣẹ, lẹẹkan lojoojumọ. | | Wọle si nronu alejò | Ṣii ọna asopọ wọle-wọle ẹẹkan kan, lilo kan taara sinu nronu alabara rẹ. | | Yi Idiipada pada | Gbe soke tabi sisale iṣẹ na. Gbe idiii na, ati ẹya PHP ti ọja titun ba lorukọ ọkan. | | Yi Ọrọ igbaniwọle pada | Ṣeto ọrọ igbaniwọle olùṣakoso WordPress. Apoti na ko han lori awọn ipile ti ko ni iru akọọlẹ bẹẹ. | | Tunṣe | Jẹrisi pe iṣẹ na wa sibẹsibẹ. Alejò Zinn® jẹ eyiti o tẹsiwaju, nitorina ko si akoko jijinna lati gbooro. | | Mu Lilo pọ / Pa Kaṣe Mọ / Ṣe Afẹyinti | Awọn bọtini lori oju-iwe iṣẹ olùṣakoso. Alabara rẹ gba Pa Kaṣe Mọ ati Ṣe Afẹyinti ni agbegbe alabara wọn. | | Taabu iṣẹ | Ipo, eto, disiki, iwọn bandi, eyikeyi piparẹ ti a ṣeto, ati tani ti o gbe idaduro kan kalẹ. | | Gbe wọle | ListAccounts ka gbogbo oju-iwe, nitorina gbigbe wọle ko le da duro lẹẹkọọkan ni akọkọ. |
Awọn igbega soke: tani n gba owo lọwọ tani
A ko gba alabara rẹ ni owo lailai nipasẹ Zinn®, lori aṣẹ kan tabi lori igbega soke. O gba wọn ni owo nipasẹ WHMCS; a gba ọ ni owo, lori gbólóhùn osunwon rẹ. Nitorina Yi Idiipada pada gbe awọn ẹtọ alabara rẹ ati ila lori gbólóhùn rẹ ti n bọ, ko si fi kaadi kan kan — WHMCS ti gba owo alabara rẹ tẹlẹ ti o si ti ṣe iṣiro ipin tirẹ.
Iṣẹ keji ti alabara kan. Lori eto kanna o jẹ aaye miiran labẹ aaye alaye eto yẹn, ko si si ohun miiran ti a funni. Lori eto oriṣiriṣi a kọ: rirọpo eto ti nṣiṣẹ yoo fi ọkan ninu awọn iṣẹ meji silẹ laisi owo. Boya ta mejeeji lori eto kanna, tabi ṣeto alabara naa bi akọọlẹ alabara lọtọ ni WHMCS.
Yi Ọrọ igbaniwọle pada wa nikan fun WordPress. Alejò Zinn® ko ni "ọrọ igbaniwọle iṣẹ" kan soso — alabara rẹ de nronu wọn pẹlu bọtini wọle-wọle — ati aaye php tabi static ko ni akọọlẹ ohun elo lati yipada. WHMCS fi apoti na pamọ patapata dipo fifihan ọkan ti ko le ṣiṣẹ.
Awọn idahun mẹta ti o ko gbọdọ ṣe pẹlẹbẹ si meji
- Tu silẹ le dahun pẹlu kiko. Iyẹn tumọ si pe aaye naa ni a duro nipasẹ ẹgbẹ iwa-aisi wa, kii ṣe nipasẹ rẹ, ko si nronu iwe-owo ti o le tu silẹ. Ifiranṣẹ naa sọ bẹ; fi han olùṣakoso rẹ dipo tun gbiyanju.
- Fagile ṣeto piparẹ, ko ṣe e. Ọjọ naa pada wa bi
pending_deletion_atati pe agbegbe alabara fihan. Sísọ fun alabara pe data wọn ti lọ tẹlẹ nigbati kii ṣe bẹ buru ju sísọ ohunkohun fun wọn lọ. - Disiki ati iwọn bandi le jẹ aimọ, ati pe aimọ kii ṣe odo. Nigbati a ko le mu kika kan modulu na fi nọmba naa silẹ dipo kikọ
0— bibẹẹkọ WHMCS yoo fi igi lilo ofo ti o tutu han alabara rẹ fun aaye kan ti a ko ni kika lati ọdọ rẹ.
Laasigbotitusitẹ
Idanwo Asopọ kọja ati aṣẹ akọkọ kuna pẹlu aṣiṣe aṣẹ. Bọtini API naa ti padanu org.create. Modulu na ni lati ṣii akọọlẹ alabara ṣaaju ki o to le ṣẹda aaye wọn.
Aṣẹ kan kuna ti o sọ pe ajo ko ni eto alejò. Eto alagbata rẹ ko ni aye aaye ti o ku, tabi o ko ni ọkan sibẹsibẹ. Wo Ṣaaju ki o to bẹrẹ loke.
Aṣẹ kan kuna ti o n darukọ ipile kan. Aaye Ipile lori ọja na ṣofo tabi lorukọ ohun kan ti a ko kọ. Ṣeto si wordpress ayafi ti o ba n ta ohun miiran.
Awọn fagile n kuna. Rii daju pe o wa lori ẹya modulu 1.0.0 tabi nigbamii. Awọn ikole iṣaaju ko ran ikausi piparẹ kankan ati pe gbogbo iparẹ ni a kọ, eyiti o fi iṣẹ na silẹ ni ṣiṣiṣẹ ati gbigba owo.
Kiko kan ti o lorukọ aaye kan.
Awọn aṣiṣe ifọwọsi wa n darukọ aaye na ati idi ninu awọn akọmọ lẹhin ifiranṣẹ na, fun apẹẹrẹ (php_version: 7.2 is not offered on this product line). Iyẹn ni idaji ti o le ṣe — gbolohun ti o wa ni iwaju rẹ jẹ apẹrẹ mọọmọ.
Daju gbigba silẹ rẹ
Gbogbo aṣoju ni a nṣe lori TLS lati orukọ súpà tirẹ laisi itọsọna miiran si súpà ẹgbẹ kẹta. ℹ️ Ṣayẹwo SHA-256 rẹ ni a tẹ sita lẹgbẹẹ ọna asopọ igbasilẹ lori oju-iwe awọn igbasilẹ. Ṣe afiwe rẹ lẹhin gbigba silẹ:
- macOS tabi Linux:
shasum -a 256 zinn-whmcs-1.0.0.zip - Windows:
certutil -hashfile zinn-whmcs-1.0.0.zip SHA256
Kii ṣe lori WHMCS?
Modulu HostBill kan wa ati alabara PHP faili kan fun ohunkohun miiran, mejeeji ọfẹ ati mejeeji lori oju-iwe awọn igbasilẹ kanna. Gbogbo ipari ti awọn modulu n lo wa ninu itumọ API.
Ṣe o tun di mọ?
Ìtìlẹ́yìn wà lórí gbogbo ètò, a sì ń dáhùn ní èdè rẹ.
Kan si àtìlẹyìn → Gbogbo àpilẹ̀kọ →