قوالب البريد الإلكتروني والمتغيرات

يستخدم Extendy GeoShield قوالب WHMCS General email templates وWHMCS SendEmail لتنبيهات أمان تسجيل الدخول.

لا تنشئ الإضافة نصوص بريد عشوائية عند وقت الإرسال. بل تضمن وجود سجلات قوالب WHMCS المطلوبة، ثم تمرر متغيرات مخصصة إلى WHMCS SendEmail.

نموذج القوالب

يستخدم Extendy GeoShield حالياً قالبين من نوع WHMCS General email templates:

Extendy GeoShield - Login Alert
Extendy GeoShield - Smart New Country Alert

تنشئ الإضافة سجلات القوالب المفقودة تلقائياً أثناء تفعيل الإضافة ومن مسار عرض إدارة الإضافة.

إذا كان القالب موجوداً مسبقاً، لا يكرره Extendy GeoShield ولا يستبدل محتواه الحالي.

القوالب التي يتم إنشاؤها هي قوالب WHMCS general في صف اللغة الرئيسي/الافتراضي.

غرض القوالب

القالب	الغرض
Extendy GeoShield - Login Alert	تنبيه أمان تسجيل دخول عادي، بما في ذلك تنبيهات الدولة غير المعروفة / فشل اكتشاف الدولة عندما يكون ذلك مكوّناً
Extendy GeoShield - Smart New Country Alert	تنبيه دولة جديدة في Smart Mode عندما تكون الدولة المكتشفة جديدة بالنسبة إلى سياق WHMCS User وClient Account

يمكن أن يتضمن قالب Smart trust_country_url عندما يكون الحدث مؤهلاً لرابط ثقة Smart Mode.

تنبيه تسجيل الدخول العادي لا يحصل على رابط ثقة.

تعديل القوالب

القوالب هي سجلات قوالب بريد إلكتروني في WHMCS. يمكن للمسؤولين مراجعتها وتعديلها من خلال واجهة WHMCS Email Templates.

ضع هذه القيود في الاعتبار:

• لا تزل المتغيرات التي يعتمد عليها سير عمل التنبيه لديك؛
• لا تضف بيانات اعتماد مزود، أو API tokens، أو ردود مزود خام، أو رؤوس طلبات، أو كوكيز، أو جلسات، أو بيانات اعتماد قاعدة بيانات؛
• لا تكوّن مستلمين منسوخين لقوالب تنبيهات Extendy GeoShield إلا إذا كنت تريد عمداً أن تتجاوز الإضافة إرسال تلك التنبيهات؛
• أبق أسماء القوالب كما هي ما لم يتم تغيير كود الإضافة وفقاً لذلك.

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

المتغيرات

يمرر Extendy GeoShield هذه المتغيرات المخصصة إلى WHMCS SendEmail.

المتغير	المعنى	قد يكون غير معروف أو فارغاً
client_name	اسم عرض العميل من WHMCS Client Profile، باستخدام اسم الشركة عند توفره، وإلا الاسم الأول/الأخير، وإلا Client	لا، يتم توفير Client كقيمة احتياطية
client_email	عنوان البريد الأساسي في WHMCS Client Profile من tblclients.email	يتم تجاوز الإرسال إذا لم يتوفر بريد أساسي صالح
user_email	عنوان بريد WHMCS User الذي نفذ تسجيل الدخول	نعم، يمكن أن يكون Unknown إذا لم يتوفر
login_ip	عنوان IP العام للعميل كما تم تخزينه في حدث تسجيل الدخول	نعم، يمكن أن يكون Unknown
login_country	اسم دولة GeoIP المخزن في حدث تسجيل الدخول	نعم، يمكن أن يكون Unknown Country
login_country_code	رمز دولة GeoIP المخزن في حدث تسجيل الدخول	نعم، يمكن أن يكون UNKNOWN
login_time	الطابع الزمني المخزن لحدث تسجيل الدخول	نعم، يمكن أن يكون Unknown
login_provider	مزود GeoIP المخزن في حدث تسجيل الدخول	نعم، يمكن أن يكون Unknown
alert_mode	وضع التنبيه المخزن في حدث تسجيل الدخول	نعم، يمكن أن يكون Unknown
trust_country_url	رابط ثقة Smart Mode لتنبيهات Smart New Country المؤهلة	نعم، يكون فارغاً للتنبيهات العادية والأحداث غير المؤهلة
support_url	رابط تذكرة دعم WHMCS المبني على WHMCS System URL	نعم، يمكن أن يكون فارغاً إذا لم يتوفر System URL

بريد WHMCS User وبريد Client Profile مفهومان مختلفان:

• client_email هو سياق مستلم البريد للـ Client Account.
• user_email هو WHMCS User الذي نفذ تسجيل الدخول.

محتوى القالب الافتراضي

عندما ينشئ Extendy GeoShield القوالب، يتضمن المحتوى الافتراضي ملخصاً موجزاً لتسجيل الدخول:

• بريد Client Profile.
• بريد مستخدم تسجيل الدخول.
• عنوان IP لتسجيل الدخول.
• الدولة ورمز الدولة.
• وقت تسجيل الدخول.
• مزود GeoIP.
• وضع التنبيه.
• رابط الدعم.

يتضمن قالب Smart New Country أيضاً نص رابط ثقة شرطياً باستخدام trust_country_url.

إذا كان trust_country_url فارغاً، يوضح قالب Smart الافتراضي أن إجراء الثقة بالدولة غير متاح لذلك التنبيه.

القيم غير المعروفة

يمكن أن تكون بعض الحقول غير معروفة بسبب بيئة النشر، أو إعدادات مصدر IP، أو إعدادات المزود، أو نتيجة اكتشاف الدولة.

أمثلة:

• login_ip = Unknown
• login_country = Unknown Country
• login_country_code = UNKNOWN
• login_provider = Unknown

القيم غير المعروفة لا تعني تلقائياً أن تسجيل الدخول خبيث. بل تعني أن الإضافة لم تتمكن من تعبئة تلك القيمة المحددة للحدث.

سلوك اللغة

تنشئ الإضافة صفوف قوالب WHMCS الرئيسية/الافتراضية فقط.

لا تنشئ حالياً صفوف قوالب عربية أو مترجمة أو خاصة بلغة العميل.

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

ملاحظات الأمان

يجب ألا تتضمن قوالب البريد الإلكتروني أبداً:

• بيانات اعتماد المزود؛
• API tokens؛
• بيانات اعتماد قاعدة البيانات؛
• ردود المزود الخام؛
• قيم hash لرموز الثقة الخام؛
• الكوكيز أو الجلسات أو رؤوس الطلبات؛
• debug dumps.

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

لقواعد إرسال التنبيه، راجع تنبيهات البريد الإلكتروني.