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

البانرات

وسائط ترويجية (صورة أو فيديو) مع رابط اختياري. مخصّصة لعرض إعلاني واحد أو أكثر، وليست شاشات ترحيب متسلسلة.

المجموعة: CMS & Website اسم القائمة: Banners الرابط: /admin/banners الأيقونة: صورة

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

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

1. الفرق بين Banners و Sliders

الشاشتان تبدوان متشابهتين (صورة + نص + رابط) لكن الغرض مختلف. لا تضع محتوى الترحيب في البانرات ولا الإعلان الترويجي في الشرائح.

Banners — البانراتSliders — الشرائح
الغرض إعلان أو وسائط ترويجية (صورة أو فيديو) شاشات ترحيب متسلسلة بصورة وعنوان ووصف
أين تُستخدم غالباً كاروسيل الرئيسية في تطبيق الجوال (/api/home/banners) شاشات أول فتح للتطبيق — Onboarding (/api/onboarding)
الوسائط صورة أو ملف فيديو أو رابط فيديو (حتى 10MB للملف) صورة فقط (JPEG/PNG/WebP حتى 2MB)
النصوص عنوان واحد + محتوى اختياري — بلا حقول عربية منفصلة في النموذج عنوان ووصف بالإنجليزية والعربية
الترتيب والإخفاء لا يوجد Sort order ولا Active في نموذج اللوحة الحالي يوجد Is active و Sort order
موقع الإنترنت بانرات الصفحة الرئيسية حالياً غير مربوطة بهذه الشاشة ليست شريط Hero في الموقع — Hero الموقع من المنتجات المميزة
قاعدة سريعة: بانر = إعلان (قد يكون فيديو). شريحة = خطوة ترحيب في التطبيق. راجع أيضاً صفحة Sliders.

2. ما هي هذه الشاشة؟

من القائمة الجانبية: CMS & Website ← Banners.

كل سجل = عنصر ترويجي واحد. اختر نوع الوسائط أولاً لأن حقل الملف أو رابط الفيديو يتغيّر حسب الاختيار.

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

Marvel Tech admin / banners
CMS & Website
Banners
Sliders
FAQs
Banners + New
Title Media type Created at
Summer offer image 2026-08-01 10:00 تعديل · حذف
Product film video_file 2026-08-05 12:20 تعديل · حذف
YouTube promo video_url 2026-08-10 09:15 تعديل · حذف

صورة تقريبية — الأعمدة: Title، Media type (شارة)، Created at. لا يوجد عمود Active في هذه القائمة.

4. صورة تقريبية — نموذج الإضافة / التعديل

بعد اختيار Media type يظهر إما رفع ملف أو حقل رابط فيديو.

Create Banner Create
Summer offer
Image
JPEG / PNG / WebP / MP4 / WebM — 10MB
https://example.com/shop
نص اختياري يظهر مع البانر
Create

عند اختيار Video URL يختفي رفع الملف ويظهر حقل Video URL بدل Media File.

5. جدول الحقول بالتفصيل

الاسم الظاهر في اللوحة الاسم التقني مطلوب؟ الشرح
Title title اختياري عنوان داخلي أو ظاهر حسب الواجهة. الحد 255 حرفاً. بلا حقل عربي منفصل في هذه الشاشة.
Media type media_type مطلوب يحدد نوع الوسائط ويغيّر الحقول التالية. القيم في القائمة:
  • Image — صورة (الافتراضي)
  • Video File — رفع ملف فيديو
  • Video URL — رابط فيديو خارجي
Media File media مطلوب إذا النوع Image أو Video File يظهر فقط لهذين النوعين. الصيغ: JPEG / PNG / WebP / MP4 / WebM. الحجم الأقصى 10 ميغابايت. المجلد banners.
Video URL media مطلوب إذا النوع Video URL يظهر بدل رفع الملف. يجب أن يكون رابطاً صالحاً (حتى 500 حرفاً).
Button url button_url اختياري رابط الوجهة عند الضغط. يجب أن يبدأ بـ http أو https. حتى 500 حرفاً.
Content content اختياري نص إضافي من 3 أسطر بعرض كامل الصفحة.
لا يوجد في هذا النموذج مفتاح Active ولا Sort order (موجودان في شاشة Sliders). إخفاء البانر يتم عادة بالحذف أو بعدم استخدامه في الواجهة.

6. أعمدة الجدول وأوامر الصف

العمودملاحظات
Titleبحث + ترتيب
Media typeشارة: image / video_file / video_url
Created atتاريخ الإنشاء — ترتيب
الحذف نهائي. لا يوجد إخفاء بـ Active في هذه الشاشة.

7. كيف تضيف بانراً

  1. CMS & Website ← Banners ← New.
  2. اكتب Title للتمييز في القائمة.
  3. اختر Media type.
  4. صورة أو فيديو ملف: ارفع Media File (حتى 10MB).
  5. فيديو رابط: الصق Video URL.
  6. ضع Button url إن أردت نقرة تفتح صفحة (المتجر مثلاً).
  7. أضف Content اختيارياً ثم Create.

8. كيف تعدّل أو تحذف

  1. ابحث بالعنوان ثم Edit.
  2. غيّر نوع الوسائط بحذر: الحقل الظاهر يتبدّل بين ملف ورابط.
  3. للحذف: Delete مع التأكيد.

9. أين يظهر

تطبيق الجوال: كاروسيل الرئيسية عبر واجهة /api/home/banners.
موقع الإنترنت: بانرات الصفحة الرئيسية حالياً غير مفعّلة وغير مربوطة بهذه الشاشة. تعديل البانر هنا لا يغيّر Hero الموقع.
Summer offer
صورة أو فيديو بعرض الشاشة — نقرة → Button url

صورة تقريبية لبانر ترويجي — عنصر إعلاني وليس سلسلة شرائح ترحيب.

10. سيناريو عملي — إعلان تخفيض

  1. New — Title = Summer offer.
  2. Media type = Image — ارفع صورة أفقية واضحة (WebP/JPG أقل من 10MB).
  3. Button url = رابط صفحة المتجر إن وُجد.
  4. Create. لا تتوقع ظهوره فوراً على موقع الويب؛ راجع تطبيق الجوال إن كان الكاروسيل مفعّلاً.

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

ما يحدثالسبب الغالبالحل
لا يظهر حقل الملف أو الرابط المتوقع Media type غير مطابق Image/Video File → Media File — Video URL → Video URL
رفض رفع الملف صيغة غير مدعومة أو أكبر من 10MB JPEG/PNG/WebP أو MP4/WebM ضمن الحد
Button url مرفوض ليس رابطاً كاملاً ابدأ بـ https://
لا يظهر على موقع الشركة الشاشة تغذّي تطبيق الجوال؛ بانرات الويب غير مربوطة حالياً لا تستخدم Banners لتعديل Hero الموقع
أضفت شاشات ترحيب هنا خلط مع Sliders انقل المحتوى إلى Sliders (عنوان ووصف باللغتين + Active + ترتيب)