إنتقل إلى المحتوى الرئيسي

دليل التثبيت

يغطي هذا الدليل مسار وضع ملفات إضافة WHMCS وتفعيل Extendy GeoShield وفق السلوك المتحقق منه. قد تختلف طريقة تسليم حزمة المنتج حسب الإصدار، لذلك استخدم ملفات الإضافة التي توفرها Extendy لإصدارك.

المتطلبات​

تم بناء Extendy GeoShield للعمل مع WHMCS 9+.

قبل التثبيت، تأكد مما يلي:

  • لديك صلاحية مسؤول في WHMCS؛
  • يمكنك وضع ملفات الإضافة داخل مجلد WHMCS modules/addons/؛
  • تم إعداد daily cron الخاص بـ WHMCS وهو يعمل؛
  • لديك بيانات اعتماد المزود إذا كنت تخطط لاستخدام IPinfo أو MaxMind لاستعلام GeoIP.

تثبيت ملفات الإضافة​

ضع مجلد الإضافة المزوّد داخل تثبيت WHMCS في المسار:

modules/addons/extendy_geoshield/

يجب أن يكون اسم مجلد الإضافة:

extendy_geoshield

لا تعدّل ملفات WHMCS الأساسية.

تفعيل الإضافة​

في WHMCS Admin، افتح منطقة WHMCS Addon Modules وفعّل:

Extendy GeoShield for WHMCS

أثناء التفعيل، يجهّز Extendy GeoShield مخطط قاعدة البيانات الخاص به، والإعدادات الافتراضية، وقوالب البريد الإلكتروني. ولا يزيل التفعيل أي بيانات موجودة مسبقًا للإضافة.

تمتلك الإضافة جداول قاعدة البيانات التالية:

mod_extendy_geoshield_events
mod_extendy_geoshield_known_countries
mod_extendy_geoshield_trust_tokens
mod_extendy_geoshield_settings

فحوصات أولية بعد التفعيل​

بعد التفعيل:

  1. افتح صفحة إدارة إضافة Extendy GeoShield.
  2. راجع تبويب Settings.
  3. حدّد ما إذا كان خيار Addon Enabled يجب أن يبقى No أو يتغير إلى Yes.
  4. اختر GeoIP Provider إذا كنت تريد تحديد الدولة.
  5. أدخل بيانات اعتماد المزود المطلوبة.
  6. اضبط Client IP Source بما يناسب بنية الاستضافة لديك.
  7. تأكد من أن Retention مضبوط على القيمة المطلوبة.
  8. استخدم نموذج GeoIP Provider Test Connection مع عنوان IP عام للاختبار إذا كنت قد أعددت مزودًا.

افتراضيًا، يتم تثبيت الإضافة مع ضبط Addon Enabled على No. ولا تبدأ معالجة عمليات تسجيل الدخول إلا بعد تفعيل الإضافة من إعداداتها.

متطلب cron​

يستخدم Extendy GeoShield خطاف daily cron في WHMCS لتنظيف سجلات الاحتفاظ. تأكد من أن أتمتة cron العادية في WHMCS تعمل بنجاح.

عند ضبط الاحتفاظ على 180 Days، تُنظف سجلات أحداث تسجيل الدخول القديمة الخاصة بـ Extendy GeoShield تلقائيًا عبر cron في WHMCS. وعند ضبطه على Disabled (Automatic Cleanup Off)، يتم تعطيل التنظيف التلقائي.

التعامل مع بيانات الاعتماد​

تُخزّن بيانات اعتماد المزود مشفرة عند التخزين باستخدام تشفير مدعوم من WHMCS. وتعرض صفحة الإدارة حقول بيانات الاعتماد المخزنة كقيم مخفية فقط.

إرسال حقل بيانات اعتماد فارغ يُبقي القيمة المخزنة الحالية. استخدم إجراء المسح/الإزالة الصريح في صفحة الإدارة إذا أردت إزالة بيانات اعتماد مخزنة.

إلغاء التفعيل​

إلغاء التفعيل ليس إزالة كاملة. فهو لا يحذف جداول Extendy GeoShield أو الإعدادات أو أحداث تسجيل الدخول أو دول Smart Mode المعروفة أو رموز الثقة أو قوالب البريد الإلكتروني.

الإزالة الكاملة إجراء يدوي منفصل، ويجب تنفيذها فقط بعد نسخة احتياطية موثقة من قاعدة البيانات.