د Zinn Digital® ماډیول د WHMCS خپلې بټنې زموږ پر پلاتفارم په واقعي کړنو بدلوي. یو آرډر ستاسو د پېرودونکي هوسټېنګ چمتو کوي. د ناورکړل شوي بل د اتوماتیک پروسې له لارې WHMCS هغه ځنډوي (معطل کوي). د بل ورکړل شوی نښه کول هغه بېرته فعالوي. لغوه کول د ړنګولو مهالوېش ټاکي. او ستاسو پېرودونکی په خپله کارن-سیمه (client area) کې د Log in to hosting panel یوه بټنه ترلاسه کوي چې نېغ په نېغه یې ننه باسي.
دا وړیا دی، د GPL-2.0-or-later لاندې جواز لري، او زموږ پلاتفارم ته هېڅ ډول امتیاز لرونکې لاره نه لري: هر غوښتنه چې دا یې کوي یو مستند شوی endpoint دی چې تاسې پخپله هم کولی شئ د خپل API key په کارولو سره یې ترسره کړئ.
مخکې له دې چې پیل وکړئ
تاسې دوو شیانو ته اړتیا لرئ، او دویم شی اکثره خلک تېرباسي.
- د یو فعال پروګرام لرونکی د Zinn® ریسېلر ګڼون. په zinndigital.com کې نوملیکنه وکړئ او بیا پلورنه فعاله کړئ.
- د سایټونو د ظرفیت (site allowance) لرونکی د ریسېلر پلان. کوم سایټونه چې ستاسو پېرودونکي یې آرډر کوي، ستاسو له خپل پلان څخه حسابېږي، نو تاسې داسې یو پلان ته اړتیا لرئ چې خالي ځای پکې وي.
⚠️ د Test Connection دا نشي ویلای چې ایا یو آرډر به بریالی شي که نه. دا ستاسو پروګرام لولي او هېڅ شی نه چمتو کوي، نو د یو داسې روغ active ګڼون راپور ورکوي چې لا تر اوسه هېڅ شی نشي پلورلی. که ستاسو لومړنی آرډر له دې تېروتنې سره ناکام شي چې "This organization has no hosting plan, so it cannot host a site yet"، نو همدا خبره رامنځته شوې ده — خپل د ریسېلر پلان وپېرئ یا یې وغځوئ او آرډر بیا ورکړئ. په ماډیول کې هېڅ کومه ستونزه نشته.
۱. د API کیلي جوړه کړئ
په خپل Zinn® ډېشبورډ کې، API keys پرانیزئ او د پوره همدغو یوولسو اجازو لرونکې کیلي جوړه کړئ:
| اجازه | ولې ورته اړتیا ده |
|---|
org.create | د پېرودونکي په لومړي آرډر کې د هغوی د Zinn® ګڼون پرانیستل. |
org.read | ستاسو د پېرودونکو د ګڼونونو لوستل. |
sites.create | د سایټ چمتو کول. |
sites.view | د یو خدمت او د هغې د کارونې لوستل. |
sites.delete | ختمول (له منځه وړل). |
reseller.view | د هغه څه لیست کول چې پلورلي مو دي، او د ډېسک او بینډوېډت لوستل. |
reseller.provision | ځنډول، بېرته فعالول، د پېرودونکي ننه ایستل، د هغوی پلان ټاکل او د هغوی بسته بدلول. |
billing.view | د اپګرېډ له ترسره کولو وړاندې د هغه د لګښت لوستل. |
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 تېروتنه ده چې ورکه شوې اجازې پوښله.
۲. د ماډیول لګول (انسټالول)
۱. ماډیول ډاونلوډ کړئ او له زپ (unzip) څخه یې وباسئ. ۲. د zinn ډایرکټري په خپل WHMCS انسټالیشن کې پورته (اپلوډ) کړئ، ترڅو د ماډیول فایل دلته ځای پر ځای شي: modules/servers/zinn/zinn.php.
⛔ ډایرکټري باید خامخا د zinn په نوم ونومول شي. WHMCS د یوه چمتو کوونکي ماډیول د فنکشنونو نومونه د هغې د ډایرکټرۍ له نوم څخه اخلي، نو د هغې نوم zinn-whmcs یا zinndigital ته بدلول د داسې ماډیول لامل کېږي چې WHMCS یې لیست کوي، تاسې ته د غوره کولو اجازه درکوي، خو وروسته یې هېڅکله نه غواړي (نه یې چلوي) — پرته له دې چې هېڅ تېروتنه وښيي. زپ فایل لا دمخه په سم نوم راوځي؛ یوازې نوم یې مه بدلوئ.
۳. د سرور ورزیاتول
په WHMCS کې: Configuration ← System Settings ← Servers ← Add New Server.
- Name: هر څه، مثلاً
Zinn Digital®
- Hostname:
api.zinndigital.com
- Type:
Zinn Digital®
- Password: ستاسو د لومړي ګام څخه د API کیلي
⛔ دا کیلي د Password په ډګر (field) کې ځي، کوم چې WHMCS په کوډ شوې (encrypted) بڼه ساتي. دا د محصول په ترتیباتي انتخابونو (configuration options) کې مه ږدئ — دا په ډیټابیس کې په ساده متن وي او هر اډمین ته ښکاري، او دا اسناد کولی شي ستاسو د پېرودونکو هوسټېنګ جوړ او له منځه یوسي.
د Test Connection تڼۍ کېکاږئ. دا یو ریښتینی کال (غوښتنه) ترسره کوي او د ډګرونو د ډکوالي د چک پر ځای، راپور ورکوي چې زموږ پلاتفارم څه ځواب ورکړ.
۴. د محصول جوړول
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 پورې دا ډګر تزییني و او هېڅ شي نه لوست، نو ماډیول داسې هوسټېنګ آرډر کاوه چې هېڅ پلان یې نه درلود — او د دې هرې پایلې خاموشه بڼه درلوده. ستاسو د عمده پلور صورتحساب (wholesale statement) ستاسو د پېرودونکو له ژوندیو ګډونونو څخه جوړېږي، نو د دې خدمت لپاره هېڅ برخه نه وه او تر څو چې دا چالان و له تاسې څخه هېڅ بل نه اخیستل کېده؛ ستاسو پېرودونکي ته هېڅ ظرفیت په میراث ونه رسېد، نو د هغوی په سایټ هېڅ د ډېسک یا فایل کوټه عملي نه شوه؛ او Change Package هېڅ د بدلولو شی نه درلود، نو هغه اپګرېډ چې تاسې پلورلی و نشو ترسره کېدای. سایټ په ټوله موده کې په بشپړ ډول فعال او خدمات وړاندې کول.
ماډیول اوس د دې پر ځای آرډر ردوي، ځکه چې د اټکل لپاره هېڅ خوندي پلان نشته: یو اټکل به په داسې پلان باندې هوسټېنګ چمتو کړي چې تاسې نه وي غوره کړی او ممکن بیه مو ورته نه وي ټاکلې، او — د ردېدو پر خلاف، چې تاسې سمدستي ترې خبرېږئ — دا به یوازې هغه وخت ښکاره شي چې کله یو صورتحساب راشي، که چېرې راشي.
د Auto Setup تنظیم هر یوه ته چې غوره ګڼئ وټاکئ — ماډیول د WHMCS service id باندې بېاغېزې (idempotent) دی، نو یو بیا هڅه شوی چمتووالی ورته سایټ بېرته راګرځوي، نه دا چې د دویم لپاره له تاسې پیسې واخلي.
د WHMCS هر اقدام څه کوي
| د WHMCS اقدام | زموږ په لور څه پېښېږي |
|---|
| Create | د پېرودونکي Zinn® ګڼون جوړوي (یا هغه کاروي چې دوی یې لا دمخه لري) او د هغوی سایټ چمتو کوي. |
| Suspend | سایټ د پیسو نه ورکړې په تعلیق کې اچوي. محتوا ساتل کېږي؛ هېڅ شی نه ړنګېږي. |
| Unsuspend | ستاسو تعلیق لیرې کوي. |
| Terminate | د سایټ د ړنګولو مهالوېش ټاکي، د مهلت له یوې دورې سره. نېټه په کارن-سیمه (client area) کې ښکاري. |
| Usage update | په هر خدمت باندې په ورځ کې یو ځل ډېسک او بینډوېډت نوي کوي. |
| Log in to hosting panel | نېغ په نېغه ستاسو د پېرودونکي پینل ته یو ځل کارېدونکی د ننوتلو لینک پرانیزي. |
| Change Package | خدمت اپګرېډ یا ډاونګرېډ کوي. بسته لېږدوي، او د PHP نسخه هم که نوی محصول د هغې نوم واخلي. |
| Change Password | د WordPress د مدیر (administrator) پاسورډ ټاکي. دا بکس په هغو سټیکونو کې نه ښکاري چې دا ډول ګڼون نه لري. |
| Renew | تاییدوي چې خدمت لا هم شتون لري. د Zinn® هوسټېنګ دوامدار دی، نو د غځولو لپاره کومه لیرې موده نشته. |
| Sync Usage / Purge Cache / Take Backup | د اډمین خدمت په پاڼه کې بټنې. ستاسو پېرودونکی په خپله کارن-سیمه کې Purge Cache او Take Backup ترلاسه کوي. |
| Service tab | وضعیت، پلان، ډېسک، بینډوېډت، هر ټاکل شوی ړنګول، او دا چې تعلیق د چا لخوا لګول شوی. |
| Import | ListAccounts هره پاڼه لولي، نو واردول نشي کولی په لومړۍ پاڼه کې په ناڅاپي ډول ودرېږي. |
اپګرېډونه: څوک له چا لګښت اخلي
ستاسو له پېرودونکي څخه هېڅکله د Zinn® لخوا، نه په آرډر او نه په اپګرېډ کې پیسې نه اخیستل کېږي. تاسې هغوی ته د WHMCS له لارې بل ورکوئ؛ موږ ستاسو د عمده پلور په صورتحساب کې له تاسې لګښت اخلو. نو د Change Package ستاسو د پېرودونکي امتیازات او ستاسو په راتلونکي صورتحساب کې برخه بدلوي، او هېڅ کارت ته لاس نه وهي — WHMCS لا دمخه ستاسو د پېرودونکي پیسې اخیستې او خپل تناسب (proration) یې محاسبه کړی دی.
د یو پېرودونکي دویم خدمت. په ورته پلان کې، دا د هغه پلان د خپل سایټ د ظرفیت لاندې بل سایټ دی، او نور څه نه ورکول کېږي. په بل پلان باندې، دا ردېږي: د فعال پلان بدلول به له دواړو خدماتو څخه یو بېبله پرېږدي. یا دواړه په ورته پلان وپلورئ، یا پېرودونکی په WHMCS کې د یو جلا پېرودونکي په توګه ثبت کړئ.
د Change Password یوازې د WordPress لپاره شتون لري. د Zinn® هوسټېنګ هېڅ یو واحد "د خدمت پاسورډ" نه لري — ستاسو پېرودونکی د ننوتلو په تڼۍ سره خپل پینل ته رسېږي — او یو php یا static سایټ د بدلولو لپاره د اپلیکیشن هېڅ ګڼون نه لري. WHMCS د دې پر ځای چې داسې یو بکس وښيي چې کار نشي کولی، هغه په بشپړه توګه پټوي.
درې ځوابونه چې باید په دوو کې سره ګډ نشي
- د Unsuspend کولی شي په یوه رد ځواب ورکړي. دا په دې مانا ده چې سایټ زموږ د ناوړه ګټې اخیستنې د مخنیوي (abuse) ډلې لخوا ځنډول شوی، نه ستاسو لخوا، او هېڅ بلېنګ پینل نشي کولی هغه بېرته خلاص کړي. پیغام همدا وايي؛ د بیا هڅه کولو پر ځای دا خپل اډمین ته وښایاست.
- د Terminate یو ړنګول مهالوېش کوي، دا سمدستي نه ترسره کوي. نېټه د
pending_deletion_at په توګه بېرته راګرځي او کارن-سیمه یې ښيي. یو پېرودونکي ته ویل چې د هغوی ډاټا لا دمخه ورکه شوې ده کله چې داسې نه وي، تر دې بدتره ده چې هغوی ته هېڅ ونه ویل شي.
- ډېسک او بینډوېډت نامعلوم کېدای شي، او نامعلوم صفر نه دی. کله چې موږ ونشو کړای ارزښت ولولو، ماډیول د دې پر ځای چې
0 ولیکي دا شمېره نه بدلوي — که نه نو WHMCS به ستاسو پېرودونکي ته د هغه سایټ لپاره د کارونې خالي اطمینانبښونکی پټه وښيي چې موږ ترې هېڅ معلومات نه لرو.
ستونزې هوارول
د Test Connection تېرېږي خو لومړنی آرډر د اجازې له تېروتنې سره ناکامېږي. د API کیلي org.create نه لري. ماډیول باید مخکې له دې چې د هغوی سایټ جوړ کړي د پېرودونکي ګڼون پرانیزي.
یو آرډر له دې پیغام سره ناکامېږي چې اداره د هوسټېنګ پلان نه لري. ستاسو د ریسېلر پلان د سایټونو هېڅ پاتې ظرفیت نه لري، یا تاسې لا تر اوسه یو هم نه لرئ. پورته مخکې له دې چې پیل وکړئ وګورئ.
یو آرډر د سټیک په یادولو سره ناکامېږي. په محصول کې د Stack ډګر خالي دی یا د داسې څه نوم اخلي چې موږ یې نه جوړوو. دا په wordpress وټاکئ، مګر دا چې تاسې کوم بل څه پلورئ.
لغوه کول ناکامېږي. ډاډ ترلاسه کړئ چې تاسې د ماډیول په 1.0.0 یا وروستۍ نسخه کې یاست. پخوانیو نسخو د ړنګولو هېڅ تایید نه استاوه او هر ختمول (termination) ردېده، چې له امله یې خدمت فعال پاتې کېده او لګښت پرې راتله.
یو ردېدل چې د یوه ډګر نوم اخلي. زموږ د اعتبار تېروتنې (validation errors) له پیغام وروسته په قوسونو کې د ډګر نوم او لامل ښيي، مثلاً (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 کلائنټ شتون لري، دواړه وړیا او دواړه د ډاونلوډونو په همدې پاڼه کې دي. هر endpoint چې ماډیولونه یې کاروي په API reference کې شتون لري.