Ka iibi martigelinta Zinn® xagga WHMCS

Muuqaalka Zinn Digital® wuxuu badhamada WHMCS u beddelaa ficillo dhab ah oo ka dhaca barxaddayada. Dalabku wuxuu diyaariyaa martigelinta macmiilkaaga. Habka tooska ah ee WHMCS u maamusho qaansheegyada waqtigoodu dhaafay ayaa hakiya. In qaansheegta loo calaamadeeyo mid la bixiyay ayaa dib u fasaxda. Baabi'intuna waxay jadwalaysaa tirtirista. Macmiilkaaguna wuxuu aagga macmiilka ka helayaa badhanka Log in to hosting panel kaas oo toos u geliya nidaamka.

Waa bilaash, waxay haysataa shatiga GPL-2.0-or-later, mana laha waddo mudnaan gaar ah leh oo ay ku gasho barxaddayada: wicitaan kasta oo ay samayso waa barta ugu dambaysa (endpoint) oo la diiwaangeliyay oo aad adiguba ku samayn karto furahaaga API.

Kahor inta aadan bilaabin

Waxaad u baahan tahay laba waxyaabood, tan labaad ayaana inta badan dadka ku adkaata.

1. Koontada dib-u-iibiyaha ee Zinn® oo leh barnaamij shaqaynaya. Iska diiwaangeli

zinndigital.com oo shid dib-u-iibinta.

2. Qorshe dib-u-iibiye oo leh xaddiga goobaha la oggol yahay. Goobaha ay macmiishaadu dalbadaan waxay ka go'ayaan qorshahaaga adiga,

markaa waxaad u baahan tahay mid boos ku hadhsan yahay.

⚠️ Test Connection kuma sheegi karo haddii dalabku guulaysan doono. Waxay akhrisaa barnaamijkaaga mana diyaariso wax adeeg ah, sidaa darteed waxay soo sheegaysaa koonto bedqabta oo active ah oo aan weli waxba iibin karin. Haddii dalabkaaga ugu horreeya uu ku fashilmo "This organization has no hosting plan, so it cannot host a site yet", taasi waa waxa dhacay — ianso ama kordhi qorshahaaga dib-u-iibiyaha oo mar kale dalabka dir. Wax qalad ah kuma jiraan module-ka.

1. Samee furaha API

Gudaha dashboard-kaaga Zinn®, fur API keys oo samee mid leh kow iyo tobankan ogolaansho ee saxda ah:

⛔ Ha bixin reseller.manage. Fure lagu dhejiyay qaybta biilasha waa inuu awoodaa inuu macmiilka u hakiyo lacag-bixin la'aan darradeed oo uu geliyo nidaamka. Ma aha inuu awoodo inuu akhriyo oo dib u qoro xogtaada marin-ka lacag-bixinta (payment-gateway). reseller.provision waxay u jirtaa si aadan ugu baahan inaad bixiso midda ka weyn. ⛔ org.create ma aha ikhtiyaari. La'aanteed module-ku wuxuu akhrin karaa koontooyinkaaga laakiin ma furi karo mid cusub, sidaa darteed Test Connection wuu gudbayaa dalabka ugu horreeyana wuxuu ku jawaabayaa 403. ⛔⛔ Bixi dhammaan shaxda, oo ogow in Test Connection uusan kuu sheegi karin haddii aad wax ka tagtay. Waxay akhrisaa barnaamijkaaga dib-u-iibiyaha mana diyaariso waxba, markaa cagaar ayay u noqonaysaa fure ka maqan yahay mid ka mid ah kuwan. Waxa aad beddelkeeda helaysaa waa 403 oo ku saabsan hal hawlgal oo ogolaanshaha maqani daboolayay, bilo ka dib, oo ka imanaya macmiil.

2. Ku shub module-ka

1. Soo deji module-ka oo fur faylka sibka ah.
2. Geli galka zinn rakibaaddaada WHMCS si faylka module-ku u galo

modules/servers/zinn/zinn.php.

⛔ Waa in galka loogu yeeraa zinn. WHMCS waxay magacyada shaqada (function names) ee module-ka diyaarinta ka soo dheegataa magaca galka, markaa in magaca loo beddelo zinn-whmcs ama zinndigital waxay keenaysaa module ay WHMCS liis gareyso, kuu oggolaato inaad doorato, ka dibna aan waligeed la wicin — iyada oo aan wax qalad ah meelna lagu muujin. Faylka sibka ahi mar horeba wuxuu ku furmayaa magaca saxda ah; kaliya ha beddelin magaca.

3. Ku dar serfarka

Gudaha WHMCS: Configuration → System Settings → Servers → Add New Server.

• Name: wax kasta, tusaale Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: furahaaga API ee tallaabada 1aad

⛔ Furaha waxaa la geliyaa qaybta Password, taas oo WHMCS ay u kaydiso si qarsoodi ah (encrypted). Ha gelin xulashada habaynta alaabta — kuwaasi waa qoraal cad oo ku jira xog-kaydiyaha oo u muuqda maamule kasta, xogtan aqoonsiguna waxay abuuri kartaa oo baabi'in kartaa martigelinta macmiishaada.

Guji Test Connection. Waxay samaynaysaa wicitaan dhab ah waxayna ka warbixinaysaa waxa ay barxaddayadu tiri, intii ay ka hubin lahayd oo keliya in meelaha bannaan la buuxiyay.

4. Samee badeecada

Configuration → System Settings → Products/Services, ka dibna ku hagaaji Module Settings serfarkii aad hadda ku dartay. Meelaha bannaani waa:

⛔⛔ Koodhka qorshuhu (Plan code) waa qasab, dalabka aan lahayna si ku talagal ah ayaa loo diidayaa. Ilaa 2026-09-01 qaybtani waxay ahayd mid qurxin ah oo waxba ma akhrin jirin, sidaa darteed module-ku wuxuu dalbay martigelin aan wadan wax qorshe ah haba yaraatee — cawaaqib kasta oo arrintaas ka dhashayna wuxuu ahaa mid aamusan. Bayaankaaga jumlada ah waxaa laga dhisay rukumashada tooska ah ee macmiishaada, markaa ma jirin khad adeeggaas u gaar ah wax biil ahna laguguma soo dallacin intii ay shaqaynaysay; macmiilkaagu ma helin wax xaddidaad ah, markaa wax xaddid ah oo disk ama fayl ah laguma dabaqin goobtooda; sidoo kale Change Package ma haysan wax ay beddesho, sidaa darteed cusboonaysiin aad iibisay lama samayn karin. Goobtuna waxay u diyaarsanayd oo u shaqaynaysay si heer sare ah muddadaas oo dhan.

Module-ku hadda wuxuu beddelkeeda diidayaa dalabka, sababtoo ah ma jiro qorshe ammaan ah oo uu qiyaasi karo: qiyaastu waxay diyaarin lahayd martigelin qorshe aadan dooran oo laga yaabo inaadan qiimayn ku samayn, iyo — si ka duwan diidmada, oo aad isla markiiba akhrinayso — waxay soo bixi lahayd oo keliya marka bayaan yimaado, haddii ayba timaado.

Ku hagaaji Auto Setup waxaad doorbidayso — module-ku waa mid ku tiirsan aqoonsiga adeegga WHMCS (idempotent), sidaa darteed isku dayga dib-u-diyaarintu wuxuu soo celinayaa isla goobtii halkii uu biil labaad kugu dalaci lahaa.

Waxa ficil kasta oo WHMCS ahi qabto

Cusboonaysiinta (Upgrades): yaa cidna lacag ka qaadaya

Macmiilkaaga marnaba biil kama helo Zinn®, ha ahaato dalab ama cusboonaysiin. Adigaa biilka u dira adigoo isticmaalaya WHMCS; annaguna adigaan biilka kuu soo dirnaa, oo ku saabsan bayaankaaga jumlada ah. Markaa Change Package waxay wareejisaa xuquuqda macmiilkaaga iyo khadka ku jira bayaankaaga xiga, mana taabanayso wax kaadh ah — WHMCS mar horeba waxay qaadatay lacagtii macmiilkaaga waxayna xisaabisay qaybteeda u dhiganta.

Adeegga labaad ee macmiilka. Isla qorshaha dhexdiisa waa goob kale oo hoos timaada xaddiga goobaha ee qorshahaas, wax kalena lama oggolaanayo. Qorshe ka duwan dhexdiisana waa la diidayaa: beddelidda qorshaha hadda shaqaynaya waxay mid ka mid ah labada adeeg ka dhigi lahayd mid aan biil laga bixin. Ama labadaba ku iibi isla qorshaha, ama macmiilka u samee diiwaan macmiil oo gooni ah gudaha WHMCS.

Change Password waxay u jirtaa WordPress oo keliya. Martigelinta Zinn® ma laha hal "service password" — macmiilkaagu wuxuu kaga galaa koontadiisa badhanka gelitaanka — goobta php ama static ahna ma laha koonto barnaamij oo la beddelo. WHMCS waxay gebi ahaanba qarisaa sanduuqa halkii ay soo bandhigi lahayd mid aan shaqayn karin.

Saddex jawaabood oo aadan ku qasbin inay laba noqdaan

• Unsuspend waxay kaga jawaabi kartaa diidmo. Taasi waxay la micno tahay in goobta ay hakisay

kooxdayada la dagaallanka xadgudubka (abuse team), ee ma aha adiga, mana jirto qayb biilal oo fasaxi karta. Fariintu sidaas ayay leedahay; u tus maamulahaaga halkii aad dib isku dayi lahayd.

• Terminate waxay jadwalaysaa tirtirid, ma fuliso mid isla goobta ah. Taariikhdu waxay ku soo noqonaysaa

pending_deletion_at aagga macmiilkana wuu muujinayaa. In macaamilka loo sheego in xogtiisii mar hore la tirtiray iyadoo aysan taasi dhicin ayaa ka xun inaan waxba loo sheegin.

• Disk-ga iyo bandwidth-ga waxay noqon karaan kuwo aan la garanayn, wax aan la garanayna eber ma aha. Markii aanan awoodin inaan

qiyaas qaadanno, module-ku wuxuu lambarka u daynayaa sida uu yahay halkii uu ka qori lahaa 0 — haddii kale WHMCS waxay macaamilkaaga tusi lahayd calaamad bannaan oo niyad-dhis ah oo ku saabsan goob aannaan wax cabbir ah ka haynin.

Cilad-bixinta

Test Connection wuu gudbayaa dalabka ugu horreeyana wuxuu ku fashilmayaa qalad dhanka ogolaanshaha ah. Furaha API waxaa ka maqan org.create. Module-ku waa inuu furaa koontada macmiilka ka hor inta uusan abuurin goobtooda.

Dalab baa fashilmaya isagoo sheegaya in ururku uusan lahayn qorshe martigelineed. Qorshahaaga dib-u-iibiyuhu ma haysto wax xaddi goobeed ah oo hadhay, ama weli ma haysatid midna. Eeg Kahor inta aadan bilaabin xagga sare.

Dalab baa fashilmaya isagoo xusaya stack. Qaybta Stack ee badeecada ayaa bannaan ama waxay magacawday wax aanaan dhisin. Ku hagaaji wordpress ilaa aad iibinayso wax kale mooyee.

Baabi'intu way fashilmayaan. Hubi inaad ku jirto module-ka nooca 1.0.0 ama wixii ka dambeeya. Noocyadii hore ma aysan dirin wax xaqiijin tirtiris ah waxaana la diiday joojin kasta, taas oo adeeggii ka dhigtay mid shaqaynaya oo biil ku socdo.

Diidmo magacawday meel banaan (field). Qaladaadkayada ansaxinta waxay magacaabaan qaybta iyo sababta ku dhex jirta qaansada fariinta ka dib, tusaale (php_version: 7.2 is not offered on this product line). Taasi waa qaybta ficilka laga qaadi karo — jumladdu ka horraysaa si ku talagal ah ayay guud u tahay.

Xaqiiji soo-dejintaada

Kayd kasta waxaa lagaga adeegaa TLS oo ka socda magaca martigeliyaha noo gaarka ah loomana weeciyo martigeliye saddexaad. Xaqiijintiisa SHA-256 (checksum) waxaa lagu daabacay xiriiriyaha soo dejinta agtiisa ee ku yaal bogga soo-dejinta. Is barbar dhig ka dib markaad soo dejiso:

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

Miyaadan isticmaalin WHMCS?

Waxaa jira module HostBill ah iyo PHP client hal fayl ah oo loogu talagalay wax kasta oo kale, labaduba waa bilaash labadubana waxay ku yaallaan isla bogga soo-dejinta. Barta kasta oo ugu dambaysa oo ay modules-ku isticmaalaan waxay ku jirtaa tixraaca API.