السجلات
تمتلك نقطة البيع واجهتي سجلّات: سجل النشاط داخل التطبيق (داخل تطبيق نقطة البيع) وصفحة السجلات في WP Admin (داخل WordPress). معًا تمنحانك صورة كاملة عن نشاط نقطة البيع لأغراض التصحيح والتدقيق.
سجلات تطبيق نقطة البيع
اعتبارًا من الإصدار 1.10.0، يوجد السجل داخل التطبيق في صحة المتجر → السجلات (رمز نبض القلب في درج التنقل — أما شاشة السجلات المستقلة التي حلّ محلها فقد أُزيلت). يصف هذا القسم سجل الإصدار 1.10.0؛ انظر صحة المتجر للاطلاع على جولة كاملة في تلك المنطقة.
الوصول إلى السجلات
افتح صحة المتجر من درج التنقل الأيسر (رمز نبض القلب) واختر علامة التبويب السجلات.
نظرة عامة على الواجهة
السجل هو دفتر لنشاط هذا الجهاز، يُحتفظ به لمدة 30 يومًا. ويعرض كل صف ما يلي:
| العمود | الوصف |
|---|---|
| الوقت | متى وقع الحدث |
| المستوى | الخطورة — خطأ، أو تحذير، أو إجراء، أو مزامنة، أو معلومة |
| الحدث | وصف يمكن قراءته من قبل الإنسان (يُترجَم عند العرض) |
| المدة | المدة التي استغرقتها العملية |
| الحالة | النتيجة |
فوق الدفتر، يعرض سطر حالة نبض المزامنة — متى جرى آخر فحص للتغييرات ومتى يحين الفحص التالي — كما يحصي رأس إحصائي أحداث اليوم وأخطاءه، والسجلات المتوقفة، والتغييرات في انتظار الإرسال. ومعظم هذه العناصر عوامل تصفية قابلة للنقر.
التصفية
تُصفّي شرائح جاهزة الدفتر: الكل، والإجراءات (ما قام به شخص — مبيعات، وتعديلات، وتغييرات إعدادات)، والأخطاء، والمزامنة. ويوجد مفتاح منفصل باسم التشخيصات المفصّلة يلتقط تفاصيل إضافية لمدة 24 ساعة ثم يُطفئ نفسه تلقائيًا.
تفاصيل الصف ورموز الخطأ
انقر على صف خطأ أو تحذير لتوسيعه. ويمنحك عرض التفاصيل ما يلي:
- ما الذي حدث، بلغة واضحة
- بياناتك — بيان صريح عن سلامة البيانات (مثل ما إذا كان التغيير آمنًا على الخادم أم موجودًا على هذا الجهاز فقط)
- ما ينبغي فعله — الخطوة التالية الموصى بها
- رابط مساعدة — تحمل الأخطاء رمزًا (مثل
SYNC121أوAUTH311) يرتبط بوثائق رموز الخطأ - رمز حدث قابل للنسخ — تُترجَم عناوين الصفوف عند العرض، لذا فرمز الحدث هو المعرّف الثابت. اذكره عند التواصل مع الدعم.
صفحة السجلات في WP Admin
توفّر إضافة نقطة البيع أيضًا صفحة سجلّات على جانب الخادم في منطقة إدارة WordPress. تعرض هذه الصفحة التحذيرات والأخطاء الخاصة بنقطة البيع المسجَّلة على الخادم، مما يساعد في تشخيص المشكلات التي قد لا تظهر في تطبيق نقطة البيع نفسه.
الوصول إلى صفحة السجلات في WP Admin
انتقل إلى WP Admin > POS > Settings، ثم اختر علامة التبويب Tools وانقر Logs.
شارة غير المقروء
يعرض عنصر قائمة السجلات شارة تشير إلى إدخالات السجل غير المقروءة:
- شارة حمراء - توجد إدخالات غير مقروءة بمستوى خطأ
- شارة كهرمانية - توجد إدخالات غير مقروءة بمستوى تحذير (لكن دون أخطاء)
تؤدي زيارة صفحة السجلات إلى إعادة تعيين أعداد غير المقروء. تُتتبّع الأعداد لكل مستخدم، فيرى كل مسؤول حالته الخاصة من غير المقروء.
تصفية الإدخالات
استخدم مرشّح المستوى لتضييق إدخالات السجل:
- All - عرض جميع إدخالات السجل
- Errors - عرض الإدخالات بمستوى خطأ فقط
- Warnings - عرض الإدخالات بمستوى تحذير فقط
الإدخالات القابلة للتوسيع
تُقتطع رسائل السجل الطويلة عند نحو 100 حرف. انقر على إدخال لتوسيعه ورؤية الرسالة الكاملة مع أي بيانات سياق إضافية.
ترقيم الصفحات
تُرقّم إدخالات السجل على جانب الخادم. استخدم عناصر التحكم في ترقيم الصفحات للتنقّل بين الإدخالات الأقدم.
شريط الأخطاء الفادحة
إذا كانت لدى الخادم ملفات fatal-errors-*.log، تعرض صفحة السجلات شريط تحذير في الأعلى. يرتبط هذا الشريط بـ WooCommerce > Status > Logs حيث يمكنك عرض سجلات الأخطاء الفادحة الكاملة. الأخطاء الفادحة عادةً ما تكون أعطالًا على مستوى PHP تمنع واجهة نقطة البيع البرمجية من الاستجابة.
استخدام السجلات للدعم
عند طلب الدعم:
- إعادة إنتاج المشكلة - نفّذ الإجراء الذي يسبّب المشكلة
- تحقّق من السجلات - ابحث عن الأخطاء أو التحذيرات في صحة المتجر → السجلات
- وسّع الصف - اقرأ سطر سلامة البيانات والخطوة التالية المقترحة
- انسخ رمز الحدث - ضمّنه في طلب الدعم الخاص بك؛ فهو المعرّف الثابت لما حدث
- فعّل التشخيصات المفصّلة إذا طلب الدعم مزيدًا من التفاصيل — فهي تلتقط معلومات إضافية لمدة 24 ساعة
مراقبة الأداء
يوجد الأداء الإجمالي في صحة المتجر → الأداء: عدد الطلبات، وحجم البيانات المنقولة (وهو حد أدنى عندما تغفل الاستجابات حجمها)، وزمن الاستجابة المعتاد خلال آخر 24 ساعة، إضافة إلى شريط التشغيل بالساعة. وإذا بدت أزمنة الاستجابة مرتفعة، فانظر أداء الخادم.