Uza huduma ya mwenyeji ya Zinn® kupitia WHMCS

Moduli ya Zinn Digital® inabadilisha vitufe vyenyewe vya WHMCS kuwa vitendo halisi kwenye jukwaa wetu. Agizo linatoa huduma ya hosting ya mteja wako. Otomatiki ya ankara iliyopitiliza muda ya WHMCS inaizuia. Kuweka alama kwenye ankara kuwa imelipwa kunaiondoa kwenye uzuio. Kughairi kunapanga ufutaji. Na mteja wako anapata kitufe cha Log in to hosting panel katika eneo lao la mteja kinachowaingiza moja kwa moja.

Ni ya bure, ina leseni ya GPL-2.0-or-later, na haina njia ya kipekee ya kuingia kwenye jukwaa wetu: kila mwito inaofanya ni kigezo kilichoandikwa ambacho unaweza kufanya mwenyewe kwa ufunguo wako mwenyewe wa API.

Kabla ya kuanza

Unahitaji vitu viwili, na cha pili huwashangaza watu.

1. Akaunti ya muuzaji tena ya Zinn® yenye mpango unaofanya kazi. Jisajili kwenye zinndigital.com na uwashe uuzaji tena.
2. Mpango wa muuzaji tena wenye kiasi cha tovuti zilizoruhusiwa. Tovuti ambazo wateja wako wanaagiza zinahesabiwa dhidi ya mpango wako, kwa hivyo unahitaji ule wenye nafasi.

⚠️ Jaribio la Muunganisho (Test Connection) haliwezi kukuambia ikiwa agizo litafanikiwa. Linasoma mpango wako na halitoi huduma yoyote, kwa hivyo linaripoti akaunti yenye afya ya active ambayo bado haiwezi kuuza chochote. Ikiwa agizo lako la kwanza litafeli kwa "This organization has no hosting plan, so it cannot host a site yet", huo ndio ukweli uliotokea — nunua au ongeza mpango wako wa muuzaji tena na uweke agizo tena. Hakuna kibaya na moduli hii.

1. Tengeneza ufunguo wa API

Kwenye dashibodi yako ya Zinn®, fungua API keys na utengeneze moja yenye ruhusa hizi kumi na moja halisi:

| Ruhusa | Sababu inayohitajika | | -------------------- | ----------------------------------------------------------- | | org.create | Fungua akaunti ya Zinn® ya mteja wako kwenye agizo lao la kwanza. | | org.read | Soma akaunti za wateja wako. | | sites.create | Toa huduma ya tovuti. | | sites.view | Soma huduma na matumizi yake. | | sites.delete | Sitisha. | | reseller.view | Orodhesha ulichouza, na usome diski na upana wa bendi (bandwidth). | | reseller.provision | Zuia, ondoa uzuio, ingiza mteja, weka mpango wa mteja na ubadilishe kifurushi chao. | | billing.view | Soma gharama ya kuboresha kabla ya kuitekeleza. | | sites.manage | Safisha kache na uchukue nakala rudufu kutoka kwenye vitufe. | | sites.panel_access | Badilisha nenosiri la msimamizi wa WordPress. | | hosting.php.manage | Badilisha toleo la PHP wakati wa kuboresha au kupunguza daraja. |

⛔ Usitoe ruhusa ya reseller.manage. Ufunguo uliowekwa kwenye jopo la malipo unapaswa kuweza kumzuia mteja kwa kutolipa na kumwingiza. Haupaswi kuweza kusoma na kuandika upya vitambulisho vyako vya lango la malipo. reseller.provision ipo ili usilazimike kutoa ile kubwa zaidi. ⛔ org.create si ya hiari. Bila hiyo, moduli inaweza kusoma akaunti zako na haiwezi kufungua moja, kwa hivyo Jaribio la Muunganisho linapita na agizo la kwanza linajibu 403. ⛔⛔ Toa meza nzima, na utambue kuwa Jaribio la Muunganisho haliwezi kukuambia ikiwa hujatoa. Linasoma mpango wako wa muuzaji tena na halitoi huduma yoyote, kwa hivyo linaonyesha kijani kwa ufunguo unaokosa mojawapo ya hizi. Unachopata badala yake ni 403 kwenye operesheni moja ambayo ruhusa inayokosekana inashughulikia, miezi kadhaa baadaye, kutoka kwa mteja.

2. Sakinisha moduli

1. Pakua moduli na uifungue kutoka kwenye zipu.
2. Pakia saraka ya zinn kwenye usakinishaji wako wa WHMCS ili faili ya moduli itue kwenye modules/servers/zinn/zinn.php.

⛔ Saraka lazima iitwe zinn. WHMCS inatoa majina ya kazi ya moduli ya utoaji huduma kutoka kwa jina la saraka yake, kwa hivyo kuibadilisha jina kuwa zinn-whmcs au zinndigital kunazalisha moduli ambayo WHMCS inaorodhesha, inakuruhusu kuchagua, na kisha haiiti kamati — bila kosa lolote mahali popote. Zipu tayari inafunguka kwa jina sahihi; usiibadilishe jina tu.

3. Ongeza seva

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

• Name: chochote, mfano Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: ufunguo wako wa API kutoka hatua ya 1

⛔ Ufunguo unaingia kwenye uwanja wa Password, ambao WHMCS inahifadhi ukiwa umesimbwa kwa njia fiche. Usiuweke kwenye chaguo la usanidi wa bidhaa — hizo ni maandishi ya kawaida kwenye hifadhidata na yanaonekana kwa kila msimamizi, na kitambulisho hiki kinaweza kutengeneza na kuharibu hosting ya wateja wako.

Bofya Test Connection. Inafanya mwito halisi na kuripoti kile ambacho jukwaa wetu ulisema, badala ya kuangalia tu ikiwa nyanja zimejazwa.

4. Tengeneza bidhaa

Configuration → System Settings → Products/Services, kisha weka Module Settings kuwa seva uliyoongeza hivi karibuni. Nyanja ni:

| Uwanja | Inahitajika | Ni nini | | ---------------- | ----------- | -------------------------------------------------------------------------- | | Product line | ndiyo | Aina ya Zinn® unayouza — mainstream (WordPress inayosimamiwa), footprint_free, wordpress, linux, cloud, agency, app_hosting, ai_hosting, lms_hosting, managed_database, vector_hosting, zinn_compute, fleet_linux, fleet_enterprise, mail au reseller. | | Stack | ndiyo | Kinachojengwa: wordpress (chaguo-msingi), woocommerce, php, static, node, one_click, headless_cms, nextcloud au owncloud. | | Application | hapana | Ni kwa ajili ya miumbiko ya one_click na headless_cms pekee — programu gani ya kusakinisha. Kutaja moja kwenye miumbiko mingine yoyote kunakataliwa, kwa sababu miumbiko hiyo tayari inaamua kinachosakinishwa. | | PHP version | hapana | mfano 8.3. Acha wazi kwa chaguo-msingi la aina ya bidhaa. Toleo ambalo aina hiyo haitoi linakataliwa pamoja na orodha ya yale inayotoa. | | Plan code | ndiyo | Mpango wa Zinn® ambao bidhaa hii inauza. GET /v1/reseller/prices inaaorodhesha yako. Agizo bila hii linakataliwa — tazama onyo hapa chini. | | Billing interval | hapana | monthly (chaguo-msingi) au annual — muda ambao aina yako ya jumla kwa mteja huyu inatolewa. Unachotoza mteja wako mwenyewe kinawekwa kwenye bidhaa ya WHMCS na kutoathiriwa. |

⛔⛔ Msimbo wa mpango unahitajika, na agizo bila msimbo unakataliwa kwa makusudi. Hadi 2026-09-01 uwanja huo ulikuwa wa pambo tu na hakuna kilichousoma, kwa hivyo moduli iliamuru hosting ambayo haikuwa na mpango wowote kabisa — na kila matokeo ya hilo yalikuwa ya kimya. Taarifa yako ya jumla inatengenezwa kutoka kwa usajili wa moja kwa moja wa wateja wako, kwa hivyo hakukuwa na mstari wa huduma hiyo na hukutozwa chochote kwa muda wote ulipofanya kazi; mteja wako hakurithi posho yoyote, kwa hivyo hakuna kiasi cha diski au faili kilichowekwa kwenye tovuti yao; na Change Package haikuwa na cha kubadilisha, kwa hivyo uboreshaji uliouza haukuweza kutekelezwa. Tovuti ilitolewa na kufanya kazi kikamilifu wakati wote.

Moduli sasa inakataa agizo badala yake, kwa sababu hakuna mpango salama wa kukisia: kukisia kungewezesha hosting kwenye mpango ambao hukuchagua na huenda hukuwekea bei, na — tofauti na kukataliwa, ambako unasoma mara moja — kungejitokeza tu wakati taarifa inapowasili, ikiwa ingewasili kabisa.

Weka Auto Setup kuwa ile unayopendelea — moduli ni idempotent kwenye kitambulisho cha huduma cha WHMCS, kwa hivyo utoaji wa huduma unaorudiwa unarudisha tovuti ile ile badala ya kukutoza kwa ya pili.

Kila kitendo cha WHMCS kinafanya nini

| Kitendo cha WHMCS | Kinachotokea upande wetu | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | Inatengeneza akaunti ya Zinn® ya mteja (au inatumia tena ile waliyo nayo tayari) na kutoa huduma ya tovuti yao. | | Suspend | Inaweka tovuti kwenye kizuizi cha kutolipa. Maudhui yanahifadhiwa; hakuna kinachofutwa. | | Unsuspend | Inaondoa kizuizi yako. | | Terminate | Inapanga ufutaji wa tovuti, kukiwa na muda wa neema. Tarehe inaonekana katika eneo la mteja. | | Usage update | Inahuisha diski na upana wa bendi kwenye kila huduma, mara moja kwa siku. | | Log in to hosting panel | Inafungua kiungo cha kuingia cha mara moja moja kwa moja kwenye jopo la mteja wako. | | Change Package | Inaboresha au kupunguza daraja la huduma. Inahamisha kifurushi, na toleo la PHP ikiwa bidhaa mpya inataja moja. | | Change Password | Inaweka nenosiri la msimamizi wa WordPress. Kisanduku hakionekani kwenye miumbiko ambayo haina akaunti kama hiyo. | | Renew | Inathibitisha kuwa huduma bado ipo. Hosting ya Zinn® ni ya kuendelea, kwa hivyo hakuna muda wa mbali wa kuongeza. | | Sync Usage / Purge Cache / Take Backup | Vitufe kwenye ukurasa wa huduma ya msimamizi. Mteja wako anapata Purge Cache na Take Backup katika eneo lao la mteja. | | Service tab | Hali, mpango, diski, upana wa bendi, ufutaji wowote uliopangwa, na nani aliyeweka uzuio. | | Import | ListAccounts inasoma kila ukurasa, kwa hivyo uingizaji hauwezi kusimama kimya kimya kwenye ukurasa wa kwanza. |

Uboreshaji: nani anayeza nani

Mteja wako hatozwi ankara na Zinn® kamwe, kwenye agizo au kwenye uboreshaji. Unawatoza kupitia WHMCS; sisi tunakutoza wewe, kwenye taarifa yako ya jumla. Kwa hivyo Change Package inahamisha haki za mteja wako na mstari kwenye taarifa yako inayofuata, na haigusi kadi yoyote — WHMCS tayari imechukua pesa za mteja wako na kuhesabu mgawanyo wake wa viwango.

Huduma ya pili ya mteja. Kwenye mpango ule ule ni tovuti nyingine chini ya posho ya tovuti ya mpango huo, na hakuna kingine kinachotolewa. Kwenye mpango tofauti inakataliwa: kubadilisha mpango wa moja kwa moja kungeacha moja ya huduma hizo mbili bila kutoza ankara. Au uza zote mbili kwenye mpango ule ule, au umweke mteja kama kumbukumbu tofauti ya mteja katika WHMCS.

Change Password ipo kwa ajili ya WordPress pekee. Hosting ya Zinn® haina "nenosiri la huduma" moja — mteja wako anafikia jopo lao kwa kitufe cha kuingia — na tovuti ya php au static haina akaunti ya programu ya kubadilisha. WHMCS inaficha kisanduku kabisa badala ya kuonyesha kile kinachoshindwa kufanya kazi.

Majibu matatu ambayo hupaswi kuyapunguza kuwa mawili

• Unsuspend inaweza kujibu kwa kukataa. Hiyo ina maana kwamba tovuti ilizuiliwa na timu yetu ya unyanyasaji, si wewe, na hakuna jopo la malipo linaloweza kuiondoa kizuizini. Ujumbe unasema hivyo; mwonyeshe msimamizi wako badala ya kujaribu tena.
• Terminate inapanga ufutaji, haitekelezi ufutaji. Tarehe inarudi kama pending_deletion_at na eneo la mteja linaionyesha. Kumwambia mteja kwamba data zao tayari zimeondoka wakati hazijaondoka ni mbaya zaidi kuliko kutowaambia chochote.
• Diski na upana wa bendi vinaweza kutojulikana, na kutojulikana si sufuri. Wakati hatukuweza kuchukua usomaji, moduli inaacha takwimu jinsi ilivyo badala ya kuandika 0 — vinginevyo WHMCS ingemwonyesha mteja wako mwambaa wa matumizi tupu unaotia moyo kwa tovuti ambayo hatuna usomaji kutoka kwayo.

Utatuzi wa matatizo

Test Connection inapita na agizo la kwanza linashindwa na kosa la ruhusa. Ufunguo wa API unakosa org.create. Moduli lazima ifungue akaunti ya mteja kabla ya kutengeneza tovuti yao.

Agizo linashindwa likisema shirika halina mpango wa hosting. Mpango wako wa muuzaji tena hauna posho ya tovuti iliyobaki, au bado huna moja. Tazama Kabla ya kuanza hapo juu.

Agizo linashindwa likitaja mumbiko (stack). Uwanja wa Stack kwenye bidhaa uko wazi au unataja kitu ambacho hatujengi. Uweke kuwa wordpress isipokuwa unauza kitu kingine.

Ughairishaji unashindwa. Hakikisha uko kwenye toleo la moduli 1.0.0 au la baadaye. Miumbiko ya awali haikutuma uthibitisho wa ufutaji na kila usitishaji ulikataliwa, jambo lililoacha huduma ikiendelea kufanya kazi na kutoza.

Kukataliwa kunakotaja uwanja. Makosa yetu ya uthibitisho yanataja uwanja na sababu katika mabano baada ya ujumbe, mfano (php_version: 7.2 is not offered on this product line). Huo ndio nusu inayoweza kufanyiwa kazi — sentensi iliyo mbele yake ni ya jumla kwa makusudi.

Thibitisha upakuaji wako

Kila kumbukumbu inatolewa kupitia TLS kutoka kwa jina letu la mpangishi na haielekezwi tena kwa mpangishi wa tatu. Hakiki yake ya SHA-256 imepigwa chapa kando ya kiungo cha kupakua kwenye ukurasa wa pakua. Inchipe baada ya kupakua:

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

Hauko kwenye WHMCS?

Kuna moduli ya HostBill na mteja wa PHP wa faili moja kwa ajili ya kitu kingine chochote, vyote ni vya bure na vyote viko kwenye ukurasa wa pakua ule ule. Kila kigezo kinachotumiwa na moduli kiko kwenye marejeleo ya API.