ماژول ثبت دامنه ایرنیک ویژه نمایندگان رسمی برای 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
ماژول وبآلفا به صورت خودکار و بر اساس میزان زمان باقی مانده تا انقضای دامنه دورههای غیر مجاز تمدید برای دامنههای ملی را غیر فعال میکند.
انتخاب نوع انتقال #
جهت مشخص کردن محلی از قالب شما که در صفحه تسویه حساب قوانین بایستی نمایش داده شود نیاز است که بر اساس jQuery Selector فیلد IRNIC Terms Location Selector
را تعریف کنید. همچنین مقادیر پیشنهادی برای قالب پیشفرض در ادامه آمده است.
قالب standard_cart
#applyCreditContainer