د WHMCS څخه د Zinn® هوسټینګ وپلورئ

د Zinn Digital® ماډول د WHMCS خپل بټنونه زموږ په پلیټ فارم کې په حقیقي کړنو بدلوي. یو آرډر ستاسو د پیرودونکي کوربه توب فعالوي. د WHMCS له وخته وتلي انوائس اتومات کول هغه معطلوي. د انوائس د ورکړل شوي په توګه نښه کول هغه بیرته فعالوي. لغوه کول یې د حذف کولو مهالویش ټاکي. او ستاسو پیرودونکی په خپله پیرودونکي ساحه کې د د کوربه توب پینل ته ننوځئ بټن ترلاسه کوي چې هغوی په مستقیم ډول ننباسي.

دا وړیا دی، د GPL-2.0-or-later تر لیسانس لاندې دی، او زموږ پلیټ فارم ته هیڅ ځانګړې لاره نه لري: هر غوښتنه چې دا یې کوي یوه مستنده شوې انډپواینټ ده چې تاسو یې په خپله د خپل API کیلي سره کولی شئ.

مخکې له دې چې پیل وکړئ

تاسو دوو شیانو ته اړتیا لرئ، او دوهم شی خلک غلطۍ ته باسي.

1. د فعال پروګرام سره د Zinn® ریډیلر حساب. په zinndigital.com کې نوم لیکنه وکړئ او بیا پلورل فعال کړئ.
2. د سایټ تخصیص سره د ریډیلر پلان. هغه سایټونه چې ستاسو پیرودونکي یې آرډر کوي ستاسو د پلان حساب ته حسابیږي، نو تاسو داسې یو پلان ته اړتیا لرئ چې خالي ځای ولري.

⚠️ 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 | کیش پاک کړئ او د بټنو څخه بیک اپ واخلئ. | | sites.panel_access | د WordPress مدیر پټنوم بدل کړئ. | | hosting.php.manage | په ارتقا یا تنزیل کې د PHP نسخه بدله کړئ. |

⛔ reseller.manage اجازه مه ورکوئ. یوه کیلي چې د بلینګ پینل کې پیسټ شوې وي باید وکولی شي یو پیرودونکی د نه تادیې له امله ودروی او هغوی دننه کړي. دا باید ونه کولی شي ستاسو د تادیې د ګیټ وی اسناد ولولي او بیا یې ولیکي. reseller.provision د دې لپاره شتون لري چې تاسو مجبور نه شئ لویه اجازه ورکړئ. ⛔ org.create اختیاري نه ده. د دې پرته ماډول کولی شي ستاسو حسابونه ولولي او نشي کولی یو پرانیزي، نو Test Connection پاس کیږي او لومړی آرډر 403 ځواب ورکوي. ⛔⛔ ټول جدول ته اجازه ورکړئ، او پام وکړئ چې Test Connection تاسو ته نشي ویلای که تاسو دا نه وي کړي. دا ستاسو د ریډیلر پروګرام لولي او هیڅ شی نه فعالوي، نو دا د هغې کیلي لپاره شنه وي چې د دې هر یو لیرې وي. هغه څه چې تاسو یې په بدل کې ترلاسه کوئ، میاشتې وروسته، د یو پیرودونکي څخه د هغې یوازینۍ عملیات په اړه 403 دی چې ورکه شوې اجازه یې پوښي.

۲. ماډول نصب کړئ

۱. ماډول ښکته کړئ او د زیپ څخه یې وباسئ. ۲. د 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 په ډګر کې ځي، کوم چې WHMCS په انکریپټ شوي ډول ذخیره کوي. دا د محصول په ترتیباتو کې مه ږدئ — هغه په ډیټابیس کې ساده متن دی او هر مدیر ته لیدل کیږي، او دا سند کولی شي ستاسو د پیرودونکو کوربه توب جوړ او له منځه یوسي.

د 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 محصول کې ترتیب شوي او اغیزمن ندي. |

⛔⛔ د پلان کوډ اړین دی، او د هغې پرته آرډر قصداً رد کیږي. تر 2026-09-01 پورې دا ډګر تزییني و او هیڅ شي نه لوستل، نو ماډول داسې کوربه توب آرډر کاوه چې هیڅ پلان یې نه درلود — او د هغې عواقب پټ وو. ستاسو د عمده پلور صورت حساب ستاسو د پیرودونکو فعالو ګډونونو څخه جوړ شوی، نو د خدمت لپاره هیڅ لړۍ نه وه او تاسو ته هیڅ بل نه و ورکړل شوی ترڅو چې دا روان و؛ ستاسو پیرودونکي هیڅ تخصیص ندی ترلاسه کړی، نو د هغوی په سایټ کې د ډیسک یا فایل هیڅ کوټه نه ده پلي شوې؛ او Change Package هیڅ شی نه درلود چې بدل یې کړي، نو یو ارتقا چې تاسو پلورلې وه ترسره کیدی نشوه. سایټ په بشپړ ډول چمتو او خدمت کاوه.

ماډول اوس د دې پرځای آرډر ردوي، ځکه د دې اټکل کولو لپاره هیڅ خوندي پلان نشته: یو اټکل به په داسې پلان کې کوربه توب تنظیم کړي چې تاسو نه و غوره کړی او ممکن قیمت یې نه وي ټاکل شوی، او — د ردولو برخلاف، کوم چې تاسو سمدلاسه لولئ — دا به یوازې هغه وخت څرګند شي کله چې د حساب بیانیه راورسیږي، که هیڅ راورسیږي.

د Auto Setup هر هغه څه ته ترتیب کړئ چې تاسو یې غوره ګڼئ — ماډول د WHMCS خدمت پیژندندوی کې یو شان دی، نو بیرته هڅه شوی تنظیم د دوهم بل کولو پرځای ورته سایټ بیرته راګرځوي.

د 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 مرجع کې دي.