← العودة للفهرس

الوكلاء

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

المجموعة: CMS & Website اسم القائمة: Dealers الرابط: /admin/dealers الأيقونة: دبوس خريطة

محتويات الصفحة

1. الغرض من هذه الشاشة 2. صورة تقريبية — القائمة 3. صورة تقريبية — النموذج 4. جدول الحقول 5. الأعمدة والأوامر 6. كيف تضيف وكيلاً 7. كيف تعدّل أو تخفي 8. أين يظهر على الموقع 9. سيناريو عملي 10. أخطاء شائعة

1. الغرض من هذه الشاشة

الاستخدام: «أين أشتري؟» — قائمة وكلاء معفلاتر دولة/مدينة وروابط خرائط. ليست مورّدي المصنع الداخليين (شاشة Suppliers) وليست مستخدمي اللوحة (Users).

هذه الشاشةليست
وكلاء ظاهرون للزائرSuppliers — مصانع/موردون داخليون للمنتج
عنوان وخريطة واتسابعملاء التطبيق App Customers
الموظف يضيف ويخفي بـ Is activeصندوق رسائل — الزائر لا يُنشئ وكيلاً

2. صورة تقريبية — القائمة

Marvel Techadmin / dealers
CMS & Website
Catalogs
Dealers
Dealers+ New
NameCountryCityPhoneIs activeSort order
Al Noor TradingIraqBaghdad+964… 0
Sham ElectricSyriaDamascus+963… 1

مرتّبة حسب Sort order. فلتر Is active. Country يمكن إخفاؤه.

3. صورة تقريبية — النموذج

Create DealerCreate
Al Noor Trading
النور للتجارة
Iraq
العراق
Baghdad
بغداد
Street, district…
+964…
9647…
33.3152
44.3661
0

4. جدول الحقول

الاسم الظاهرالاسم التقنيمطلوب؟الشرح
Namenameمطلوبالاسم الإنجليزي. يظهر في الموقع بلغة EN
Name (AR)name_arاختياريالاسم العربي — املأه للموقع العربي
Country / Country (AR)countryاختياريللعرض وللتصفية في صفحة الوكلاء
City / City (AR)cityاختيارينفس الفكرة على مستوى المدينة
Address / Address (AR)addressاختياريعرض كامل الصفحة. يُستخدم في رابط الخرائط إن لم تُذكر الإحداثيات
Phonephoneاختياريحقل هاتف
Emailemailاختيارييجب أن يكون بريداً صالحاً إن مُلئ
Whatsappwhatsappاختياريرقم واتساب للتواصل السريع
Latitude / Longitudelatitude / longitudeاختياريإن وُجدا يُنشأ رابط Google Maps بالإحداثيات. أدخلاهما من الخرائط (مثال بغداد ≈ 33.31 ، 44.36)
Products available / (AR)products_availableاختياريماذا يبيع هذا الوكيل (إنارة، بطاريات…)
Notesnotesاختياريملاحظات داخلية — لا تُرسل في واجهة الموقع الحالية
Is activeis_activeافتراضي مفعّلالموقع يعرض النشطين فقط
Sort ordersort_orderافتراضي 0الأصغر أولاً ثم الاسم

5. الأعمدة والأوامر

Name، Country، City، Phone، Is active، Sort order. Edit / Delete وحذف جماعي.

لإخفاء وكيل من الموقع عطّل Is active بدل الحذف حتى لا تُفقد البيانات.

6. كيف تضيف وكيلاً

  1. CMS & Website ← Dealers ← New.
  2. املأ Name و Name (AR) والدولة والمدينة باللغتين.
  3. أضف هاتف/واتساب/عنوان.
  4. انسخ Latitude و Longitude من خرائط غوغل إن أمكن.
  5. Is active = تشغيل — Create.
  6. افتح /dealers وتحقق بالعربي والإنجليزي.

7. كيف تعدّل أو تخفي

Edit لأي حقل. إيقاف Is active يخفي الوكيل من الصفحة فوراً مع بقائه في اللوحة.

8. أين يظهر على الموقع

صفحة /dealers عبر /api/v2/storefront/dealers. الزائر يصفّي بالدولة والمدينة. النشطون فقط. إن وُجدت إحداثيات يظهر رابط الخريطة.

9. سيناريو عملي

  1. وكيل جديد في بغداد: Name + Name (AR) + Country Iraq / العراق + City Baghdad / بغداد.
  2. أدخل الإحداثيات من الخرائط وواتساب.
  3. Products available = Lighting — Create.
  4. في /dealers اختر العراق → بغداد وتأكد من ظهور البطاقة.

10. أخطاء شائعة

ما يحدثالسببالحل
لا يظهر في الموقعIs active مغلقفعّل Is active
الاسم فارغ بالعربيةName (AR) فارغأملأ الحقول العربية
لا رابط خريطة دقيقبلا إحداثيات ولا عنوانأضف lat/lng أو عنواناً واضحاً
خلط مع Suppliersالمورد الداخلي ≠ الوكيل الظاهرSuppliers للمنتج في المخزون — Dealers للزائر