الإعدادات
الإعدادات العامة
هذه الصفحة لبقية تبويبات الإعدادات. هي لمشرف WHMCS. اسم النظام هو مفتاح الإعداد المخزّن.
عام
الإعدادات → العام

| الاسم الظاهر | اسم النظام | النوع | الافتراضي |
|---|---|---|---|
| اسم الموقع | site_name |
نص | — |
| روابط نظيفة | pretty_urls |
نعم/لا | لا |
| المسار الأساسي | pretty_base |
نص | status |
| وضع التطوير | debug_mode |
نعم/لا | لا |
| إنشاء الحوادث تلقائيًا | auto_incident |
نعم/لا | لا |
| إغلاق الحوادث تلقائيًا | auto_resolve |
نعم/لا | لا |
| التقرير الأسبوعي | weekly_report |
نعم/لا | لا |
| قائمة IP للكرون | cron_ip_whitelist |
نص | — |
| حذف القاعدة عند الإيقاف | drop_on_deactivate |
نعم/لا | لا |
| الاحتفاظ بنتائج الفحص (أيام) | checks_retention_days |
رقم | 180 |
| الاحتفاظ بسجل النشاط (أيام) | audit_retention_days |
رقم | 180 |
| المنطقة الزمنية | timezone |
نص | افتراضي الخادم |
pretty_urls يحوّل مسار منطقة العميل إلى /status/{slug} باستخدام pretty_base. debug_mode يكتب تفاصيل الكرون في سجل النشاط وقد يُظهر أخطاء PHP للزوار، فاتركه مغلقًا على موقع حي. auto_incident يفتح حادثة فقط بعد بقاء المراقبة Down. auto_resolve يغلق تلك الحادثة عند عودة المراقبة إلى Up. cron_ip_whitelist قائمة مفصولة بفواصل. القائمة الفارغة لا تقيّد رابط الكرون. drop_on_deactivate يحذف بيانات الإضافة عند إيقاف الوحدة.
Warning
فعّل وضع التطوير في بيئات التطوير فقط. قد يُظهر تفاصيل أخطاء داخلية للزوار.
إعدادات العرض والتخطيط
الإعدادات → العرض
يوفر هذا التبويب تحكماً كاملاً في مظهر وتصرف صفحة الحالة العامة.

تخطيط الصفحة (Page Layout)
| الإعداد | الوصف | الخيارات |
|---|---|---|
| تخطيط البطاقة (Card Layout) | أسلوب التخطيط لصفحة الحالة | شبكة من عمودين / شبكة من 3 أعمدة / قائمة بعرض كامل |
| عرض الصفحة (Page Width) | التحكم بعرض محتوى الصفحة | حاوية (Container) / ضيق (Narrow) / عرض كامل (Fluid) |
| تجميع بواسطة (Group By) | كيفية تجميع المراقبات | اسم المجموعة / نوع المراقبة / بدون تجميع |
| سجل الخريطة الحرارية (Heatmap) | المدة الزمنية المعروضة للخريطة الحرارية | 24 ساعة / 7 أيام / 30 يوماً / 90 يوماً |
| التحديث التلقائي (Auto-Refresh) | تحديث الصفحة تلقائياً (AJAX) دون إعادة تحميل | معطّل / 30 ثانية / 60 ثانية / دقيقتين |
| تنسيق التاريخ (Date Format) | طريقة عرض الوقت والتاريخ | نسبي (منذ 3 دقائق) / مطلق / كلاهما |
| نمط الحوادث (Incident Style) | شكل عرض قائمة الحوادث | خط زمني (Timeline) / قائمة بسيطة / أكورديون |
| حد عرض الحوادث (Show Incidents) | عدد الحوادث الأخيرة الظاهرة | 5 / 10 / 20 / الكل |
محتوى البطاقة (Card Content)
يتيح لك هذا القسم إظهار أو إخفاء عناصر محددة داخل بطاقات المراقبة عبر صناديق تحديد (Checkboxes):
- الخريطة الحرارية (Heatmap)
- نسبة التوفر (Uptime %)
- زمن الاستجابة (Response time)
- وقت آخر فحص (Last checked)
- نوع المراقبة (Monitor type)
- مخطط الاستجابة (Response chart)
- نتائج المناطق (Region results)
- شارة SLA (SLA badge)
- شارة الصيانة (Maintenance badge)
- شريط الاشتراك (Subscribe bar)
صفوف البطاقة (Card Rows per Layout)
ميزة سحب وإفلات (Drag and Drop) متقدمة تتيح لك تخصيص البيانات التي تظهر في الصف الأول والصف الثاني لكل تخطيط (شبكة 3 أعمدة، شبكة عمودين، قائمة).
تكوين الحوادث (Incident Configuration)
تخصيص كامل لحالات ومستويات خطورة الحوادث:
- حالات الحوادث (Incident States): قائمة مفصولة بفواصل (الافتراضي: investigating, identified, monitoring, resolved).
- مستويات خطورة الحوادث (Incident Severities): قائمة مفصولة بفواصل (الافتراضي: info, minor, major, critical).
السمة (Theme)
- اللون الأساسي (Primary Color): أداة لاختيار لون العلامة التجارية (Brand color) لصفحة الحالة.
- نمط البطاقة (Card Style): التحكم في حواف البطاقات (حادة Sharp، دائرية Rounded، أو بيضاوية Pill).
إعدادات الألوان
الإعدادات → الألوان

يوفر تبويب الألوان محرراً لونياً كاملاً لشارات حالات الحوادث وشارات مستويات الخطورة في كلا الوضعَين الفاتح والداكن.
مجموعات ألوان الحالات
خصّص مظهر الشارة لكل حالة حادثة:
| الحالة | الألوان الافتراضية (فاتح) |
|---|---|
| قيد التحقيق | خلفية عنبرية |
| محددة | خلفية نيلية |
| قيد المراقبة | خلفية زرقاء سماوية |
| محلولة | خلفية خضراء |
مجموعات ألوان الخطورة
| الخطورة | الألوان الافتراضية (فاتح) |
|---|---|
| حرجة | خلفية حمراء |
| رئيسية | خلفية عنبرية |
| ثانوية | خلفية زرقاء |
| إعلامية | خلفية رمادية |
لكل مجموعة لونية أربعة حقول قابلة للتخصيص:
| الحقل | ما يتحكم فيه |
|---|---|
| لون النص | لون نص الشارة |
| لون الخلفية | لون تعبئة الشارة |
| لون الحدود | لون حدود الشارة |
| خلفية الصندوق | صبغة خلفية البطاقة/الصندوق |
تُعرض معاينة حية أثناء التعديل.
إعدادات الإشعارات
الإعدادات → الإشعارات

| القناة | الضبط |
|---|---|
| البريد الإلكتروني | يستخدم إعدادات البريد في WHMCS؛ لا إعداد إضافي |
| Webhook | أدخل رابط Webhook (يجب أن يستخدم HTTPS)؛ ترسل الإضافة POST بصيغة JSON عند كل تغيير في الحالة |
| Telegram | أدخل رمز Bot Token وChat ID الخاص بـ Telegram |
Note
يجب أن تستخدم روابط Webhook بروتوكول HTTPS. تُرفض أهداف Webhook العادية HTTP لأسباب أمنية.
قواعد التصعيد
الإعدادات → التصعيد

تُشغّل قواعد التصعيد إشعارات إضافية عندما تظل مراقبة معطّلة لمدة محددة.
| الحقل | الوصف |
|---|---|
| المراقبة | تطبيق على مراقبة محددة، أو اتركه فارغاً لجميع المراقبات |
| بعد (دقائق) | دقائق التعطّل المتواصل قبل تشغيل التصعيد |
| القناة | email أو webhook أو telegram |
| الهدف | عنوان البريد أو رابط Webhook أو معرّف محادثة Telegram |
| مفعّل | التبديل دون حذف |
المجموعات والوسوم
الإعدادات → المجموعات والوسوم

| الميزة | الوصف |
|---|---|
| المجموعات | إنشاء مجموعات عرض لكل صفحة حالة وإعادة ترتيبها؛ اسحب لضبط الترتيب |
| الوسوم | إدارة قائمة الوسوم للفلترة السريعة في قائمة المراقبات |
المجموعات تؤثر فقط على التنظيم البصري على صفحة الحالة. الوسوم للفلترة الإدارية الداخلية.
إعدادات Section API
الإعدادات → Section API

توفر Section API نقطة اتصال JSON متوافقة مع ودجت عرض الأقسام في قالب WHMCS Lagom. اضبط حقول المراقبة والحوادث المضمّنة في الاستجابة.
| الحقل | الوصف |
|---|---|
| رابط نقطة الاتصال | رابط JSON العام لتكامل قسم Lagom |
| حقول البطاقة | حقول بيانات المراقبة المضمّنة في إخراج JSON للبطاقة |
| حقول الحوادث | حقول الحوادث المضمّنة |
إعدادات الوكلاء (الوكلاء الموزّعون)
الإعدادات → الوكلاء

الوكلاء الموزّعون نصوص برمجية بعيدة (PHP أو Python) تُجري فحوصات من خوادم خارجية وترسل النتائج إلى تثبيتك الرئيسي.
| الحقل | الوصف |
|---|---|
| اسم الوكيل | تسمية ودية لهذا الوكيل |
| المنطقة | معرّف المنطقة المستخدم لمطابقة نتائج الوكيل بالمراقبات (مثل us-east, eu-west) |
| رمز الوكيل | رمز أمان مُولَّد تلقائياً للمصادقة على الوكيل |
| IP المسموح به | اختياري: تقييد الإرسال لعنوان IP محدد |
| مفعّل | تفعيل أو إيقاف الوكيل مؤقتاً |
بعد إنشاء وكيل، تُظهر لوحة تعليمات الإعداد الأمر الدقيق لنشر نص الوكيل على الخادم البعيد، متضمناً الرمز ورابط نقطة الاتصال.
[!IMPORTANT] احتفظ برموز الوكلاء سرية. أي شخص يمتلك رمزاً صالحاً ومعرّف وكيل يمكنه إرسال نتائج الفحص.
إعدادات الشارات
الإعدادات → الشارات

شارات الحالة صور SVG قابلة للتضمين تُظهر الحالة الحية لمراقبة أو صفحة حالة.
أنواع الشارات
| النوع | الوصف |
|---|---|
| شارة الصفحة | تُظهر حالة الصفحة الإجمالية (جميع الأنظمة تعمل / انقطاع) |
| شارة المراقبة | تُظهر حالة مراقبة واحدة (يعمل / معطّل) |
أنماط الشارات
| النمط | المظهر |
|---|---|
flat |
تسمية ملونة مسطحة |
flat-square |
مسطحة بزوايا مربعة |
for-the-badge |
شارة كبيرة بخط عريض |
plastic |
شارة بتدرج ثلاثي الأبعاد |
معاملات رابط الشارة
| المعامل | الوصف |
|---|---|
style |
نمط الشارة (انظر أعلاه) |
label |
نص التسمية المخصصة للجانب الأيسر |
color |
تجاوز لون الشارة |
خلاصة RSS
لكل صفحة حالة رابط خلاصة RSS عامة للمشتركين الذين يفضّلون قارئات الخلاصة على البريد. تتضمن الخلاصة أحدث الحوادث وحالاتها الراهنة.
إعدادات Cron
الإعدادات → Cron

| الحقل | الوصف |
|---|---|
| رمز Cron | رمز الأمان المضمّن في رابط cron؛ أعِد توليده لإلغاء الروابط القديمة |
| فاصل الفحص | الفاصل الزمني الافتراضي للفحص (بالثواني) المطبَّق على المراقبات الجديدة |
| رابط Cron | الرابط الكامل للاستدعاء من مهمة cron خارجية |
| حالة WHMCS Cron | يُظهر ما إذا كان Hook AfterCronJob في WHMCS قد عمل مؤخراً |
انسخ رابط Cron وأضفه إلى Cron الخادم:
*/5 * * * * curl -s "https://yourwhmcs.com/index.php?m=UptimeMonitor2&action=cron&token=..." >/dev/null
Tip
أعِد توليد رمز cron دورياً أو بعد الاشتباه في كشف الرابط.