ماژول ثبت دامنه ایرنیک ویژه نمایندگان رسمی برای WHMCS بر پایه پروتکل EPP مرکز ثبت دامنه IRNIC برای نمایندگان رسمی طراحی شده است. به کمک این ماژول کلیه عملیات مورد نیازی که نیاز است نمایندگان مستقیم nic.ir جهت ثبت دامنه در سایت خود پیاده سازی کنند توسعه داده شده است. این ماژول دارای ویژگی‌های متعدد و کاملی است که در نمونه خود منحصر بفرد است. در این سند نحوه راه اندازی و تنظیمات این ماژول شرح داده شده است.
نیازمندی‌های نرم‌افزاری #
ماژول ثبت دامنه ایرنیک ویژه نمایندگان رسمی به PHP 7.2 یا بالاتر ، WHMCS v8.x نیاز دارد. همچنین پیش از نصب افزونه از فعال بودن EPP مرکز ثبت دامنه بر روی IP سرور خود و فعال بودن Cron سیستم WHMCS اطمینان حاصل کنید.
نصب ماژول #
جهت نصب ماژول نیاز است تا بسته فشرده ماژول را از ناحیه کاربری دریافت کنید. سپس آن را از حالت فشرده خارج کرده و محتوای پوشه upload را بروی هاست خود در محل نصب WHMCS آپلود کنید.
بعد از آپلود شدن فایل‌ها بایستی فیلدهای اختصاصی مورد نیاز ثبت دامنه ملی را به WHMCS معرفی کنید. برای اینکار از ویژگی Additional Domain Fields در WHMCS استفاده میشود. فیلدهای دامنه اضافی اطلاعاتی را که مرکز ثبت برای یک TLD معین نیاز دارد، تعریف می کند.
برای سفارشی کردن فیلدها، در صورتی که از قبل یک فایل با نام additionalfields.php در پوشه با آدرس /resources/domains/ وجود ندارد یک فایل با این نام و با محتوای فایل additionalfields.irnic.php که در همین پوشه قرار دارد ایجاد کنید. در صورتی که چنین فایلی وجود دارد تنها کدهای بعد از تگ <?php را به انتهای فایل قبلی ( و در صورت وجود تک ?> در انتهای فایل قبل از آن) اضافه کنید.
بعد از عملیات فوق به بخش مدیریت WHMCS وارد شوید و از بخش ثبت کننده‌های دامنه ماژول IRNIC را فعال کنید.
سپس به بخش ماژول‌های افزونه مراجعه کنید و در این بخش ماژول IRNIC را فعال کنید.
بعد از فعال شدن Addon حال بر روی دکمه تنظیمات کلیک کنید و دسترسی لازم را به Role های مدیران سیستم خود که تمایل دارید بتوانند لاگ‌های ارتباطی با ایرنیک را بررسی کنند، اعطا کنید.
تنظیمات ماژول #
جهت استفاده از ماژول نیاز است تا تنظیماتی را بر روی ماژول انجام دهید در ادامه به تشریح این تنظیمات پرداخته میشود. به منظور انجام تنظیمات به بخش ثبت کننده‌های دامنه در مدیریت مراجعه کنید و روی دکمه تنظیمات جلو نام ماژول IRNIC کلیک کنید.
لایسنس ماژول #
جهت فعال شدن ماژول نیاز است که لایسنس خریداری شده ماژول را که در پنل کاربری وب‌آلفا قابل دریافت است را فیلد License Key وارد کرده و ذخیره کنید.
اتصال به ایرنیک #
جهت اتصال به EPP یا همان API مرکز ثبت دامنه ایرنیک نیاز است تا تنظیمات API Token پذیرد. به این منظور ابتدا Token ارسال شده توسط مرکز ثبت را در فیلد API Token وارد نمایید. سپس دیپوزیت کد که توسط ایرنیک برای شما همراه با API Token ارسال شده است را در فیلد Deposit Code وارد کنید.
جهت ارتباط موفق با مرکز ثبت نیاز است تا هر درخواست دارای کد رهگیری منحصر به فرد باشد که این کد برای شناسایی و پیگیری هر درخواست و پاسخ متناظر هر یک از آنها بکار میرود. در صورتی که این شناسه در ابتدای آن عبارت «TEST» (حتما با حروف بزرگ) قرار داشته باشد این درخواست در سامانه آزمایشی یا همان Demo اجرا میگردد. در غیر این صورت بر روی سامانه اصلی اجرا میگردد.
در صورتی که قرار داد نمایندگی شما منعقد نشده است و در حال اعتبار سنجی فنی توسط ایرنیک هستید حتما بایستی از «TEST» استفاده کنید. همچنین پیشنهاد میشود در زمان عملیاتی شدن سامانه کد رهگیری هر نماینده فروش با نام مختصر آن شرکت یا موسسه شروع شود. برای نمونه اگر نام شرکت شما Pixelly است، عبارت PXL میتواند مناسب باشد. به منظور وارد کردن عبارت مورد نظر آن را در فیلد clTRID Prefix وارد کنید.
نکته: در صورتی بعد از فعال سازی و بکارگیری ماژول اقدام به نصب مجدد آن روی WHMCS جدیدی کردید، نیاز است تا از یک clTRID Prefix جدید در نصب جدید استفاده کنید تا از تکراری ایجاد شدن کد رهگیری درخواست‌ها جلوگیری شود و عملیات با خطا روبرو نشود.
شناسه نمایندگی #
جهت برخی بررسی‌ها نیاز است تا شناسه نماینده به ماژول معرفی شود. به این منظور شناسه ایرنیک نمایندگی خود را در فیلد Reseller Handle وارد کنید.
تمدید/انتقال دامنه‌های قفل شده #
به صورت پیشفرض در ماژول ایرنیک دامنه‌هایی که به علت عدم تمدید در دوره ۳۰ روز بعد از انقضا تمدید نشده اند و به اصطلاح در وضعیت Redemption قرار دارند در صورتی که تمدید شوند با خطا قفل بودن دامنه رو برو میشوند. در صورتی که تمایل دارید در صورتی که دامنه‌ای که در وضعیت قفل شده یا Redemption قرار دارد تمدید/منتقل شود نیاز است تا گزینه Renew even Locked را تیک بزنید.
توضیحات بیشتری درباره فرآیند ثبت و انتقال دامنه‌های قفل شده در بخش راهنمای استفاده شرح داده شده است.
هزینه بازگشایی قفل و هزینه حذف دامنه #
دامنه‌هایی که بعد از ۳۰ روز از تاریخ انقضا تمدید نشوند به وضعیت Redemption یا قفل وارد میشوند و جهت بازگشایی نیاز به پرداخت جریمه است. WHMCS دارای امکان مشخص کردن دوره و هزینه جریمه برای هر پسوند است که در بخش تنظیمات قیمت دامنه‌ها قابل تنظیم است، این ویژگی محدود به دامنه‌هایی است که هم اکنون در پنل کاربری مشتریان قرار دارد و در ثبت سفارش‌های جدید کاربردی ندارد. ماژول ثبت دامنه وب‌آلفا امکان مشخص کردن هزینه Redemption یا بازگشایی قفل در زمان سفارش را داراست. جهت مشخص کردن هزینه بازگشایی قفل در زمان ثبت سفارش جدید توسط کاربر مبلغ آن را در فیلد Unlock Price وارد کنید.
همچنین با توجه به پیاده سازی امکان حذف/لغو دامنه از ناحیه کاربری در ماژول وب‌آلفا جهت مشخص کردن هزینه لغو دامنه فیلد Delete Price را مقداردهی کنید.
حذف خودکار گزارش‌ها #
جهت تنظیم عملیات حذف خودکار لاگ‌های ارتباطی و پیام‌های Poll مرکز ثبت مقدار زمان مورد نظر بر اساس روز را در فیلدهای Auto Prune Logs و Auto Prune Poll Messages وارد کنید. در صورتی که تمایل دارید گزارش‌ها حذف نشود کافیست مقدار فیلدها را خالی یا صفر وارد کنید.
عودت خودکار هزینه درخواست‌های لغو شده #
ماژول وب‌آلفا دارای قابلیت عودت خودکار هزینه دامنه‌هایی است که درخواست انتقال و یا ثبت آنها توسط مرکز ثبت لغو شده است. جهت فعال سازی این ویژگی Auto Refund Rejected Requests را فعال کنید. لازم به تذکر است که جهت کارکرد صحیح این ویژگی تنظیم و فعال بودن Cron سیستم WHMCS الزامی است.
جهت جلوگیری از عودت غیر عادی و اشتباه صورت حساب‌ها (قدیمی)، ماژول برای هر گزارش لغوی که از ایرنیک دریافت میکند تنها مدت زمان خاصی را در بین صورت حساب‌ها جهت عودت بررسی میکند. مقدار زمانی که مورد بررسی قرار می‌دهد توسط فیلد Max Invoice Age for Auto Refund قابل تنظیم است. مقدار این فیلد بر اساس روز بوده و با توجه به مدت زمانی که یک دامنه رزرو باقی می‌ماند و یا درخواست انتقال آن به علت عدم تکمیل لغو میشود عدد ۱۴ روز مناسب بنظر میرسد.
افزودن صفحه ایجاد شناسه به نوار ناوبری (منسوخ شده از نسخه ۱.۰.۱۵) #
جهت افزودن لینک صفحه ایجاد شناسه به نوار ناوبری قالب خود کافیست که از گزینه Create Handle Page Navbar مکان مورد نظر خود را انتخاب کنید. جهت آشنایی با مکان‌های قابل انتخاب مستندات Menu layout رسمی WHMCS را مشاهده نمایید. جهت کنترل بهتر مکان نمایش در نوار ناوبری گزینه‌های Create Handle Page Navbar Location، Create Handle Page Navbar Order و Create Handle Page Navbar Icon پیاده سازی شده است. تنظیمات پیشفرض پیشنهادی برای ویژگی در تصویر زیر قابل مشاهده است.
محدود سازی تمدید بر اساس تاریخ انقضا #
یکی از الزامات ایرنیک در سیستم فروش نمایندگان عدم نمایش دوره‌های تمدیدی است که باعث عبور مدت اعتبار دامنه بیش از ۶ سال گردد. در صورت فعال بودن گزینه Renewal Restriction ماژول وب‌آلفا به صورت خودکار و بر اساس میزان زمان باقی مانده تا انقضای دامنه دوره‌های غیر مجاز تمدید برای دامنه‌های ملی را غیر فعال میکند.
بررسی وضعیت دامنه در صفحه تمدید دامنه ناحیه کاربری #
در صفحه تمدید دامنه WHMCS ناحیه کاربری، وضعیت دامنه‌های ملی توسط ماژول بررسی میشود تا جلو تمدید دامنه‌هایی که هنوز توسط ایرنیک تایید نشده اند گرفته شود. از سوی دیگر WHMCS تمامی دامنه‌های کاربر را به یک باره در این صفحه فهرست میکند و این صفحه دارای ویژگی صفحه بندی مناسب نیست. این موضوع باعث کندی در لود صفحه و حتی محدود شدن دسترسی به API ایرنیک میگردد. گزینه Check Status on Renewal page را غیر فعال کند.
انتخاب نوع انتقال #
در انتقال دامنه ملی دو سناریو بسیار پرکاربرد است. اول انتقال دامنه به یک شرکت هاستنیگ از شرکت دیگری جهت تمدید و دیگری انتقال دامنه بین دو شناسه یا به عبارت دیگر انتقال مالکیت یک دامنه. ماژول دامنه ملی WHMCS وب‌آلفا تنها ماژول پشتیبانی کننده از هر دو این سناریوها با رابط کاربری یکپارچه است. جهت فعال سازی این ویژگی گزینه Transfer Type Picker را فعال نمایید. جهت اتصال رابط کاربری این ویژگی با قالب خود نیاز است تا گزینه‌های Transfer Type Picker Location، Transfer Type Picker Style و AuthCode Area Selector را تنظیم کنید.
گزینه Transfer Type Picker Location به مکانی از کدهای قالب شما اشاره میکند که رابط کاربری انتخاب گر انتقال بعد از آن اضافه میشود، این مکان بر پایه jQuery Selector تعریف میشود. در صورتی که برای وارد کردن این گزینه نیاز به راهنمایی دارید با پشتیبانی وب‌آلفا ارتباط برقرار کنید. همچنین مقادیر پیشنهادی برای قالب پیشفرض در ادامه آمده است.
قالب Six
#frmDomainTransfer .form-group:nth-child(2)
قالب Twenty-One
#frmDomainTransfer .form-group:nth-child(2)
گزینه Transfer Type Picker Style جهت انتخاب ظاهر رابط کاربری توسعه داده شده جهت انتخاب نوع انتقال است. در صورتی که قالب شما با Bootstrap نسخه ۳ توسعه داده شده است گزینه Bootstrap 3 و در صورتی که با Bootstrap نسخه ۴ توسعه داده شده است گزینه Bootstrap 4 را انتخاب کنید. در صورتی که قالب شما با چارچوب دیگری طراحی شده است یا تمایل به شخصی سازی دارید نیاز است تا ضمن مطالعه مستندات شخصی سازی بخش انتخاب نوع انتقال گزینه Custom را انتخاب کنید.
گزینه AuthCode Area Selector مربوط به بخشی از قالب شماست که فیلد کد انتقال یا Auth Code در آن توسط کاربر داده میشود. جهت مخفی و مدیریت کردن خودکار این فیلد توسط ماژول نیاز است که بر پایه jQuery Selector بخش مربوطه به ماژول معرفی شود. مقدار این فیلد در اکثر قالب‌ها و سناریوها برابر با فیلد Transfer Type Picker Location است. در صورتی که از قالب پیشفرض WHMCS استفاده می‌کنید مقدار فیلد را برابر Transfer Type Picker Location تنظیم کنید.
مخفی کردن فیلدهای کد انتقال و شناسه‌ها در زمان سفارش انتقال دامنه به ما #
در صورتی که Transfer Type Picker فعال باشد، به صورت پیشفرض فیلدهای کد انتقال و رابط های دامنه در صفحه تنظیمات سفارش انتقال دامنه برای ثبت سفارش “انتقال دامنه به ما” نمایش داده میشود. با توجه به اینکه این نوع سفارش انتقال (تمدید) نیاز به فیلدهای ذکر شده ندارد. جهت مخفی کردن این فیلد گزینه Transfer Domain Config Selector را بایستی تنظیم کنید. این گزینه به مکانی از کدهای قالب شما اشاره میکند که فیلد های مربوطه در آن نمایش داده میشود، این فیلد بر پایه jQuery Selector تعریف میشود. مقدار پیشنهادی پیش فرض برای این گزینه مقدار زیر است:
#frmConfigureDomains .row:has(~ .form-group), .form-group
در صورتی که برای وارد کردن این گزینه نیاز به راهنمایی دارید با پشتیبانی وب‌آلفا ارتباط برقرار کنید.
نمایش خودکار قوانین ایرنیک در فرم سفارش #
یکی از الزمات ایرنیک نمایش متن توافقنامه ثبت دامنه IR در فرم سفارش و قبل از نهایی کردن سفارش توسط کاربر است. در ماژول وب‌آلفا امکان افزودن قوانین بدون نیاز به ویرایش قالب مهیا شده است. جهت فعال سازی این قابلیت Add IRNIC Terms to Checkout را فعال نمایید.
متن قوانینی که جهت نمایش استفاده میشود از طریق IRNIC Terms URL به ماژول معرفی میشود. این فیلد آدرس یک صفحه html را فرخوانی میکند و متن آن را در جای مناسب جانویسی میکند. به صورت پیشفرض مقدار این فیلد آدرس زیر است:
https://www.nic.ir/Domain_Register_Policy
جهت تسریع لود صفحه تسویه حساب پیشنهاد میشود یک نسخه از صفحه فوق را بر روی هاست خود ذخیره کنید و آدرس آن را در فیلد IRNIC Terms URL وارد کنید. برای مثال اگر فایل در پوشه public_html هاست شما با نام irnic-terms.html ذخیره شده باشد و آدرس دامنه شما www.webalfa.net باشد، آدرس را به صورت زیر وارد کنید.
https://www.webalfa.net/irnic-terms.html
جهت مشخص کردن محلی از قالب شما که در صفحه تسویه حساب قوانین بایستی نمایش داده شود نیاز است که بر اساس jQuery Selector فیلد IRNIC Terms Location Selector را تعریف کنید. همچنین مقادیر پیشنهادی برای قالب پیشفرض در ادامه آمده است.
قالب standard_cart
#applyCreditContainer
امکان ثبت سفارش با تنها یک نام سرور #
یکی از الزمات جدید ایرنیک برای تایید فرآیند فروش نمایندگان، امکان ثبت سفارش تنها با یک نام سرور است. با توجه به اینکه WHMCS از ثبت سفارش با یک نام سرور پشتیبانی نمیکند راهکاری جهت حل این مورد پیاده سازی شده است. جهت استفاده از قابلیت Add Support for Single NS to WHMCS را فعال کنید.
جلوگیری از تغییر رابط اداری بعد از ثبت دامنه #
یکی از الزمات جدید ایرنیک برای تایید فرآیند فروش نمایندگان، جلوگیری از تغییر رابط اداری دامنه است. با توجه به اینکه WHMCS از چنین قابلیتی پشتیبانی نمیکند راهکاری جهت حل این مورد پیاده سازی شده است. جهت استفاده از قابلیت Make Admin Contact Readonly را فعال کنید.
استفاده از رابط نماینده به عنوان در صورت خالی بودن شناسه‌های اداری، فنی و مالی #
در صورتی که تمایل دارید در صورت خالی ماندن شناسه‌های اداری، فنی، مالی در فرآیند ثبت سفارش شناسه نمایندگی شما بکار گرفته شود و یا تنها تمایل دارید فیلد مربوط به شناسه صاحب امتیاز را جهت ثبت بکار بگیرید و مابقی شناسه ها در فرآیند ثبت/انتقال دامنه با شناسه شما تکمیل گردد، میتوانید گزینه Use Reseller Handle as Default Admin/Tech/Bill Handles را فعال کنید. همچنین در صورتی که تمایل دارید این گزینه غیر فعال نگهدارید ولی در رابط کاربری فرآیند سفارش به صورت پیشفرض شناسه شما نوشته شود میتوانید از در فایل additionalfields.php مقدار Default را با شناسه مورد نظر خود مقدار دهی کنید.
