نموذج المساهمة
الثيم أو الإضافة شيفرة TypeScript داخل مستودع المنصة، تُراجَع وتُنشر كأي شيفرة أخرى في المنصة. إن كنت مطوراً أو فريقاً يريد بناء واحدة، فهذا يعني العمل مع فريق المنصة على المستودع نفسه — لا رفع ملف جاهز.
تبني تكاملاً لتاجر محدد دون لمس شيفرة المنصة؟ استخدم الواجهة البرمجية والويب هوك (انظر «الاستيثاق» و«الويب هوك») — فهذا ما وُجدا له.
ما الذي يستطيعه الثيم
- يملك الرأس والتذييل والصفحة الرئيسية الافتراضية وترتيب صفحات الأقسام والمنتجات وبطاقة المنتج.
- يأتي بلوحة ألوان (فاتحة وداكنة) تعلوها ألوان علامة التاجر نفسه دائماً.
- يعرض خيارات يضبطها التاجر (نمط الرأس، شكل البطاقة، الشارات…) بعناوين عربية وإنجليزية، مع تحقق على الخادم.
- يختار أنماطاً مسماة لصفحات السلة والدفع والحساب والطلب المشتركة.
يحتفظ التاجر بكامل التحكم في محتواه: الصفحة الرئيسية منشئ صفحات قسماً قسماً (إضافة وحذف وإعادة ترتيب وإخفاء)، والصور تُرفع إلى خادم أصول المنصة، وقائمة محددة من رموز الألوان المتقدمة تغطي حالة «أريد تغيير لون واحد فقط» — أما CSS المخصص الخام فغير مدعوم عمداً.
ما الذي تستطيعه الإضافة
- تسجيل طرق دفع — ست بوابات تعمل بهذه الطريقة اليوم (الدفع عند الاستلام، شام كاش، سيرياتيل كاش، إم تي إن كاش، التحويل اليدوي، PayTabs).
- تسجيل حاسبات شحن — الشحن حسب المحافظة والاستلام من المتجر يعملان بهذه الطريقة.
- إضافة كيانات وواجهات GraphQL ومهام مجدولة وصفحات في لوحة التاجر، والتفاعل مع أحداث المنصة.
- ربط شركات التوصيل والموردين عبر سجلات المحوّلات.
الأدلة والأمثلة العملية
يحوي المستودع أدلة خطوة بخطوة في docs/developer-guide/ — دليل الثيمات مبني حول ثيم «ليالي» ودليل الإضافات مبني حول إضافة «الاستلام من المتجر» (طريقة دفع وحاسبة شحن مع اختبارات). كلا المثالين وُجد ليُنسخ.