قبل أن ترسل ثيمك إلى سوق الثيمات: قائمة تحقق كاملة ودليل استخدام يفهمه التاجر

ما الذي تبحث عنه المراجعة؟

الثيم العام يظهر في سوق الثيمات لجميع التجار، ولذلك يمر بمراجعة زد قبل نشره. وبحسب مقالة «Create & Update Your Public Theme»، يراجع الفريق الثيمات الجديدة من حيث المزايا الأساسية والمرونة والاعتمادية والأداء، وتستغرق المراجعة حتى يومين. الثيم الذي يستوفي المتطلبات يُنظر في اعتماده، أما الذي ينقصه شيء منها أو يحتاج تعديلات كبيرة فيُرفض.

وتضيف مقالة «Theme Type and Appearance» أن الثيمات العامة يجب أن تتبع إرشادات زد للثيمات، ومنها مواصفات التصميم وإمكانية الوصول والتجاوب واكتمال المزايا، وأنها تتطلب دعمًا مستمرًا منك لضمان الجودة والتوافق.

فحوص تقنية قبل أن تحزم الثيم

معظم هذه البنود من إرشادات «Theme Development» في التوثيق ومن سجل تغييرات Vitrin:

• كل القوالب تمتد من layout.jinja، والـLayout يتضمن {% vitrin_head %} و{% vitrin_body %}.
• افتح رابط المعاينة بعد إضافة /validate إليه، وعالج كل ما يظهر في تقرير أداة اختبار الثيم.
• منذ ديسمبر 2025 تظهر أخطاء المتغيرات غير المعرّفة في معاينة التطوير. أضف قيمًا بديلة، وتعامل مع القيم الاختيارية، واستخدم safeget عند الحاجة.
• أنشئ الروابط عبر url_for بدل كتابة المسارات يدويًا؛ فالمسار /p صار يحوّل إلى /products و/c إلى /categories، والسجل ينبّه إلى أن الروابط الثابتة قد تتعطل إذا تغيّرت المسارات مجددًا.
• لا تعرض واجهة أخطاء خاصة بك لاستجابات الـ Server؛ رسائل أخطاء الـ Server يتولاها الـSDK.
• أبقِ حجم سياق القالب ضمن حدود المنصة، فالسياق الكبير يبطئ العرض ويزيد استهلاك البيانات.
• تأكد قبل الرفع أن ملفات .po تُترجم بلا أخطاء عبر msgfmt --check، ولا ترفع ملف .mo الناتج لأنه يُتجاهل.

# Preview link
https://my-preview?theme={themeId}

# Validation report
https://my-preview/validate?theme={themeId}

تحديثات القوالب المطلوبة من سجل Vitrin

عدة إدخالات في سجل تغييرات Vitrin تحمل وسم Action Required أو تنص على أن التغيير مطلوب من مطوري الثيمات. راجعها قبل الإرسال، خصوصًا إذا بدأت من نسخة قديمة من ثيم نموذجي:

• الخصومات البنكية (20 أغسطس 2026): أضف القالب المشترك في صفحة تفاصيل المنتج وصفحة السلة معًا، وبدونه لن تظهر الخصومات البنكية التي يضبطها التاجر في هاتين الصفحتين. ولا يلزم أي تغيير في صفحة الدفع.
• الدفع السريع عبر Apple Pay (11 ديسمبر 2025): حدّث ثيمك لاستخدام القالب الجديد تجنبًا لمشكلات في إتمام الطلب.
• تعدد المخازن ونافذة اختيار المنطقة واللغة (23 ديسمبر 2025): مطلوب للتوافق، ويجب تطبيقه على الثيمات المنشورة سابقًا أيضًا، والسجل يذكر أن حالات اختبار الجودة ستغطيه.
• المنتجات المجمّعة (16 ديسمبر 2025، موسوم Performance لكنه ينص على أن التغيير مطلوب): استبدل قالب Twig القديم {{ template_for_product_grouped }} بقالب Jinja الجديد.

{# product.jinja and cart.jinja #}
{% include 'vitrin:shared/bank_discounts.jinja' %}
{% include 'vitrin:checkout/apple-pay-quick-checkout.jinja' %}

{# product.jinja #}
{% include 'vitrin:products/grouped-product.jinja' %}

{# layout.jinja #}
{% include 'vitrin:shared/region_settings_dialog.jinja' %}

واحترم كذلك إعداد التاجر Show coupon code field: اعرض قسم الكوبون كاملًا فقط عندما يكون store.settings.checkout.is_coupon_form_enabled != false، وفي كل موضع للسلة (صفحة السلة، السلة الجانبية، السلة المصغّرة، نافذة الدفع المنبثقة). وقائمة التحقق في التوثيق تطلب اختبار القيم true وfalse وnull وغياب القيمة.

بيانات العرض والحساب: قائمة التحقق النهائية

تسرد مقالة «Publish Your Theme» المهام التي يجب إكمالها قبل إرسال الثيم للمراجعة:

• إنشاء الثيم ورفعه.
• اختبار الثيم على المتجر التجريبي.
• إضافة الصور والتفاصيل.
• إدخال بريد المسؤول (Maintainer Email).
• تحديد خطة الدعم.
• إدخال بيانات الدفع.

• الصور: من 3 إلى 9. سطح المكتب بنسبة 4:3 بين 800×600 و1600×1200، والجوال بنسبة 9:16 بين 360×640 و720×1280.
• الدعم: البريد الإلكتروني إلزامي، وبوابة التذاكر أو موقع الدعم اختياريان. اضبطها في تبويب General Data أو اذكرها بوضوح في وصف الثيم.
• بيانات الدفع: تُنشأ مستحقات الثيمات في السادس من كل شهر ضمن Payments ثم Payouts ثم تبويب Themes، ولن تستلمها قبل رفع الفاتورة. جهّز الاسم القانوني لشركتك، ورقم السجل التجاري والرقم الضريبي إن وُجد، ورقم IBAN.

اكتب دليل استخدام يفهمه التاجر

مقالة «How to Write a Clear Theme Manual» تعامل الدليل كجزء من المنتج. والقاعدة الأهم: أنت تكتب لتاجر لا لمطوّر، ولا تفترض لديه أي خلفية تقنية. إذا احتاج التاجر أن يتواصل معك ليفهم ميزة ما، فالدليل لم يؤدِّ دوره. ويجب أن يغطي:

• نبذة عن الثيم وأنواع المتاجر التي تناسبه، ثم التثبيت والتفعيل.
• تخصيص الصفحة الرئيسية: إضافة الأقسام وحذفها وإعادة ترتيبها، وكل قسم وخياراته.
• الإعداد الأساسي (الشعار والألوان والخطوط والقوائم)، وصفحات المنتج والتصنيف، والرأس والتذييل.
• إعداد العربية والإنجليزية، ومقاسات الصور الموصى بها، والفروق بين الجوال وسطح المكتب.
• التكاملات المدعومة، والقيود وما لا يدعمه الثيم، وحل المشكلات الشائعة، وطريقة التواصل معك وساعات الرد.

وفي الكتابة: خطوة واحدة في كل سطر وبترقيم، وسمِّ العناصر كما تظهر في محرر الثيم حرفيًا، وابدأ بالمكان ثم الإجراء، واختم بالنتيجة المتوقعة، وتجنّب المصطلحات التقنية. هذا مثال الدليل على تعليمة واضحة لتغيير البانر الرئيسي:

1. افتح محرر الثيم.
2. اختر قسم Main Banner.
3. اضغط Change image وارفع صورتك (المقاس الموصى به: 1920 × 600 بكسل).
4. اضغط Save. النتيجة: يظهر البانر الجديد أعلى الصفحة الرئيسية.

بعد أن تضغط Submit to Publish

تنتقل حالة الثيم من Pending إلى In Review، ثم تنتهي إلى Published أو Rejected مع ملاحظات بالأسباب. وهذه تفاصيل تحتاجها أثناء ذلك:

• يمكنك تعديل التفاصيل والصور ما دام الثيم في حالة Draft أو Rejected. وبمجرد أن يصبح In Review لا يمكنك إرسال تعديلات حتى يصبح Published أو Rejected، وإذا لزم تعديل أثناء المراجعة فتواصل مع فريق الدعم.
• زر Save Draft يتيح لك تجهيز كل شيء دون إرسال، ويمكنك حذف الثيمات في حالتي Draft وRejected.
• لأي استفسار، افتح تذكرة من نافذة مركز المساعدة في لوحة الشركاء.
• لنشر تحديث لاحقًا: من Themes Management اضغط أيقونة التعديل ثم تبويب Update Theme، واختر نوع التغيير (يزيد رقم الإصدار بحسبه)، وارفع الملف، وصف التغييرات، ثم Submit to Publish لإرسال التحديث للمراجعة.

بعد النشر يرسل التجار بلاغاتهم عبر Report Theme في لوحة زد، وتحيل زد البلاغات الصحيحة إليك لتحلها ضمن مدد اتفاقية مستوى الخدمة. والدليل الواضح هو ما يُبقي هذه البلاغات قليلة.