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

این راهنما برای کسی نوشته شده که می‌خواهد فروش هاست یا سرور را حرفه‌ای شروع کند؛ نه فقط WHMCS را نصب کند و چند محصول بسازد. هدف این است که بدانید هر بخش چه نقشی دارد، چه تنظیماتی حساس‌اند و کاربران معمولاً با چه چالش‌هایی روبه‌رو می‌شوند.

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

مرحله اول: تنظیمات عمومی و برند

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

  • Company Name و آدرس سایت را دقیق وارد کنید.
  • System URL باید با HTTPS و دامنه اصلی ناحیه کاربری باشد.
  • Default Language و Charset را با نیاز کاربران تنظیم کنید.
  • قالب ایمیل‌ها را فارسی‌سازی و تست کنید.
  • لوگو و رنگ‌بندی را با برند هماهنگ کنید.

مرحله دوم: امنیت پنل مدیریت

WHMCS به اطلاعات حساس مشتریان، فاکتورها، سرویس‌ها و درگاه پرداخت دسترسی دارد. بنابراین امنیت پنل مدیریت باید قبل از فروش واقعی تنظیم شود. مسیر ادمین را تغییر دهید، ورود دو مرحله‌ای را فعال کنید، دسترسی مدیران را نقش‌بندی کنید و از رمزهای قوی استفاده کنید. همچنین سطح دسترسی فایل configuration.php باید محدود باشد.

هشدار: هرگز افزونه یا قالب نامطمئن روی WHMCS نصب نکنید. یک ماژول آلوده می‌تواند به اطلاعات مشتریان، فاکتورها یا API سرورها دسترسی پیدا کند.

مرحله سوم: تنظیم Cron و اتوماسیون

WHMCS برای کارهای روزانه مثل ساخت فاکتور، ارسال یادآوری، تمدید، تعلیق، لغو سرویس، sync دامنه و بروزرسانی وضعیت‌ها به cron نیاز دارد. اگر cron درست اجرا نشود، سیستم ظاهراً کار می‌کند اما پشت‌صحنه ناقص است. بسیاری از مشکلات WHMCS از همین‌جا شروع می‌شوند: فاکتور تمدید ساخته نمی‌شود، سرویس بعد از پرداخت فعال نمی‌شود، یا یادآوری‌ها ارسال نمی‌شوند.

*/5 * * * * /usr/bin/php -q /path/to/whmcs/crons/cron.php

بعد از تنظیم cron، در Automation Status بررسی کنید آخرین اجرای موفق چه زمانی بوده است. اگر cron با PHP اشتباه اجرا شود، ممکن است خطای ionCube، memory_limit یا مسیر اشتباه ببینید.

مرحله چهارم: واحد پول، مالیات و فاکتور

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

مرحله پنجم: درگاه پرداخت

برای دریافت وجه، باید حداقل یک درگاه پرداخت فعال شود. هر درگاه اطلاعات مخصوص خود را دارد: API key، Merchant ID، Callback URL، Secret یا Signature. بعد از فعال‌سازی، حتماً پرداخت تستی انجام دهید و مطمئن شوید فاکتور بعد از پرداخت به Paid تغییر می‌کند و سرویس طبق سیاست شما ساخته می‌شود.

  • Callback URL را دقیق در پنل درگاه وارد کنید.
  • واحد پول و مبلغ نهایی را بررسی کنید.
  • پرداخت موفق، ناموفق و برگشت کاربر را تست کنید.
  • لاگ Gateway Log را بعد از تست بخوانید.

مرحله ششم: اتصال سرورها و ماژول‌ها

اگر هاست cPanel، DirectAdmin، VPS یا سرویس ابری می‌فروشید، باید سرور یا ماژول مربوط را در WHMCS اضافه کنید. برای cPanel معمولاً hostname یا IP، نام کاربری WHM و API Token لازم است. بعد از وارد کردن اطلاعات، Test Connection بزنید و مطمئن شوید اتصال موفق است.

برای امنیت بهتر، به‌جای رمز اصلی WHM از API Token با دسترسی لازم استفاده کنید. همچنین IP سرور WHMCS را در فایروال سرور مقصد مجاز کنید تا ساخت سرویس با خطای اتصال مواجه نشود.

مرحله هفتم: ساخت محصولات و گروه‌ها

محصولات باید دقیق، قابل فهم و قابل پشتیبانی باشند. فقط اسم پلن و قیمت کافی نیست. منابع، سیستم‌عامل، لوکیشن، ترافیک، پنل، شرایط تمدید، بکاپ و محدودیت‌ها را واضح بنویسید. در تنظیمات محصول، Module Settings، Pricing، Welcome Email و Stock Control را بررسی کنید.

برای هاست اشتراکی

  • فضا و ترافیک
  • تعداد دامنه و دیتابیس
  • نسخه PHP و کنترل‌پنل
  • بکاپ و ایمیل

برای سرور مجازی

  • CPU، RAM، دیسک و ترافیک
  • لوکیشن و سیستم‌عامل
  • IPv4/IPv6 و فایروال
  • قوانین Abuse و مدیریت‌شده/نشده

مرحله هشتم: ایمیل‌ها و تیکت پشتیبانی

ایمیل‌های WHMCS باید به inbox مشتری برسند، نه spam. برای این کار SMTP معتبر، SPF، DKIM و DMARC را تنظیم کنید. قالب ایمیل‌های خوشامدگویی، فاکتور، یادآوری پرداخت، تعلیق و فعال‌سازی را به زبان ساده و برند خودتان بازنویسی کنید. دپارتمان‌های تیکت مثل فروش، مالی و پشتیبانی فنی را جدا کنید تا درخواست‌ها گم نشوند.

مرحله نهم: قوانین سفارش و ضدتقلب

اگر فروش سرور یا هاست دارید، باید سفارش‌های مشکوک را کنترل کنید. فعال‌سازی دستی برای محصولات حساس، بررسی ایمیل/موبایل، قوانین Abuse، محدودیت کشور، کنترل IP و احراز هویت برای سرویس‌های پرریسک می‌تواند از مشکلات بعدی جلوگیری کند. اتوماتیک‌سازی کامل بدون کنترل، برای محصولات حساس همیشه بهترین انتخاب نیست.

خطاهای رایج WHMCS

  • سرویس بعد از پرداخت ساخته نمی‌شود: Module Settings، cron، وضعیت سفارش و Gateway callback را بررسی کنید.
  • ایمیل‌ها ارسال نمی‌شوند: SMTP، SPF/DKIM، Mail Log و محدودیت سرور را چک کنید.
  • فاکتور تمدید ساخته نمی‌شود: Automation Settings و اجرای cron مشکل دارد.
  • اتصال cPanel خطا می‌دهد: API Token، فایروال، hostname و SSL را بررسی کنید.
  • قیمت اشتباه محاسبه می‌شود: واحد پول، مالیات، دوره پرداخت و Configurable Options را بررسی کنید.

جمع‌بندی

تنظیمات WHMCS باید مرحله‌ای و با تست انجام شود. اول امنیت، آدرس سیستم، cron و ایمیل را درست کنید؛ بعد درگاه پرداخت و سرورها را تست کنید؛ سپس محصولات را با توضیحات کامل بسازید. قبل از تبلیغ فروش، یک سفارش واقعی تستی از ابتدا تا انتها انجام دهید: ثبت‌نام، سفارش، پرداخت، ساخت سرویس، ایمیل خوشامد، تیکت، تمدید و لغو. این تست ساده می‌تواند جلوی بسیاری از خطاهای پرهزینه را بگیرد.

منابع رسمی برای مطالعه بیشتر