ابنِ أول ثيم لك في سوق الثيمات: من البنية إلى النشر

كيف يُبنى ثيم زد؟

الثيم في زد ليس تصميمًا فقط، بل طبقة العرض الكاملة لواجهة متجر التاجر. ويجمع كل ثيم ثلاثة عناصر:

• قوالب Jinja تربط مسارات المتجر (الرئيسية، المنتج، السلة...) بصفحات فعلية.
• ملفات HTML وCSS وJavaScript للتخطيط والتفاعل.
• ملفات مخطط JSON تعرض إعدادات قابلة للتخصيص في محرر الثيم.

تُرتَّب الواجهة في طبقات: Layout يحدد الغلاف الأساسي للصفحة، ثم Sections وهي كتل الصفحة الرئيسية ولكل منها ملف .jinja ومخطط .schema.json، ثم Components وهي وحدات قابلة لإعادة الاستخدام داخل الأقسام. تُحفظ الأصول في مجلد assets/ وتُقدَّم عبر CDN زد، والترجمات في locale/ar/LC_MESSAGES/messages.po.

قواعد أساسية قبل أن تكتب أول سطر

• يجب أن تمتد كل القوالب من الـLayout الأساسي عبر {% extends "layout.jinja" %}.
• يجب أن يتضمن الـLayout الوسمين {% vitrin_head %} داخل head و{% vitrin_body %} داخل body.
• إذا لم تنفّذ قالبًا أو مكوّنًا، يستخدم النظام تلقائيًا القالب الافتراضي من ثيم زد الافتراضي، فيمكنك تخصيص صفحات محددة فقط.
• لا تكتب الألوان والخطوط والمسافات بشكل ثابت داخل القوالب؛ اسحبها من إعدادات الثيم حتى يعدّلها التاجر دون كود.
• يجب أن تتبع مخططات الثيم معيار JSON Schema.

التطوير والمعاينة محليًا عبر Vitrin CLI

أداة Vitrin CLI تتيح لك إنشاء الثيم وبناءه ومعاينته ونشره من جهازك مباشرة. تثبيتها وأول الأوامر كما في التوثيق:

npm install -g @zidsa/vitrin-cli

vitrin login        # Authenticate with Zid
vitrin new my-theme # Create a new theme
cd my-theme
vitrin push         # Push theme to Zid

• vitrin build يبني الثيم في حزمة .zip بعد التحقق من البنية.
• vitrin preview يعاين الثيم على متجر تجريبي، ومع --build يبنيه قبل المعاينة.
• vitrin list يعرض الثيمات أو المتاجر التجريبية المتاحة.
• يمكنك كذلك تشغيل vitrin وحده لفتح الواجهة التفاعلية.

إذا فضّلت عدم استخدام الأداة، يمكنك رفع الثيم يدويًا عبر لوحة الشركاء.

اختبر على المتجر التجريبي

المتجر التجريبي متجر خاص تختبر فيه تطبيقاتك وثيماتك قبل نشرها، ويتصرف مثل متجر تاجر حقيقي. أنشئه من لوحة الشركاء عبر Development Stores ثم Create Store.

1. استورد منتجات تجريبية لترى بطاقات المنتجات والتصنيفات والفلاتر.
2. فعّل طرق الدفع والشحن والعروض لتختبر الثيم في إعدادات مختلفة.
3. اختبر التجاوب على الجوال والتابلت وسطح المكتب، ودعم RTL.
4. نفّذ طلبًا كاملًا من السلة حتى الدفع.
5. أضف /validate إلى رابط المعاينة لتحصل على تقرير أداة اختبار الثيم.

ولتتأكد من ملفات الترجمة قبل الرفع، شغّل msgfmt --check -o output.mo input.po 2>&1، ولا ترفع ملف .mo الناتج.

الإرسال للنشر في سوق الثيمات

الثيم العام يظهر في سوق الثيمات لجميع التجار ويمر بمراجعة زد، أما الثيم الخاص فيُبنى لتاجر محدد ولا يمر بالمراجعة. لنشر ثيم عام:

1. من لوحة الشركاء افتح My Themes ثم Themes Management واضغط Create New Theme.
2. أدخل الاسم وارفع ملف ZIP، ثم حدّد السعر والوصف وبيانات العرض.
3. ارفع من 3 إلى 9 صور: سطح المكتب بنسبة 4:3 والجوال بنسبة 9:16 ضمن المقاسات المحددة.
4. وافق على الشروط والأحكام، ثم اضغط Submit to Publish.

تمر حالة الثيم بـ Pending ثم In Review، وتنتهي إلى Published أو Rejected مع ملاحظات بالأسباب. لا يمكنك إرسال تعديلات أثناء In Review. ولاحقًا تحدّث الثيم المنشور من تبويب Update Theme برفع نسخة جديدة ووصف التغييرات.

التزامات الدعم بعد النشر

زد لا تقدم دعمًا مباشرًا للتجار في الثيمات التي يطوّرها طرف ثالث؛ المسؤولية كاملة عليك كشريك.

• بريد مسؤول فعّال ومتابَع في لوحة الشركاء، وهو القناة الأساسية للتجار.
• البريد إلزامي، وبوابة التذاكر أو موقع الدعم اختياريان، ويمكن ضبطها في تبويب General Data أو ذكرها في وصف الثيم.
• يرسل التاجر طلبه من لوحة زد عبر قسم Report Theme، فتراجعه زد وتحيل التذاكر الصحيحة إليك.
• يُتوقع منك الرد بسرعة وحل المشكلات ضمن مدد اتفاقية مستوى الخدمة (SLA) المتفق عليها.

الرد السريع وإصلاح الأخطاء أولًا بأول وتحديث التوثيق كلها تنعكس على تقييمات ثيمك وانتشاره.