Zinn Digital® модуль нь WHMCS-ийн товчлууруудыг манай платформ дээрх бодит үйлдлүүд болгон хувиргадаг. Захиалга хийгдмэгц таны харилцагчийн хостингийг бэлтгэж үүсгэнэ. WHMCS-ийн хугацаа хэтэрсэн нэхэмжлэхийн автоматжуулалт нь түүнийг түдгэлзүүлнэ. Нэхэмжлэхийг төлөгдсөнөөр тэмдэглэх үед түдгэлзүүлэлтийг цуцална. Захиалгыг цуцалснаар устгах хуваарьт оруулна. Мөн таны харилцагчийн хувийн хэсэгт тэднийг шууд нэвтрүүлдэг Log in to hosting panel товчлуур гарч ирнэ.
Энэ нь үнэ төлбөргүй, GPL-2.0-or-later лицензтэй бөгөөд манай платформ руу ямар нэгэн давуу эрхтэй тусгай холболт ашигладаггүй: түүний хийж буй дуудал бүр нь та өөрийн API түлхүүрээр бие даан гүйцэтгэх боломжтой баримтжуулсан эцсийн цэг (endpoint) байдаг.
Эхлэхээсээ өмнө
Танд хоёр зүйл шаардлагатай бөгөөд хоёр дахь дээр нь хүмүүс ихэвчлэн алддаг.
- Идэвхтэй хөтөлбөр бүхий Zinn® риселлерийн бүртгэл. 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 | Зэрэглэл ахиулахаас өмнө түүний зардал ямар байхыг унших. |
sites.manage | Товчлууруудаас кэшийг цэвэрлэх болон нөөц хуулбар хийх. |
sites.panel_access | WordPress администраторын нууц үгийг солих. |
hosting.php.manage | Зэрэглэл ахиулах эсвэл бууруулах үед PHP хувилбарыг солих. |
⛔ reseller.manage зөвшөөрлийг бүү олгоорой. Төлбөр тооцооны удирдлагын самбарт оруулсан түлхүүр нь төлбөр төлөөгүй харилцагчийг түр зогсоох болон тэднийг системд нэвтрүүлэх боломжтой байх ёстой. Энэ нь таны өөрийн төлбөрийн гарцын нууц мэдээллийг унших, өөрчлөх эрхтэй байж болохгүй. Илүү өндөр түвшний зөвшөөрөл олгох шаардлагагүй байлгах үүднээс reseller.provision эрх байдаг. ⛔ org.create нь сонголт биш. Үүнгүйгээр модуль нь таны бүртгэлүүдийг уншиж чадах боловч шинээр нээж чадахгүй тул Test Connection амжилттай болсон ч эхний захиалга 403 алдаа заана. ⛔⛔ Хүснэгтийн бүх эрхийг олгоорой, мөн хэрэв олгоогүй бол Test Connection үүнийг танд мэдэгдэж чадахгүй гэдгийг анхаарна уу. Энэ нь таны риселлерийн хөтөлбөрийг уншиж, ямар ч үйлчилгээ үүсгэдэггүй тул эдгээрийн аль нэг нь дутуу байсан ч ногоон өнгөөр харуулдаг. Харин оронд нь хэдэн сарын дараа аль нэг хэрэглэгч дээр дутуу зөвшөөрөлтэй холбоотой үйлдэл хийгдэх үед л 403 алдаа гарч ирэх болно.
2. Модулийг суулгах
- Модулийг татаж аваад архивыг задална уу.
- Модулийн файл
modules/servers/zinn/zinn.php байршилд очихоор zinn хавтсыг өөрийн WHMCS суулгац руу хуулна уу.
⛔ Хавтасны нэр заавал zinn байх ёстой. WHMCS нь үйлчилгээ бэлтгэх модулийн функцийн нэрсийг түүний хавтасны нэрнээс үүсгэдэг тул үүнийг zinn-whmcs эсвэл zinndigital болгон өөрчилбөл WHMCS жагсаалтад харуулж, сонгох боломж олгох боловч дараа нь хэзээ ч дуудахгүй — тэгээд ямар ч алдаа заахгүй. Zip архив нь аль хэдийн зөв нэрээр задардаг тул нэрийг нь бүү өөрчлөөрэй.
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 (managed 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 үйлчилгээний id дээр идемпотент тул үйлчилгээг дахин бэлтгэх оролдлого нь танаас хоёр дахь төлбөрийг авалгүйгээр тухайн сайтыг хэвээр нь буцаана.
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 шалгах нийлбэр нь татаж авах хуудас дээрх татах холбоосын хажууд бичигдсэн байдаг. Татаж авсныхаа дараа үүнийг харьцуулж шалгаарай:
- 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 хэсгээс харах боломжтой.