صيغة حزمة الثيم

الثيم أرشيف ZIP. المسارات حساسة لحالة الأحرف وتستخدم أسماء بأحرف لاتينية صغيرة وشرطات.

الملفات

يُرفض أي نوع ملف أو موقع آخر، بما في ذلك السكربتات وHTML والروابط الرمزية والملفات المخفية.

ملف theme.json

{
  "schemaVersion": 2,
  "id": "luxe-perfume",
  "name": { "ar": "لوكس للعطور", "en": "Luxe Perfume" },
  "version": "1.1.0",
  "publisher": "my-studio",
  "description": { "ar": "…", "en": "…" },
  "minimumPlatformVersion": "1.0.0",
  "sdkVersion": "2.0.0",
  "supportedLocales": ["ar", "en"],
  "rtl": true,
  "templates": [{ "id": "home.default", "type": "home", "file": "templates/home.default.json" }],
  "sections": [{ "type": "hero", "file": "sections/hero/schema.json" }],
  "blocks": [{ "type": "heading", "file": "blocks/heading/schema.json" }],
  "settingsSchema": "config/settings.schema.json",
  "locales": ["locales/ar.json", "locales/en.json"],
  "assets": ["assets/theme.css"]
}

لا تُقبل إلا المفاتيح العليا الموثقة. يجب أن يدعم الثيم العربية والاتجاه من اليمين لليسار وأن يوفر قالب home. المثال الكامل موجود في examples/themes/luxe-perfume داخل مستودع المنصة.

الحدود

تُرفض الأرشيفات المشفرة أو متعددة الأجزاء أو التالفة قبل تخزين أي شيء.

الإصدارات

قيمة version بصيغة MAJOR.MINOR.PATCH ويجب أن تزيد مع كل إصدار تسجّله. الإصدار لا يتغير بعد إرساله للمراجعة؛ لأي تعديل ارفع إصداراً جديداً. تسجّل المنصة بصمة SHA-256 لحزمة المصدر وللحزمة المبنية، وتتحقق من بصمة الحزمة المبنية في كل مرة تُحمَّل فيها.

الترحيل

عندما يغيّر إصدار اسم إعداد أو يحذفه، أرفق ملف ترحيل حتى يحتفظ التجار بتخصيصاتهم:

{
  "from": "1.0.0",
  "to": "1.1.0",
  "operations": [
    { "op": "rename_setting", "scope": "theme", "from": "layout_width", "to": "page_width" },
    { "op": "set_value", "scope": "section", "type": "hero", "id": "overlay", "value": 30, "onlyIfMissing": true }
  ]
}

العمليات الأخرى هي remove_setting وmove_setting_to_block وrename_section_type وrename_block_type وrename_template. قبل أن يطبّق التاجر التحديث يرى تقريراً بما سيُحفظ وما سيُرحَّل وما لن ينتقل؛ لا يُحذف شيء دون إشعار.