ከ WHMCS የ Zinn® ማስተናገጃ ይሽጡ

የ Zinn Digital® ሞጁል የ WHMCS የራሱን ቁልፎች በእኛ መድረክ ላይ ወደሚከናወኑ እውነተኛ እርምጃዎች ይለውጣቸዋል። ትዕዛዝ ሲሰጥ የደንበኛዎን ሆስቲንግ ያዘጋጃል። የ WHMCS ያለፈበት-ደረሰኝ አውቶሜሽን ደግሞ ያግደዋል። ደረሰኙ መከፈሉን ምልክት ማድረግ እገዳውን ያነሳል። መሰረዝ ደግሞ መወገዱን የጊዜ ሰሌዳ ይይዝለታል። እንዲሁም ደንበኛዎ በደንበኛ ቦታው ውስጥ ቀጥታ ወደ ውስጥ የሚያስገባ ወደ ሆስቲንግ ፓነል ግባ የሚል ቁልፍ ያገኛል።

ይህ ነፃ፣ በ GPL-2.0-or-later ፈቃድ የተሰጠው ነው፣ እና ወደ መድረካችን የሚወስድ ምንም ዓይነት ልዩ ልዩ መብት ያለው መንገድ የለውም፡ የሚያደርገው እያንዳንዱ ጥሪ በራስዎ ኤፒአይ ቁልፍ (API key) እርስዎ እራስዎ ሊያደርጉት የሚችሉት የተመዘገበ የመጨረሻ ነጥብ (endpoint) ነው።

ከመጀመርዎ በፊት

ሁለት ነገሮች ያስፈልጉዎታል፣ እና ሁለተኛው ነገር ሰዎችን ያሳስታል።

1. ንቁ ፕሮግራም ያለው የ Zinn® የዳግም ሻጭ (reseller) መለያ። በ zinndigital.com ይመዝገቡ እና ዳግም መሸጥን ያበሩ።
2. የጣቢያ ፈቃድ (site allowance) ያለው የዳግም ሻጭ ፕላን። ደንበኞችዎ የሚያዟቸው ጣቢያዎች በእርስዎ ፕላን ላይ ስለሚቆጠሩ፣ በውስጡ በቂ ቦታ ያለው ፕላን ያስፈልግዎታል።

⚠️ ግንኙነትን መሞከር (Test Connection) ትዕዛዝ ስኬታማ ይሁን አይሁን ሊነግርዎት አይችልም። ፕሮግራምዎን ያነባል እንጂ ምንም ነገር አያዘጋጅም፣ ስለዚህ እስካሁን ምንም መሸጥ የማይችል ጤናማ active መለያ እንደሆነ ሪፖርት ያደርጋል። የመጀመሪያው ትዕዛዝዎ "This organization has no hosting plan, so it cannot host a site yet" በሚል ምክንያት ካልተሳካ፣ የሆነው ነገር ይሄው ነው — የዳግም ሻጭ ፕላንዎን ይግዙ ወይም ያራዝሙ እና ትዕዛዙን እንደገና ይስጡ። በሞጁሉ ላይ ምንም ችግር የለም።

1. የ ኤፒአይ ቁልፉን (API key) ይፍጠሩ

በእርስዎ የ Zinn® ዳሽቦርድ ውስጥ፣ API keys የሚለውን ይክፈቱ እና በትክክል እነዚህ አስራ አንድ ፈቃዶች ያሉት ቁልፍ ይፍጠሩ፡

| ፈቃድ | ለምን እንደሚያስፈልግ | | -------------------- | ----------------------------------------------------------- | | org.create | በደንበኛዎ የመጀመሪያ ትዕዛዝ ላይ የ Zinn® መለያቸውን ለመክፈት። | | org.read | የደንበኛዎን መለያዎች ለማንበብ። | | sites.create | ጣቢያውን ለማዘጋጀት (Provision)። | | sites.view | አገልግሎትን እና አጠቃቀሙን ለማንበብ። | | sites.delete | ለማቋረጥ (Terminate)። | | reseller.view | የሸጡትን ለመዘርዘር፣ እና ድስክን እና ባንድዊድዝ ለማንበብ። | | reseller.provision | ለማገድ፣ ለማንሳት፣ ደንበኛን ለማስገባት፣ ፕላናቸውን ለማስተካከል እና ፓኬጃቸውን ለመለወጥ። | | billing.view | ማሻሻያ (upgrade) ከመፈጸሙ በፊት ምን ያህል እንደሚያስወጣ ለማንበብ። | | sites.manage | ከቁልፎቹ ላይ ካች ለማጽዳት (Purge cache) እና ባክአፕ ለመውሰድ። | | sites.panel_access | የ WordPress አስተዳዳሪውን የይለፍ ቃል ለመለወጥ። | | hosting.php.manage | በማሻሻያ ወይም በማውረጃ ላይ የ PHP ሥሪትን ለመቀየር። |

⛔ reseller.manage ፈቃድን አይስጡ። ወደ ክፍያ ፓነል የተቀላቀለ ቁልፍ ደንበኛን ባለመክፈሉ ምክንያት ማገድ እና ማሰገባት መቻል አለበት። የእርስዎን የክፍያ-በር (payment-gateway) መረጃዎች ማንበብ እና እንደገና መጻፍ መቻል የለበትም። ትልቁን ፈቃድ መስጠት ስለማይኖርብዎት reseller.provision አለ። ⛔ org.create አማራጭ አይደለም። ያለ እሱ ሞጁሉ መለያዎችዎን ማንበብ ይችላል እንጂ መለያ መክፈት አይችልም፣ ስለዚህ Test Connection ያልፋል ነገር ግን የመጀመሪያው ትዕዛዝ 403 ምላሽ ይሰጣል። ⛔⛔ ሙሉውን ሰንጠረዥ ፈቃድ ይስጡ፣ እና ባይሰጡ እንኳን Test Connection ሊነግርዎት እንደማይችል ያስተውሉ። የዳግም ሻጭ ፕሮግራምዎን ያነባል እንጂ ምንም ነገር አያዘጋጅም፣ ስለዚህ ከእነዚህ ውስጥ ማንኛውም ፈቃድ ለጎደለው ቁልፍ አረንጓዴ ያሳያል። ይልቁንም የሚያገኙት፣ ከወራት በኋላ፣ በጎደለው ፈቃድ በሚሸፈነው በአንዱ ክወና ላይ ከደንበኛ የሚመጣ 403 ስህተት ነው።

2. ሞጁሉን ይጫኑ

1. ሞጁሉን ያውርዱ እና ዚፕ ፋይሉን ይክፈቱ።
2. የ zinn ዳይሬክተሪን ወደ እርስዎ WHMCS ጭነት ይስቀሉ፣ በዚህም የሞጁሉ ፋይል በ modules/servers/zinn/zinn.php ላይ ያርፋል።

⛔ ዳይሬክተሪው zinn ተብሎ መጠራት አለበት። WHMCS የማዘጋጃ ሞጁል ተግባር ስሞችን ከዳይሬክተሪው ስም ያወጣል፣ ስለዚህ ስሙን ወደ zinn-whmcs ወይም zinndigital መቀየር WHMCS የሚዘረዝረውን፣ እንዲመርጡት የሚያደርገውን እና ከዚያ በኋላ በፍጹም የማይጠራውን ሞጁል ይፈጥራል — የትም ቦታ ምንም ስህተት ሳይኖር። ዚፕ ፋይሉ አስቀድሞ ወደ ትክክለኛው ስም ይከፈታል፤ ብቻ ስሙን አይቀይሩት።

3. አገልጋዩን (Server) ይጨምሩ

በ WHMCS ውስጥ፡ Configuration → System Settings → Servers → Add New Server።

• Name: የፈለጉትን፣ ለምሳሌ Zinn Digital®
• Hostname: api.zinndigital.com
• Type: Zinn Digital®
• Password: በደረጃ 1 ያገኙት የ ኤፒአይ ቁልፍ (API key)

⛔ ቁልፉ የሚገባው WHMCS በምስጢር የተቀመጠ (encrypted) አድርጎ በሚያስቀምጠው Password መስክ ውስጥ ነው። በምርት ውቅረት (configuration) አማራጭ ውስጥ አያስቀምጡት — እነዚያ በውሂብ ጎታ ውስጥ ግልጽ ጽሑፍ ናቸው እና ለእያንዳንዱ አስተዳዳሪ ይታያሉ፣ ይህ የምስክር ወረቀት ደግሞ የደንበኞችዎን ሆስቲንግ መፍጠር እና ማጥፋት ይችላል።

Test Connection የሚለውን ይጫኑ። መስኮቹ መሞላታቸውን ከመፈተሽ ይልቅ እውነተኛ ጥሪ ያደርጋል እና የመድረካችንን ምላሽ ሪፖርት ያደርጋል።

4. ምርቱን ይፍጠሩ

Configuration → System Settings → Products/Services፣ ከዚያ Module Settings የሚለውን አሁን ወደጨመሩት አገልጋይ ያዘጋጁ። መስኮቹ እንደሚከተለው ናቸው፡

| መስክ | አስፈላጊ ነው | ምንድን ነው | | ---------------- | -------- | -------------------------------------------------------------------------- | | Product line | አዎ | የሚሸጡት የ Zinn® መስመር — mainstream (የተስተካከለ WordPress)፣ footprint_free፣ wordpress፣ linux፣ cloud፣ agency፣ app_hosting፣ ai_hosting፣ lms_hosting፣ managed_database፣ vector_hosting፣ zinn_compute፣ fleet_linux፣ fleet_enterprise፣ mail ወይም reseller። | | Stack | አዎ | የሚገነባው ነገር፡ wordpress (ነባሪ)፣ woocommerce፣ php፣ static፣ node፣ one_click፣ headless_cms፣ nextcloud ወይም owncloud። | | Application | አይ | ለ one_click እና headless_cms ስታኮች ብቻ — የትኛው መተግበሪያ እንደሚጫን። በማንኛውም ሌላ ስታክ ላይ ስም መጥቀስ አይቀበለውም፣ ምክንያቱም ያ ስታክ አስቀድሞ የሚጫነውን ስለሚወስን። | | PHP version | አይ | ለምሳሌ 8.3። ለመስመሩ ነባሪ ባዶ ይተዉት። መስመሩ የማያቀርበው ሥሪት ከሚያቀርባቸው ዝርዝር ጋር ውድቅ ይደረጋል። | | Plan code | አዎ | ይህ ምርት የሚሸጠው የ Zinn® ፕላን። GET /v1/reseller/prices የእርስዎን ይዘረዝራል። ያለ እሱ የሚሰጥ ትዕዛዝ ውድቅ ይደረጋል — ከታች ያለውን ማስጠንቀቂያ ይመልከቱ። | | Billing interval | አይ | monthly (ነባሪ) ወይም annual — ለዚህ ደንበኛ የእርስዎ የጅምላ መስመር የሚነሳበት ክፍተት። ለራስዎ ደንበኛ የሚያስከፍሉት በ WHMCS ምርት ላይ የተዘጋጀ ነው እና አይነካም። |

⛔⛔ የፕላን ኮድ (Plan code) አስፈላጊ ነው፣ እና ያለ እሱ የሚሰጥ ትዕዛዝ ሆን ተብሎ ውድቅ ይደረጋል። እስከ 2026-09-01 ድረስ መስኩ ለጌጣጌጥ ነበር እና ምንም የሚያነበው ነገር አልነበረም፣ ስለዚህ ሞጁሉ ምንም ፕላን የሌለው ሆስቲንግ ያዝዝ ነበር — እና የዚያም እያንዳንዱ ውጤት ዝምተኛ ነበር። የጅምላ መግለጫዎ የተገነባው ከደንበኞችዎ የቀጥታ ምዝገባዎች በመሆኑ፣ ለአገልግሎቱ ምንም መስመር አልነበረም እና ሲሰራ በቆየበት ጊዜ ሁሉ ምንም አልተከፈሉበትም፤ ደንበኛዎ ምንም ፈቃዶችን አልወረሰም፣ ስለዚህ በጣቢያቸው ላይ ምንም የድስክ ወይም የፋይል ገደብ አልተተገበረም፤ እና Change Package የሚቀይረው ምንም ነገር አልነበረውም፣ ስለዚህ የሸጡት ማሻሻያ ሊከናወን አልቻለም። ጣቢያው ሙሉ በሙሉ ተዘጋጅቶ እና አገልግሎት ሲሰጥ ነበር።

ሞጁሉ አሁን የሚገምተው ደህንነቱ የተጠበቀ ፕላን ስለሌለ ትዕዛዙን ውድቅ ያደርጋል፡ መገመት እርስዎ ባልመረጡት እና ዋጋ ባልሰጡት ፕላን ላይ ሆስቲንግ ያዘጋጃል፣ እና — ወዲያውኑ ከሚያነቡት ውድቅ ማድረግ በተለየ — የሚወጣው መግለጫ ሲደርስ ብቻ ነው፣ ከተቻለ።

Auto Setup የሚለውን ወደሚመርጡት ያዘጋጁ — ሞጁሉ በ WHMCS አገልግሎት መታወቂያ ላይ አጥጋቢ ነው፣ ስለዚህ እንደገና የተሞከረ ዝግጅት ለሁለተኛ ጊዜ ክፍያ ከማስከፈል ይልቅ ያንኑ ጣቢያ ይመልሳል።

እያንዳንዱ የ WHMCS እርምጃ የሚያደርገው ነገር

| የ WHMCS እርምጃ | በእኛ በኩል የሚሆነው ነገር | | --------------------------- | ---------------------------------------------------------------------------------------- | | Create | የደንበኛውን የ Zinn® መለያ ይፈጥራል (ወይም አስቀድሞ ያላቸውን እንደገና ይጠቀማል) እና ጣቢያቸውን ያዘጋጃል። | | Suspend | ጣቢያውን ባለመክፈል እገዳ ላይ ያደርገዋል። ይዘቱ ይጠበቃል፤ ምንም የሚጠፋ ነገር የለም። | | Unsuspend | የእርስዎን እገዳ ያነሳል። | | Terminate | በችሮታ ጊዜ (grace period) የጣቢያውን መወገድ የጊዜ ሰሌዳ ይይዛል። ቀኑ በደንበኛ ቦታ ላይ ይታያል። | | Usage update | በቀን አንድ ጊዜ በእያንዳንዱ አገልግሎት ላይ ድስክን እና ባንድዊድዝ ያድሳል። | | Log in to hosting panel | ቀጥታ ወደ ደንበኛዎ ፓነል የሚያስገባ የአንድ ጊዜ፣ በአንድ አጠቃቀም የሚያበቃ የመግቢያ ሊንክ ይከፍታል። | | Change Package | አገልግሎቱን ያሻሽላል ወይም ያወርዳል። አዲሱ ምርት ስም የሚጥቅስ ከሆነ ፓኬጁን፣ እና የ PHP ሥሪቱን ያንቀሳቅሳል። | | Change Password | የWordPress አስተዳዳሪውን የይለፍ ቃል ያዘጋጃል። እንደዚህ ያለ መለያ በሌላቸው ስታኮች ላይ ሳጥኑ አይታይም። | | Renew | አገልግሎቱ አሁንም መኖሩን ያረጋግጣል። የ Zinn® ሆስቲንግ ቀጣይነት ያለው ነው፣ ስለዚህ የሚራዘም የሩቅ ጊዜ የለም። | | Sync Usage / Purge Cache / Take Backup | በአስተዳዳሪ አገልግሎት ገጽ ላይ ያሉ ቁልፎች። ደንበኛዎ በደንበኛ ቦታቸው ውስጥ Purge Cache እና Take Backup ያገኛሉ። | | Service tab | ሁኔታ፣ ፕላን፣ ድስክ፣ ባንድዊድዝ፣ ማንኛውም የታቀደ መወገድ፣ እና እገዳውን ማን እንዳስቀመጠው። | | Import | ListAccounts እያንዳንዱን ገጽ ያነባል፣ ስለዚህ ማስመጣት በመጀመሪያው ገጽ ላይ በዝምታ ሊቆም አይችልም። |

ማሻሻያዎች (Upgrades)፡ ማን ለማን ያስከፍላል

ደንበኛዎ በትዕዛዝ ወይም በማሻሻያ ላይ በ Zinn® በፍጹም አይከፈልም። እርስዎ በ WHMCS በኩል ያስከፍሏቸዋል፤ እኛ ደግሞ በጅምላ መግለጫዎ ላይ እናስከፍልዎታለን። ስለዚህ Change Package የደንበኛዎን መብቶች እና በሚቀጥለው መግለጫዎ ላይ ያለውን መስመር ያንቀሳቅሳል፣ እና ምንም ካርድ አይነካም — WHMCS አስቀድሞ የደንበኛዎን ገንዘብ ወስዷል እና የራሱን ተጣጣሚ ስሌት ሰርቷል።

የደንበኛ ሁለተኛ አገልግሎት። በዚያው ፕላን ላይ በዚያ ፕላን የራሱ የጣቢያ ፈቃድ ስር ያለ ሌላ ጣቢያ ነው፣ እና ሌላ ተጨማሪ ነገር አይሰጥም። በተለየ ፕላን ላይ ከሆነ ውድቅ ይደረጋል፡ የቀጥታ ፕላኑን መተካት ከሁለቱ አገልግሎቶች አንዱ ሳይከፈልበት እንዲቀር ያደርገዋል። ወይ ሁለቱንም በዚያው ፕላን ላይ ይሸጡ፣ ወይም ደንበኛውን በ WHMCS ውስጥ እንደተለየ የደንበኛ መዝገብ አድርገው ያዘጋጁት።

Change Password ለ WordPress ብቻ ነው ያለው። የ Zinn® ሆስቲንግ ምንም ዓይነት "የአገልግሎት የይለፍ ቃል" የለውም — ደንበኛዎ በመግቢያ ቁልፉ ወደ ፓነላቸው ይደርሳሉ — እና የ php ወይም static ጣቢያ ሊቀየር የሚችል የመተግበሪያ መለያ የለውም። WHMCS መስራት የማይችለውን ሳጥን ከማሳየት ይልቅ ሙሉ በሙሉ ይደብቀዋል።

ወደ ሁለት ማሳነስ የሌለብዎት ሶስት ምላሾች

• Unsuspend በውድቅነት ምላሽ ሊሰጥ ይችላል። ይህም ማለት ጣቢያው የታገደው በእኛ አላግባብ መጠቀምን በሚከታተለው ቡድን (abuse team) ነው እንጂ በእርስዎ አይደለም፣ እና ምንም የክፍያ ፓነል ሊለቀው አይችልም። መልእክቱ እንደዚያ ይላል፤ እንደገና ከመሞከር ይልቅ ለእርስዎ አስተዳዳሪ ያሳዩት።
• Terminate መወገድን ያቅዳል እንጂ አይፈጽምም። ቀኑ እንደ pending_deletion_at ሆኖ ይመለሳል እና የደንበኛ ቦታ ያሳየዋል። ለደንበኛ መረጃዎ አስቀድሞ ጠፍቷል ብሎ መናገር ምንም ካለመናገር የባሰ ነው።
• ድስክ እና ባንድዊድዝ ያልታወቁ ሊሆኑ ይችላሉ፣ እና ያልታወቀ ማለትዜሮ ማለት አይደለም። ንባብ መውሰድ ባልቻልንበት ጊዜ ሞጁሉ 0 ብሎ ከመጻፍ ይልቅ ቁጥሩን እንዳለ ይተወዋል — ካልሆነ WHMCS ምንም ንባብ ለሌለን ጣቢያ ለደንበኛዎ የሚያረጋጋ ባዶ የአጠቃቀም አሞሌ ያሳያል።

ችግሮችን መፍታት

Test Connection ያልፋል እና የመጀመሪያው ትዕዛዝ በፈቃድ ስህተት ይወድቃል። የ ኤፒአይ ቁልፉ org.create ይጎድለዋል። ሞጁሉ ጣቢያቸውን ከመፍጠሩ በፊት የደንበኛውን መለያ መክፈት አለበት።

ትዕዛዝ ድርጅቱ የሆስቲንግ ፕላን የለውም በሚል ምክንያት ይወድቃል። የዳግም ሻጭ ፕላንዎ ምንም የጣቢያ ፈቃድ አልቀረውም፣ ወይም ገና አልያዙም። ከላይ ያለውን ከመጀመርዎ በፊት ይመልከቱ።

ትዕዛዝ ስታክን በመጥቀስ ይወድቃል። በምርቱ ላይ ያለው የ Stack መስክ ባዶ ነው ወይም እኛ የማንገነባውን ነገር ይጠቅሳል። ሌላ ነገር የሚሸጡ ካልሆነ በስተቀር ወደ wordpress ያዘጋጁት።

መሰረዞች እየወደቁ ነው። በሞጁል ሥሪት 1.0.0 ወይም ከዚያ በኋላ ላይ መሆንዎን ያረጋግጡ። ቀደምት ግንባታዎች ምንም የማጥፊያ ማረጋገጫ አልላኩም እና እያንዳንዱ ማቋረጥ ውድቅ ተደርጓል፣ ይህም አገልግሎቱ እየሰራ እንዲቀጥል እና ክፍያ እንዲያስከፍል አድርጓል።

መስክን የሚጥቅስ ውድቅ ማድረግ። የእኛ የማረጋገጫ ስህተቶች መስኩን እና ምክንያቱን ከመልእክቱ በኋላ በቅንፍ ውስጥ ይጠቅሳሉ፣ ለምሳሌ (php_version: 7.2 is not offered on this product line)። እርምጃ ሊወሰድበት የሚችለው አጋማሽ እሱ ነው — ከፊቱ ያለው ዓረፍተ ነገር ሆን ተብሎ አጠቃላይ የተደረገ ነው።

ውርድዎን ያረጋግጡ

እያንዳንዱ መዝገብ ቤት ከራሳችን አስተናጋጅ ስም በ TLS በኩል አገልግሎት ይሰጣል እና በፍጹም ወደ ሦስተኛ ወገን አስተናጋጅ አይዞርም። የእሱ SHA-256 ቼክሰም በ ማውረጃ ገጽ ላይ ከማውረጃ ሊንኩ አጠገብ ታትሟል። ካወረዱ በኋላ ያወዳድሩት፡

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

በ WHMCS ላይ አይደሉም?

የ HostBill ሞጁል እና ለአንደኛውም ሌላ ነገር የሚሆን ባለአንድ-ፋይል PHP ደንበኛ አለ፣ ሁለቱም ነፃ እና ሁለቱም በዚያው ማውረጃ ገጽ ላይ ይገኛሉ። ሞጁሎቹ የሚጠቀሙበት እያንዳንዱ የመጨረሻ ነጥብ በ API reference ውስጥ ይገኛል።