የZinn Digital® ሞጁል የWHMCSን የራሱን አዝራሮች በመድረካችን ላይ ወደ እውነተኛ እርምጃዎች ይቀይራቸዋል። ትዕዛዝ የደንበኛዎትን ሆስቲንግ ያዘጋጃል። የWHMCS ያለፈበት-ደረሰኝ አውቶሜሽን ያግደዋል። ደረሰኙ እንደተከፈለ ምልክት ማድረግ እገዳውን ያነሳዋል። መሰረዝ ደግሞ የመሰረዝ መርሐግብር ይይዛል። እንዲሁም ደንበኛዎ በቀጥታ የሚያስገባውን Log in to hosting panel የሚል አዝራር በደንበኛ ክፍላቸው ውስጥ ያገኛሉ።
ነፃ ነው፣ በGPL-2.0-or-later ፈቃድ የተሰጠው ነው፣ እና ወደ መድረካችን ምንም ዓይነት ልዩ መብት ያለው መንገድ የለውም፡ የሚያደርገው እያንዳንዱ ጥሪ እርስዎ በራስዎ የAPI ቁልፍ ሊያደርጉት የሚችሉት በሰነድ የተደገፈ የመጨረሻ ነጥብ (endpoint) ነው።
ከመጀመርዎ በፊት
ሁለት ነገሮች ያስፈልጉዎታል፣ እና ሁለተኛው ብዙዎችን ያደናቅፋል።
- ንቁ ፕሮግራም ያለው የZinn® ዳግም ሻጭ (reseller) መለያ። በzinndigital.com ይመዝገቡ እና ዳግም መሸጥን ያብሩ።
- የሳይት ገደብ ያለው የዳግም ሻጭ ፕላን። ደንበኞችዎ የሚያዟቸው ሳይቶች የሚቆጠሩት ከእርስዎ ፕላን ላይ ስለሆነ፣ በቂ ቦታ ያለው ያስፈልግዎታል።
⚠️ Test Connection ትዕዛዝ መሳካት አለመሳካቱን ሊነግርዎት አይችልም። ፕሮግራምዎን ያነባል እንጂ ምንም ነገር አያዘጋጅም፣ ስለዚህ እስካሁን ምንም መሸጥ የማይችል ጤናማ active መለያ እንደሆነ ሪፖርት ያደርጋል። የመጀመሪያው ትዕዛዝዎ "This organization has no hosting plan, so it cannot host a site yet" በሚል ካልተሳካ፣ የሆነው ይሄው ነው — የዳግም ሻጭ ፕላንዎን ይግዙ ወይም ያራዝሙ እና ትዕዛዙን እንደገና ያስገቡ። በሞጁሉ ላይ ምንም ችግር የለም።
1. የAPI ቁልፉን ይፍጠሩ
በእርስዎ Zinn® ዳሽቦርድ ውስጥ API keys የሚለውን ይክፈቱ እና በትክክል እነዚህን አስራ አንድ ፈቃዶች የያዘ አንዱን ይፍጠሩ፡
| ፈቃድ | ለምን እንደሚያስፈልግ |
|---|
org.create | በመጀመሪያው ትዕዛዛቸው ላይ የደንበኛዎን የZinn® መለያ ለመክፈት። |
org.read | የደንበኛዎን መለያዎች ለማንበብ። |
sites.create | ሳይቱን ለማዘጋጀት። |
sites.view | አገልግሎትን እና አጠቃቀሙን ለማንበብ። |
sites.delete | ለማቋረጥ። |
reseller.view | የሸጡትን ለመዘርዘር፣ እና ዲስክን እና የመተላለፊያ ይዘትን ለማንበብ። |
reseller.provision | ለማገድ፣ እገዳ ለማንሳት፣ ደንበኛን ለማስገባት፣ ፕላናቸውን ለመወሰን እና ፓኬጃቸውን ለመቀየር። |
billing.view | ከማከናወንዎ በፊት የማሻሻያ (upgrade) ዋጋ ምን ያህል እንደሚሆን ለማንበብ። |
sites.manage | ከአዝራሮቹ ላይ መሸጎጫን (cache) ለማጽዳት እና መጠባበቂያ (backup) ለመውሰድ። |
sites.panel_access | የWordPress አስተዳዳሪውን የይለፍ ቃል ለመቀየር። |
hosting.php.manage | በማሻሻል ወይም በማውረድ ጊዜ የPHP ሥሪትን ለመቀየር። |
⛔ reseller.manage ፈቃድን አይስጡ። ወደ የክፍያ ፓነል የተለጠፈ ቁልፍ ክፍያ ባለመፈጸሙ ምክንያት ደንበኛን ማገድ እና ማስገባት መቻል አለበት። የእራስዎን የክፍያ መግቢያ (payment-gateway) ምስክርነቶች ማንበብ እና እንደገና መጻፍ መቻል የለበትም። ትልቁን ፈቃድ መስጠት እንዳያስፈልግዎ reseller.provision አለ። ⛔ org.create እንደ አማራጭ የሚታይ አይደለም። ያለ እሱ ሞጁሉ መለያዎችዎን ማንበብ ይችላል ነገር ግን መክፈት አይችልም፣ ስለዚህ Test Connection ያልፋል እና የመጀመሪያው ትዕዛዝ 403 የሚል ምላሽ ይሰጣል። ⛔⛔ ሙሉውን ሰንጠረዥ ይፍቀዱ፣ እና ካልፈቀዱ Test Connection ሊነግርዎት እንደማይችል ልብ ይበሉ። የዳግም ሻጭ ፕሮግራምዎን ያነባል እንጂ ምንም ነገር አያዘጋጅም፣ ስለዚህ ከእነዚህ ውስጥ አንዱ እንኳን ለጎደለው ቁልፍ አረንጓዴ ያሳያል። በምትኩ የሚያገኙት ከወራት በኋላ በጎደለው ፈቃድ በሚሸፈነው በአንዱ ክንውን ላይ ከደንበኛ የሚመጣ 403 ነው።
2. ሞጁሉን ይጫኑ
- ሞጁሉን ያውርዱ እና ዚፑን ይክፈቱት።
- የሞጁሉ ፋይል በ
modules/servers/zinn/zinn.php ላይ እንዲቀመጥ የzinn ዳይሬክተሪውን ወደ እርስዎ የWHMCS ጭነት ይስቀሉ።
⛔ ዳይሬክተሪው zinn ተብሎ መጠራት አለበት። WHMCS የማዘጋጃ ሞጁልን የተግባር ስሞች ከዳይሬክተሪው ስም ስለሚወስድ፣ ስሙን ወደ zinn-whmcs ወይም zinndigital መቀየር WHMCS የሚዘረዝረውን፣ እንዲመርጡት የሚፈቅድልዎትን፣ እና ከዚያ በኋላ ፈጽሞ የማይጠራውን ሞጁል ያስከትላል — በየትኛውም ቦታ ምንም ስህተት ሳያሳይ። ዚፑ አስቀድሞ ወደ ትክክለኛው ስም ይከፈታል፤ ስሙን አይቀይሩት ብቻ።
3. ሰርቨሩን ያክሉ
በWHMCS ውስጥ፡ Configuration → System Settings → Servers → Add New Server።
- Name፡ ማንኛውም፣ ለምሳሌ
Zinn Digital®
- Hostname፡
api.zinndigital.com
- Type፡
Zinn Digital®
- Password፡ ከደረጃ 1 ያገኙት የAPI ቁልፍዎ
⛔ ቁልፉ WHMCS በምስጢር የተመሰጠረ አድርጎ በሚያስቀምጠው በPassword መስክ ውስጥ ይገባል። በምርት ማዋቀሪያ አማራጭ ውስጥ አያስቀምጡት — እነዚያ በመረጃ ቋቱ ውስጥ ግልጽ ጽሑፍ ናቸው እና ለእያንዳንዱ አስተዳዳሪ ይታያሉ፣ ይህ ምስክርነት ደግሞ የደንበኞችዎትን ሆስቲንግ መፍጠር እና ማጥፋት ይችላል።
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 ምርት ላይ የተዘጋጀ ሲሆን ምንም ተጽዕኖ አይደርስበትም። |
⛔⛔ የፕላን ኮድ ያስፈልጋል፣ እና ያለ እሱ ያለ ትዕዛዝ ሆን ተብሎ ውድቅ ይደረጋል። እስከ 2026-09-01 ድረስ መስኩ ለውበት ብቻ የነበረ እና የሚያነበው ነገር ያልነበረ በመሆኑ፣ ሞጁሉ ምንም ፕላን የሌለው ሆስቲንግ አዟል — እና የዚህ እያንዳንዱ መዘዝ ድምፅ አልባ ነበር። የጅምላ ሂሳብ መግለጫዎ የሚዘጋጀው ከደንበኞችዎ ቀጥታ ምዝገባዎች በመሆኑ፣ ለአገልግሎቱ ምንም መስመር አልነበረም እና አገልግሎቱ እስከተሰራበት ጊዜ ድረስ ምንም አልተከፈለዎትም፤ ደንበኛዎ ምንም አይነት አበል ስላልወረሱ፣ ለሳይታቸው ምንም አይነት የዲስክ ወይም የፋይል ኮታ አልተተገበረም፤ እና Change Package የሚቀይረው ምንም ነገር አልነበረውም፣ ስለዚህ የሸጡት ማሻሻያ ሊከናወን አልቻለም። ሳይቱ በሙሉ ጊዜው ተዘጋጅቶ ያለምንም እንከን አገልግሏል።
ሞጁሉ ለመገመት የሚያስችል አስተማማኝ ፕላን ስለሌለው አሁን በምትኩ ትዕዛዙን ውድቅ ያደርጋል፡ ግምት እርስዎ ባልመረጡት እና ዋጋ ባልሰጡት ፕላን ላይ ሆስቲንግን ያዘጋጃል፣ እና — ወዲያውኑ ከሚያነቡት ውድቅ መደረግ በተለየ መልኩ — ሂሳብ መግለጫ ሲመጣ ብቻ ነው የሚታወቀው፣ ከመጣም።
Auto Setup ወደሚመርጡት ያቀናብሩ — ሞጁሉ በWHMCS አገልግሎት መታወቂያ ላይ ተደጋጋሚ ያልሆነ (idempotent) ነው፣ ስለዚህ እንደገና የተሞከረ ዝግጅት ለሁለተኛ ጊዜ ክፍያ ከማስከፈል ይልቅ ያንኑ ሳይት ይመልሳል።
እያንዳንዱ የWHMCS እርምጃ ምን ይሰራል
| የWHMCS እርምጃ | በእኛ በኩል ምን ይከሰታል |
|---|
| Create | የደንበኛውን የZinn® መለያ ይፈጥራል (ወይም አስቀድመው ያላቸውን እንደገና ይጠቀማል) እና ሳይታቸውን ያዘጋጃል። |
| Suspend | ክፍያ ባለመፈጸሙ ምክንያት ሳይቱን በእግድ ላይ ያደርገዋል። ይዘቱ እንደተጠበቀ ይቆያል፤ ምንም ነገር አይሰረዝም። |
| Unsuspend | የእርስዎን እገዳ ያነሳል። |
| Terminate | የችሮታ ጊዜ በመስጠት የሳይቱን መሰረዝ መርሐግብር ይይዛል። ቀኑ በደንበኛ ክፍል ውስጥ ይታያል። |
| 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 እያንዳንዱን ገጽ ያነባል፣ ስለዚህ ማስመጣት በመጀመሪያው ላይ በዝምታ ሊቆም አይችልም። |
ማሻሻያዎች፡ ማን ማንን ያስከፍላል
በትዕዛዝም ሆነ በማሻሻያ ላይ ደንበኛዎ በZinn® ፈጽሞ አይከፈለውም። እርስዎ በWHMCS በኩል ያስከፍሏቸዋል፤ እኛ በጅምላ ሂሳብ መግለጫዎ ላይ እናስከፍልዎታለን። ስለዚህ Change Package የደንበኛዎን መብቶች እና በሚቀጥለው መግለጫዎ ላይ ያለውን መስመር ያዛውራል፣ እና ምንም ካርድ አይነካም — WHMCS አስቀድሞ የደንበኛዎን ገንዘብ ወስዶ የራሱን ተመጣጣኝ ክፍያ አስልቷል።
የአንድ ደንበኛ ሁለተኛ አገልግሎት። በተመሳሳይ ፕላን ላይ በዚያ ፕላን የሳይት አበል ስር ያለ ሌላ ሳይት ነው፣ እና ምንም ተጨማሪ ነገር አይሰጥም። በተለየ ፕላን ላይ ግን ተቀባይነት የለውም፡ የቀጥታ ፕላኑን መተካት ከሁለቱ አገልግሎቶች አንዱ ሳይከፈልበት እንዲቀር ያደርጋል። ወይ ሁለቱንም በአንድ ፕላን ላይ ይሽጡ፣ ወይም ደንበኛውን በWHMCS ውስጥ እንደ የተለየ የደንበኛ መዝገብ ያዋቅሩት።
Change Password ለWordPress ብቻ ነው ያለው። የZinn® ሆስቲንግ አንድ ነጠላ "የአገልግሎት ይለፍ ቃል" የለውም — ደንበኛዎ በመግቢያ አዝራሩ አማካኝነት ወደ ፓነላቸው ይደርሳሉ — እና የphp ወይም static ሳይት የሚቀየር የመተግበሪያ መለያ የለውም። WHMCS የማይሰራውን ከማሳየት ይልቅ ሳጥኑን ሙሉ በሙሉ ይደብቀዋል።
ወደ ሁለት ማሳነስ የሌለብዎት ሦስት መልሶች
- Unsuspend በውድቅነት ምላሽ ሊሰጥ ይችላል። ያ ማለት ሳይቱ የታገደው በደል መቆጣጠሪያ ቡድናችን እንጂ በእርስዎ አይደለም፣ እና ምንም አይነት የክፍያ ፓነል ሊያነሳው አይችልም። መልእክቱ ይህንኑ ይገልጻል፤ እንደገና ከመሞከር ይልቅ ለአስተዳዳሪዎ ያሳዩት።
- Terminate የመሰረዝ መርሐግብር ይይዛል እንጂ አያከናውንም። ቀኑ እንደ
pending_deletion_at ሆኖ ይመለሳል እና የደንበኛ ክፍሉ ያሳየዋል። መረጃቸው ገና ባልጠፋበት ጊዜ ጠፍቷል ብሎ ለደንበኛ መንገር ምንም ካለመንገር የከፋ ነው።
- ዲስክ እና የመተላለፊያ ይዘት ያልታወቁ ሊሆኑ ይችላሉ፣ እና ያልታወቀ ማለት ዜሮ ማለት አይደለም። ንባብ መውሰድ ባልቻልንበት ጊዜ ሞጁሉ
0 ብሎ ከመጻፍ ይልቅ ቁጥሩን እንዳለ ይተወዋል — አለበለዚያ WHMCS ምንም ንባብ ለሌለን ሳይት ለደንበኛዎ አሳሳች የሆነ ባዶ የአጠቃቀም አሞሌ ያሳይ ነበር።
መላ መፈለግ
Test Connection ያልፋል እና የመጀመሪያው ትዕዛዝ በፈቃድ ስህተት አይሳካም። የAPI ቁልፉ org.create የለውም። ሞጁሉ የደንበኛውን ሳይት ከመፍጠሩ በፊት መለያቸውን መክፈት አለበት።
ድርጅቱ ምንም የሆስቲንግ ፕላን የለውም በማለት ትዕዛዝ አይሳካም። የዳግም ሻጭ ፕላንዎ የቀረ የሳይት አበል የለውም፣ ወይም እስካሁን አልያዙም። ከላይ ያለውን ከመጀመርዎ በፊት ይመልከቱ።
ስታክን በመጥቀስ ትዕዛዝ አይሳካም። በምርቱ ላይ ያለው የStack መስክ ባዶ ነው ወይም እኛ የማንገነባውን ነገር ይጠቅሳል። ሌላ ነገር ካልሸጡ በስተቀር ወደ wordpress ያቀናብሩት።
ስረዛዎች እየከሸፉ ነው። በሞጁል ሥሪት 1.0.0 ወይም ከዚያ በኋላ ላይ መሆንዎን ያረጋግጡ። የቀደሙት ግንባታዎች ምንም ዓይነት የስረዛ ማረጋገጫ አልላኩም እና እያንዳንዱ ማቋረጥ ውድቅ ተደርጓል፣ ይህም አገልግሎቱ እንዲቀጥል እና ክፍያ እንዲጠይቅ አድርጓል።
መስክን የሚሰይም ውድቅ መደረግ። የእኛ የማረጋገጫ ስህተቶች ከመልእክቱ በኋላ በቅንፍ ውስጥ መስኩን እና ምክንያቱን ይጠቅሳሉ፣ ለምሳሌ (php_version: 7.2 is not offered on this product line)። ያ እርምጃ ሊወሰድበት የሚችለው ግማሽ ነው — ከፊቱ ያለው ዓረፍተ ነገር ሆን ተብሎ አጠቃላይ የተደረገ ነው።
ያወረዱትን ያረጋግጡ
እያንዳንዱ ማህደር በእኛ የራሳችን የአስተናጋጅ ስም በTLS በኩል የሚቀርብ ሲሆን ወደ ሶስተኛ ወገን አስተናጋጅ በጭራሽ አይዛወርም። የSHA-256 ቼክሰሙ (checksum) በየማውረጃ ገጹ ላይ ከማውረጃው አገናኝ ጎን ታትሟል። ካወረዱ በኋላ ያወዳድሩት፡
- 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 ማጣቀሻ ውስጥ ይገኛሉ።