مجلد assets

يحتوي على جميع موارد الواجهة الأمامية: الأنماط، سكريبتات التفاعل، والوسائط (الصور/الأيقونات/الفيديوهات).

المحتويات النموذجية

• *.css: مثل style.css لتنسيق الصفحات والـ widgets.
• *.js: مثل main.js, cart.js, product.js, search.js, sidebar.js, pagination.js, swiper-init.js للتفاعل ومعالجة البيانات.
• الوسائط (.webp, .svg, .mp4): صور المنتجات/البانرات، الأيقونات، أو فيديوهات ترويجية.

كيفية التضمين

• في layout.njk أو أي قالب Nunjucks، استخدم فلتر assets:

<link rel="stylesheet" href="{{ 'style.css' | assets }}">
<script src="{{ 'main.js' | assets }}"></script>

• حمّل سكريبتات إضافية عند الحاجة (بالترتيب بعد تبعياتها):

<script src="{{ 'cart.js' | assets }}"></script>
<script src="{{ 'product.js' | assets }}"></script>

• مرر مسارات الوسائط للـ widgets عبر JSON الصفحة/الإعدادات:

{
  "video_src": "a608fda95ffd4e489765a194c7d84c14.HD-720p-2.1Mbps-31583796_v=0.mp4"
}

نصائح

• استخدم أسماء ملفات واضحة وفضّل الصيغ المضغوطة (WebP) لتقليل الحجم.
• انتبه لترتيب التبعيات (مثل swiper-init.js بعد تحميل Swiper).