Uza huduma ya upangishaji ya Zinn® kutoka WHMCS

Moduli ya Zinn Digital® inageuza vitufe vya WHMCS yenyewe kuwa vitendo halisi kwenye jukwaa letu. Agizo linaandaa uhifadhi wa mteja wako. Uendeshaji otomatiki wa ankara zilizochelewa wa WHMCS huusimamisha. Kuashiria ankara kuwa imelipwa huufungua. Kughairi hupanga tarehe ya kuufuta. Na mteja wako hupata kitufe cha Log in to hosting panel katika eneo lake la mteja kinachomwingiza moja kwa moja.

Ni bure, ina leseni ya GPL-2.0-or-later, na haina njia ya upendeleo ndani ya jukwaa letu: kila wito inaofanya ni kituo cha mwisho kilichoandikwa ambacho unaweza kukifanya mwenyewe kwa ufunguo wako wa API.

Kabla ya kuanza

Unahitaji vitu viwili, na cha pili huwashangaza watu wengi.

1. Akaunti ya muuzaji mkuu wa Zinn® yenye mpango unaofanya kazi. Jisajili katika

zinndigital.com na uwashe uuzaji mkuu.

2. Kifurushi cha muuzaji mkuu chenye nafasi ya tovuti. Tovuti ambazo wateja wako wanaagiza huhesabiwa dhidi ya

kifurushi chako, kwa hivyo unahitaji chenye nafasi ya kutosha.

⚠️ Test Connection haiwezi kukuambia ikiwa agizo litafanikiwa. Husoma mpango wako na haiandai chochote, kwa hivyo inaripoti akaunti nzuri active ambayo haiwezi kuuza chochote bado. Ikiwa agizo lako la kwanza litashindwa na "This organization has no hosting plan, so it cannot host a site yet", hilo ndilo lililotokea — nunua au ongeza kifurushi chako cha muuzaji mkuu na uweke agizo tena. Hakuna tatizo lolote na moduli.

1. Unda ufunguo wa API

Kwenye dashibodi yako ya Zinn®, fungua API keys na uunde mmoja wenye ruhusa hizi kumi na moja kamili:

⛔ Usitoe reseller.manage. Ufunguo uliowekwa kwenye paneli ya utozaji unapaswa kuweza kuzuia mteja kwa kutolipa na kumwingiza. Haupaswi kuweza kusoma na kuandika upya vitambulisho vyako vya lango la malipo. reseller.provision ipo ili usilazimike kutoa ruhusa hiyo kubwa zaidi. ⛔ org.create si ya hiari. Bila hiyo, moduli inaweza kusoma akaunti zako na haiwezi kufungua moja, kwa hivyo Test Connection inapita na agizo la kwanza linajibu 403. ⛔⛔ Toa jedwali zima, na utambue kuwa Test Connection haiwezi kukuambia ikiwa hujafanya hivyo. Husoma mpango wako wa muuzaji mkuu na haiandai chochote, kwa hivyo inakuwa ya kijani kwa ufunguo unaokosa yoyote kati ya hizi. Badala yake, unachopata ni 403 kwenye operesheni moja inayofunikwa na ruhusa inayokosekana, miezi kadhaa baadaye, kutoka kwa mteja.

2. Sakinisha moduli

1. Pakua moduli na uifungue.
2. Pakia saraka ya zinn kwenye usakinishaji wako wa WHMCS ili faili la moduli lifike

modules/servers/zinn/zinn.php.

⛔ Saraka lazima iitwe zinn. WHMCS hupata majina ya vitendaji vya moduli ya uandaaji kutoka kwa jina la saraka yake, kwa hivyo kuibadilisha jina kuwa zinn-whmcs au zinndigital kunatengeneza moduli ambayo WHMCS inaorodhesha, inakuruhusu kuichagua, na kisha haiiti kamwe — bila hitilafu popote. Faili la zip tayari hufunguka kwa jina sahihi; usilibadilishe jina tu.

3. Ongeza seva

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

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

⛔ Ufunguo huwekwa kwenye uwanja wa Password, ambao WHMCS huuhifadhi ukiwa umesimbwa kwa njia fiche. Usiuweke kwenye chaguo la usanidi wa bidhaa — hayo ni maandishi wazi kwenye hifadhidata na yanaonekana kwa kila msimamizi, na kitambulisho hiki kinaweza kuunda na kuharibu uhifadhi wa wateja wako.

Bonyeza Test Connection. Inafanya wito halisi na kuripoti kile ambacho jukwaa letu lilisema, badala ya kuangalia tu ikiwa sehemu zimejazwa.

4. Unda bidhaa

Configuration → System Settings → Products/Services, kisha weka Module Settings kwa seva uliyotoka kuongeza. Sehemu hizo ni:

⛔⛔ Plan code inahitajika, na agizo lisilo na hiyo hukataliwa kimakusudi. Hadi 2026-09-01 uwanja huu ulikuwa wa mapambo na hakuna kitu kilichousoma, kwa hivyo moduli iliagiza uhifadhi ambao haukubeba mpango wowote kabisa — na kila matokeo ya hilo yalikuwa ya kimya. Taarifa yako ya jumla inajengwa kutoka kwa usajili unaotumika wa wateja wako, kwa hivyo hapakuwa na mstari wa huduma hiyo na hukutozwa chochote kwa muda wote ilipokuwa ikifanya kazi; mteja wako hakurithi posho yoyote, kwa hivyo hakuna kiwango cha diski au faili kilichotumika kwenye tovuti yao; na Change Package haikuwa na chochote cha kubadilisha, kwa hivyo uboreshaji uliouza haungeweza kufanywa. Tovuti iliandaliwa na kutoa huduma kikamilifu wakati wote.

Moduli sasa inakataa agizo badala yake, kwa sababu hakuna mpango salama wa kukisia: kukisia kungeandaa uhifadhi kwenye mpango ambao hukuchagua na labda hukuuwekea bei, na — tofauti na kukataliwa, ambako unakusoma mara moja — kungejitokeza tu wakati taarifa inapofika, ikiwa itafika kabisa.

Weka Auto Setup kwa kile unachopendelea zaidi — moduli haibadiliki kwa kitambulisho sawa cha huduma ya WHMCS (idempotent), kwa hivyo uandaaji unaorudiwa unarudisha tovuti ile ile badala ya kukutoza kwa tovuti ya pili.

Kile ambacho kila hatua ya WHMCS hufanya

Maboresho: nani anatoza nani

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

Huduma ya pili ya mteja. Kwenye mpango uleule ni tovuti nyingine chini ya posho ya tovuti ya mpango huo, na hakuna kingine kinachotolewa. Kwenye mpango tofauti inakataliwa: kubadilisha mpango unaotumika kungeacha moja ya huduma hizo mbili bila kutozwa. Au uza zote kwenye mpango uleule, au msajili mteja kama rekodi tofauti ya mteja katika WHMCS.

Change Password ipo kwa WordPress pekee. Uhifadhi wa Zinn® hauna "nenosiri la huduma" moja — mteja wako anafikia paneli yao kwa kitufe cha kuingia — na tovuti ya php au static haina akaunti ya programu ya kubadilisha. WHMCS huficha kabisa sanduku hilo badala ya kuonyesha lile ambalo haliwezi kufanya kazi.

Majibu matatu ambayo hupaswi kuyabana kuwa mawili

• Unsuspend inaweza kujibu kwa kukataa. Hiyo inamaanisha kuwa tovuti ilisimamishwa na timu yetu ya unyanyasaji (abuse team),

si na wewe, na hakuna paneli ya utozaji inayoweza kuifungua. Ujumbe unasema hivyo; uonyeshe kwa msimamizi wako badala ya kujaribu tena.

• Terminate hupanga tarehe ya kufuta, haifuti mara moja. Tarehe inarudi kama

pending_deletion_at na eneo la mteja linaionyesha. Kumwambia mteja data yake tayari imepotea wakati haijapotea ni mbaya zaidi kuliko kutomwambia chochote.

• Diski na kipimo data vinaweza kutojulikana, na kutojulikana si sifuri. Wakati ambapo hatukuweza

kuchukua usomaji, moduli huacha nambari hiyo vile ilivyo badala ya kuandika 0 — vinginevyo WHMCS ingemwonyesha mteja wako upau tupu wa matumizi unaompa matumaini ya uongo kwa tovuti ambayo hatuna usomaji wowote kuihusu.

Utatuzi wa Matatizo

Test Connection inapita na agizo la kwanza linashindwa kwa hitilafu ya ruhusa. Ufunguo wa API unakosa org.create. Moduli inapaswa kufungua akaunti ya mteja kabla ya kuweza kuunda tovuti yao.

Agizo linashindwa likisema kuwa shirika halina mpango wa uhifadhi. Kifurushi chako cha muuzaji mkuu hakina nafasi ya tovuti iliyobaki, au bado huna hata kimoja. Tazama Kabla ya kuanza hapo juu.

Agizo linashindwa likitaja mkusanyiko (stack). Sehemu ya Stack kwenye bidhaa haina kitu au inataja kitu ambacho hatukijengi. Iweke iwe wordpress isipokuwa kama unauza kitu kingine.

Ughairi unashindwa. Hakikisha unatumia toleo la moduli 1.0.0 au jipya zaidi. Matoleo ya awali hayakutuma uthibitisho wa kufuta na kila kusitishwa kulikataliwa, jambo lililoacha huduma ikiendelea kufanya kazi na kutoza.

Kukataliwa kunakotaja sehemu. Hitilafu zetu za uthibitishaji hutaja sehemu na sababu ndani ya mabano baada ya ujumbe, k.m. (php_version: 7.2 is not offered on this product line). Hiyo ndiyo nusu unayoweza kuifanyia kazi — sentensi iliyo mbele yake imekusudiwa kuwa ya jumla.

Thibitisha upakuaji wako

Kila kumbukumbu hutolewa kupitia TLS kutoka kwa jina la mpangishaji wetu wenyewe na haielekezwi kamwe kwa seva ya mtu mwingine. Nambari yake ya uthibitishaji ya SHA-256 imechapishwa kando ya kiungo cha kupakua kwenye ukurasa wa vipakuliwa. Ilinganishe 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

Je, hutumii WHMCS?

Kuna moduli ya HostBill na mteja wa PHP wa faili moja kwa chochote kingine, zote ni bure na zote zipo kwenye ukurasa uleule wa vipakuliwa. Kila kituo cha mwisho kinachotumiwa na moduli kipo kwenye marejeleo ya API.