آموزش نصب و تنظیم ماژول دامنه WHMCS

پیش‌نیازهای نصب و تنظیم ماژول WHMCS

پیش از شروع نصب، مطمئن شوید به پنل اصلی سرویس و مدیریت WHMCS دسترسی کامل دارید. برای انجام این آموزش به موارد زیر نیاز خواهید داشت:

• دسترسی مدیریت به پنل WHMCS
• دسترسی به بخش API پنل اصلی
• دسترسی به File Manager هاست یا FTP
• امکان آپلود و استخراج فایل فشرده در ریشه WHMCS
• فایل آخرین نسخه ماژول دامنه
• توکن API ساخته‌شده برای بخش Modules
• آدرس IP سروری که WHMCS روی آن نصب شده است
• تهیه نسخه پشتیبان از فایل‌ها و دیتابیس WHMCS

ساختار ماژول‌های WHMCS چگونه است؟

برای اینکه وابستگی سرویس‌ها به یکدیگر کاهش پیدا کند، هر بخش در قالب یک ماژول مجزا ارائه شده است. به همین دلیل، ممکن است برای راه‌اندازی یک سرویس لازم باشد بیش از یک قسمت از تنظیمات WHMCS را فعال کنید.

در حال حاضر ماژول‌های متفاوتی برای اتصال WHMCS به سرویس‌ها ارائه شده‌اند. این راهنما به‌طور مشخص درباره نصب و پیکربندی ماژول دامنه WHMCS است.

برای عملکرد کامل ماژول دامنه، دو بخش زیر باید در WHMCS تنظیم شوند:

1. بخش Addon Modules برای مدیریت تنظیمات، قیمت‌ها، نرخ تبدیل و عملیات مرتبط با دامنه
2. بخش Domain Registrars برای اتصال ثبت دامنه به پنل اصلی از طریق API

مرحله اول: دریافت توکن API مخصوص ماژول‌های WHMCS

برای ایجاد ارتباط امن میان WHMCS و پنل اصلی، باید یک توکن API مخصوص ماژول‌ها بسازید. این توکن هنگام فعال‌سازی ماژول Registrar در WHMCS مورد استفاده قرار می‌گیرد.

1. وارد پنل جدید سرویس شوید.
2. از منوی تنظیمات، بخش API را باز کنید.
3. به قسمت Modules بروید.
4. توکن جدید مربوط به ماژول‌ها را ایجاد کنید.
5. توکن نمایش‌داده‌شده را کپی کرده و در محلی امن ذخیره نمایید.

تعریف IPهای مجاز برای توکن

برای جلوگیری از دسترسی غیرمجاز، آدرس IP سروری را که WHMCS روی آن قرار دارد در فهرست IPهای مجاز توکن ثبت کنید. در صورت استفاده از چند سرور، می‌توانید IPهای موردنیاز را برای همان توکن تعریف نمایید.

نکات امنیتی نگهداری توکن API

• توکن را در پیام‌رسان‌ها یا صفحات عمومی ارسال نکنید.
• از ذخیره توکن در فایل‌های قابل‌دسترسی عمومی خودداری کنید.
• فقط IP سرورهای مورداعتماد را در فهرست دسترسی قرار دهید.
• دسترسی فایل‌های تنظیمات WHMCS را محدود نگه دارید.
• در صورت افشای توکن، آن را تعویض کرده و تنظیمات ماژول را به‌روزرسانی کنید.

مرحله دوم: دانلود ماژول دامنه WHMCS

آخرین نسخه ماژول دامنه WHMCS را از لینک زیر دانلود کنید. برای جلوگیری از بروز مشکل، همیشه از نسخه‌ای استفاده نمایید که با نسخه WHMCS و نسخه PHP سرور شما سازگار باشد.

دانلود ماژول دامنه WHMCS

مرحله سوم: آپلود ماژول در ریشه WHMCS

پس از دانلود فایل، وارد File Manager هاست شوید و مسیر اصلی نصب WHMCS را باز کنید. منظور از ریشه WHMCS، پوشه‌ای است که فایل‌ها و پوشه‌های اصلی این سیستم در آن قرار دارند.

1. وارد کنترل‌پنل هاست شوید.
2. بخش File Manager را باز کنید.
3. به مسیر نصب WHMCS بروید.
4. فایل فشرده ماژول را در ریشه WHMCS آپلود کنید.
5. فایل را انتخاب کرده و روی گزینه Extract کلیک کنید.
6. پس از استخراج، قرارگرفتن فایل‌ها در مسیرهای صحیح را بررسی نمایید.

ساختار کلی پوشه WHMCS ممکن است مشابه نمونه زیر باشد:

/public_html/whmcs/

اگر WHMCS در ریشه دامنه نصب شده باشد، مسیر آن ممکن است مشابه نمونه زیر باشد:

/public_html/

مرحله چهارم: فعال‌سازی Manage Domain در Addon Modules

پس از آپلود فایل‌ها، وارد مدیریت WHMCS شوید و بخش تنظیمات ماژول‌های جانبی را باز کنید. نام و مسیر منو ممکن است با توجه به نسخه WHMCS کمی متفاوت باشد؛ اما باید وارد قسمت Addon Modules شوید.

1. وارد مدیریت WHMCS شوید.
2. به بخش تنظیمات سیستم بروید.
3. قسمت Addon Modules را باز کنید.
4. ماژولی با نام Manage Domain را پیدا کنید.
5. روی گزینه Activate کلیک نمایید.
6. پس از فعال‌سازی، سطح دسترسی مدیران را برای این ماژول تعیین کنید.

تنظیم سطح دسترسی مدیران WHMCS

بعد از فعال‌سازی ماژول، مشخص کنید کدام نقش‌های مدیریتی به آن دسترسی داشته باشند. بهتر است این مجوز فقط به مدیرانی داده شود که مسئول تنظیم قیمت دامنه، نرخ ارز، واردکردن پسوندها و مدیریت سفارش‌های دامنه هستند.

تنظیمات ماژول WHMCS نمایندگی دامنه

مرحله پنجم: فعال‌سازی Manage Domain Registration

علاوه بر ماژول جانبی، باید ماژول ثبت‌کننده دامنه یا Registrar نیز فعال شود. این بخش مسئول برقراری ارتباط میان سفارش‌های دامنه در WHMCS و پنل اصلی است.

1. از تنظیمات WHMCS وارد بخش Domain Registrars شوید.
2. ماژول Manage Domain Registration را پیدا کنید.
3. روی گزینه Activate کلیک نمایید.
4. پس از فعال‌سازی، صفحه تنظیمات ماژول را باز کنید.
5. توکن دریافت‌شده از پنل را در فیلد API Key وارد نمایید.
6. تغییرات را ذخیره کنید.

نمونه محل ثبت توکن:

API Key: YOUR_MODULE_API_TOKEN

اگر اتصال API برقرار نشد چه مواردی را بررسی کنیم؟

• توکن بدون فاصله اضافی در فیلد API Key وارد شده باشد.
• IP سرور WHMCS در فهرست IPهای مجاز توکن قرار داشته باشد.
• توکن فعال و معتبر باشد.
• سرور امکان برقراری ارتباط خروجی با API را داشته باشد.
• گواهی SSL پنل و WHMCS معتبر باشد.
• نسخه PHP با نیازمندی‌های ماژول سازگار باشد.

مرحله ششم: بررسی اتصال ماژول دامنه به پنل

برای اطمینان از نصب صحیح ماژول، از منوی بالای مدیریت WHMCS گزینه Manage Domain را انتخاب کنید.

اگر این گزینه نمایش داده نمی‌شود، موارد زیر را بررسی نمایید:

• ماژول Manage Domain در بخش Addon Modules فعال شده باشد.
• برای نقش مدیریتی شما دسترسی لازم تعریف شده باشد.
• فایل‌های ماژول در مسیر صحیح WHMCS قرار گرفته باشند.
• کش قالب و کش مرورگر پاک شده باشد.
• خطای PHP مانع بارگذاری ماژول نشده باشد.

پس از ورود به بخش Manage Domain، قسمت Settings را باز کنید تا تنظیمات اصلی قیمت، ارز، Registrar و درصد سود را انجام دهید.

مرحله هفتم: انجام تنظیمات ماژول دامنه WHMCS

تنظیمات این بخش مستقیماً بر نحوه واردکردن قیمت دامنه‌ها، محاسبه هزینه شارژ و سود گروه‌های کاربری تأثیر دارد. پیش از ذخیره تنظیمات، واحد پولی WHMCS و نحوه نمایش قیمت‌ها در سایت را بررسی کنید.

تنظیم The main currency

گزینه The main currency واحد پولی اصلی شما را مشخص می‌کند. این مقدار باید با واحد پولی اصلی تعریف‌شده در تنظیمات مالی WHMCS هماهنگ باشد.

پیش از انتخاب این گزینه، بررسی کنید قیمت‌های دریافتی از پنل بر اساس چه واحدی هستند و قیمت نهایی در سایت شما باید با چه واحدی به مشتری نمایش داده شود.

تنظیم Exchange for import

گزینه Exchange for import برای تبدیل قیمت دامنه هنگام Import استفاده می‌شود. زمانی که دامنه‌ها و قیمت‌ها را وارد می‌کنید، قیمت دریافتی در عدد این بخش ضرب خواهد شد.

برای مثال، اگر قیمت منبع بر اساس ریال باشد و بخواهید قیمت در WHMCS بر اساس تومان ذخیره شود، مقدار این قسمت می‌تواند به شکل زیر تنظیم شود:

۰٫۱

در این حالت، قیمت دریافتی در عدد ۰٫۱ ضرب می‌شود تا تبدیل ریال به تومان انجام گیرد.

تنظیم Exchange for charge

با استفاده از ماژول، کاربران می‌توانند بخشی از موجودی خود را به پنل دامنه منتقل کنند. گزینه Exchange for charge تعیین می‌کند مبلغ درخواست‌شده با چه ضریبی از حساب کاربر کسر شود.

به بیان ساده، مبلغی که کاربر برای شارژ وارد می‌کند در عدد این بخش ضرب شده و نتیجه از موجودی حساب او در WHMCS کسر می‌شود.

تنظیم Promotion Profit

گزینه Promotion Profit برای تعیین سود روی دامنه‌هایی در نظر گرفته شده است که با قیمت تخفیفی یا Promotion ارائه می‌شوند.

این قابلیت ممکن است در نسخه فعلی ماژول فعال نباشد و در نسخه‌های بعدی برای محاسبه سود دامنه‌های تخفیف‌دار مورد استفاده قرار گیرد. تا زمان فعال‌شدن رسمی این امکان، تنظیمات آن را مطابق مستندات نسخه ماژول انجام دهید.

تنظیم Force currency

اگر در WHMCS چند واحد پولی دارید، با استفاده از گزینه Force currency می‌توانید مشخص کنید قیمت‌های واردشده برای کدام واحد پولی اعمال شوند.

این تنظیم به‌خصوص هنگام Import قیمت دامنه‌ها اهمیت دارد؛ زیرا مانع ثبت قیمت در واحد پولی اشتباه می‌شود.

تنظیم The main registrar

گزینه The main registrar مشخص می‌کند دامنه‌ها به‌صورت پیش‌فرض از طریق کدام Registrar ثبت شوند.

Registrar مناسب را با توجه به پسوند دامنه و سرویس فعال خود انتخاب کنید. دامنه‌های .ir به‌صورت پیش‌فرض از طریق NIC مدیریت می‌شوند؛ اما برای سایر پسوندها باید Registrar متناسب با سرویس خود را مشخص نمایید.

تنظیم Interest rates برای گروه‌های کاربری

در بخش Interest rates می‌توانید درصد سود موردنظر را برای هر گروه کاربری تعیین کنید. این امکان برای سایت‌هایی مناسب است که قیمت دامنه برای کاربران عادی، همکاران و نمایندگان متفاوت است.

اگر برای گروه‌های کاربری قیمت متفاوتی ندارید، کافی است درصد موردنظر را برای گروه Normal Group تنظیم کنید.

مرحله هشتم: بررسی قیمت دامنه‌ها با Fast Import

پس از تکمیل و ذخیره تنظیمات، وارد قسمت Fast Import شوید. این بخش برای مشاهده و واردکردن سریع قیمت پسوندهای دامنه مورد استفاده قرار می‌گیرد.

اگر قیمت دامنه‌ها در این قسمت نمایش داده شود، اتصال ماژول به سرور جدید برقرار شده است و ماژول می‌تواند اطلاعات قیمت را دریافت کند.

مواردی که پیش از Import باید بررسی شوند

• واحد پولی اصلی به‌درستی انتخاب شده باشد.
• ضریب Exchange for import صحیح باشد.
• قیمت تبدیل‌شده چند پسوند به‌صورت دستی بررسی شود.
• Registrar اصلی به‌درستی تعیین شده باشد.
• درصد سود گروه‌های کاربری ثبت شده باشد.
• توکن API و IP مجاز بدون خطا تنظیم شده باشند.

رفع خطاهای رایج ماژول دامنه WHMCS

اگر ماژول نمایش داده نمی‌شود یا نمی‌تواند اطلاعات دامنه را از پنل دریافت کند، موارد زیر را بررسی نمایید.

ماژول Manage Domain در WHMCS نمایش داده نمی‌شود

• فایل فشرده در ریشه صحیح WHMCS استخراج شده باشد.
• پوشه‌های ماژول در مسیرهای اصلی خود قرار گرفته باشند.
• فایل‌ها داخل یک پوشه اضافی استخراج نشده باشند.
• نسخه PHP با ماژول سازگار باشد.
• سطح دسترسی فایل‌ها و پوشه‌ها صحیح باشد.
• گزارش خطاهای WHMCS و Error Log سرور بررسی شود.

گزینه Manage Domain در منوی مدیریت دیده نمی‌شود

اگر ماژول فعال شده اما گزینه آن در منوی مدیریت نمایش داده نمی‌شود، احتمالاً نقش مدیریتی شما مجوز لازم را ندارد.

1. وارد تنظیمات Addon Modules شوید.
2. تنظیمات دسترسی ماژول Manage Domain را باز کنید.
3. نقش مدیریتی موردنظر را فعال نمایید.
4. یک‌بار از مدیریت WHMCS خارج شده و دوباره وارد شوید.

خطای API Key یا عدم احراز هویت

این خطا معمولاً به اشتباه‌بودن توکن یا ثبت‌نشدن IP سرور مربوط است. موارد زیر را بررسی کنید:

• توکن API کامل و بدون فاصله اضافی وارد شده باشد.
• توکن از قسمت Modules ایجاد شده باشد.
• IP اصلی سرور WHMCS در پنل ثبت شده باشد.
• توکن حذف، تعویض یا غیرفعال نشده باشد.
• در صورت تعویض توکن، مقدار جدید در تنظیمات ماژول قرار گرفته باشد.

قیمت دامنه‌ها در Fast Import نمایش داده نمی‌شود

اگر بخش Fast Import قیمت‌ها را نمایش نمی‌دهد، ابتدا اتصال API را بررسی کنید. سپس موارد زیر را کنترل نمایید:

• ماژول‌های Addon و Registrar هر دو فعال باشند.
• فیلد API Key به‌درستی تکمیل شده باشد.
• IP سرور در فهرست مجاز قرار داشته باشد.
• سرور امکان ارسال درخواست خروجی به API را داشته باشد.
• افزونه‌های موردنیاز PHP روی سرور فعال باشند.
• فایروال یا تنظیمات امنیتی سرور ارتباط API را مسدود نکرده باشد.
• لاگ ماژول و گزارش خطاهای WHMCS بررسی شود.

قیمت دامنه‌ها اشتباه محاسبه می‌شود

اگر قیمت واردشده کمتر یا بیشتر از مقدار مورد انتظار است، موارد زیر را بررسی کنید:

• مقدار Exchange for import صحیح باشد.
• واحد پولی منبع و واحد پولی WHMCS مشخص باشند.
• گزینه Force currency روی واحد مناسب قرار گرفته باشد.
• درصد Interest rates به‌درستی تعیین شده باشد.
• قیمت ثبت، تمدید و انتقال دامنه با یکدیگر اشتباه نشده باشند.

شارژ اشتباهی از حساب کاربر کسر می‌شود

در این حالت، مقدار Exchange for charge را بررسی کنید. مبلغ درخواست‌شده کاربر در این عدد ضرب می‌شود؛ بنابراین انتخاب ضریب اشتباه باعث کسر مبلغ نادرست خواهد شد.

پیش از فعال‌کردن امکان انتقال شارژ برای همه کاربران، فرایند را با یک حساب آزمایشی و مبلغ کم بررسی نمایید.

نکات امنیتی استفاده از ماژول WHMCS

به دلیل ارتباط مستقیم ماژول با حساب مالی، اطلاعات کاربران و سرویس ثبت دامنه، رعایت نکات امنیتی اهمیت زیادی دارد.

• WHMCS، PHP و ماژول را در نسخه‌های سازگار و پایدار نگه دارید.
• فقط نسخه رسمی ماژول را دانلود و نصب کنید.
• توکن API را در اختیار افراد غیرمجاز قرار ندهید.
• فقط IPهای ضروری را برای دسترسی به API مجاز کنید.
• برای حساب‌های مدیریتی از رمز عبور قوی و ورود دومرحله‌ای استفاده کنید.
• از فایل‌ها و دیتابیس WHMCS به‌صورت منظم نسخه پشتیبان تهیه کنید.
• لاگ درخواست‌ها و خطاهای ماژول را به‌صورت دوره‌ای بررسی نمایید.
• دسترسی مدیران به Manage Domain را محدود کنید.
• پس از تغییر تنظیمات مالی، قیمت‌ها را به‌صورت آزمایشی محاسبه کنید.

چک‌لیست نهایی نصب و تنظیم ماژول دامنه WHMCS

پیش از ارائه سرویس دامنه به کاربران، موارد زیر را یک‌بار بررسی کنید:

• از فایل‌ها و دیتابیس WHMCS نسخه پشتیبان تهیه شده است.
• آخرین نسخه سازگار ماژول دامنه دانلود شده است.
• فایل‌های ماژول در ریشه صحیح WHMCS استخراج شده‌اند.
• توکن API از بخش Modules پنل ساخته شده است.
• توکن در محل امن نگهداری می‌شود.
• IP سرور WHMCS در فهرست IPهای مجاز قرار گرفته است.
• ماژول Manage Domain در Addon Modules فعال شده است.
• دسترسی نقش‌های مدیریتی به ماژول تنظیم شده است.
• ماژول Manage Domain Registration فعال شده است.
• توکن در فیلد API Key ثبت شده است.
• واحد پولی اصلی به‌درستی انتخاب شده است.
• ضریب Exchange for import بررسی شده است.
• ضریب Exchange for charge آزمایش شده است.
• Registrar اصلی انتخاب شده است.
• درصد سود گروه‌های کاربری تعیین شده است.
• قیمت دامنه‌ها در Fast Import نمایش داده می‌شود.
• قیمت چند پسوند به‌صورت دستی بررسی شده است.
• فرآیند ثبت آزمایشی دامنه بدون خطا انجام شده است.

سؤالات متداول تنظیم ماژول WHMCS

جمع‌بندی آموزش تنظیمات ماژول دامنه WHMCS

برای نصب و تنظیم ماژول دامنه WHMCS ابتدا باید توکن API مخصوص Modules را از پنل دریافت کرده و IP سرور WHMCS را در فهرست دسترسی‌های مجاز قرار دهید. سپس فایل ماژول را در ریشه WHMCS آپلود و استخراج کنید.

در مرحله بعد، ماژول Manage Domain را از بخش Addon Modules و ماژول Manage Domain Registration را از قسمت Domain Registrars فعال کنید. توکن دریافت‌شده نیز باید در فیلد API Key قرار بگیرد.

پس از برقراری اتصال، تنظیمات واحد پولی، نرخ تبدیل قیمت، انتقال شارژ، Registrar اصلی و درصد سود گروه‌های کاربری را انجام دهید. در پایان وارد بخش Fast Import شوید و پیش از واردکردن گروهی قیمت‌ها، مبلغ چند دامنه را به‌صورت دستی بررسی کنید.