تخطي إلى المحتوى الرئيسي

ArtinTech Solution

Leafwise Shopify theme homepage next to a clean Theme Check result

تبدأ معظم قوالب Shopify المخصصة كنسخة من Dawn. فهو مجاني وسريع وتصونه Shopify. لكن مع Leafwise، وهو قالب للمشاتل ومتاجر النباتات نبيعه في متجرنا الخاص، لم يكن هذا الخيار متاحًا.

هكذا كتبنا قالب Shopify من الصفر: لماذا لم ننسخ Dawn، وكيف بُني القالب، ومشكلات الأدوات التي واجهناها حتى حصلنا على Theme Check نظيف.

عن هذا المقال: Leafwise منتجنا الخاص، لذا كل ما هنا من المشروع الحقيقي. أمثلة الكود مختصرة وليست مختلقة.

Leafwise Shopify theme homepage next to a clean Theme Check result
Leafwise بجانب تشغيل نظيف لـ Theme Check. (رسم توضيحي.)

لماذا لم ننسخ Dawn؟

يسمح ترخيص Dawn بالبناء عليه، لكن القوالب المشتقة منه لا يجوز توزيعها إلا عبر متجر قوالب Shopify. أردنا بيع Leafwise مباشرة بسعرنا وترخيصنا. وهذا يعني عدم استخدام أي كود من Dawn: لا بنية الأقسام ولا JavaScript ولا CSS.

وللبدء من مجلد فارغ ميزة أيضًا. كل قسم موجود لأن متجر النباتات يحتاجه، ولا شيء متبقٍ من متجر أزياء.

البنية في فقرة واحدة

Leafwise قالب Online Store 2.0 بسيط: قوالب JSON، ومجموعة للرأس وأخرى للتذييل، وأقسام بكتل في كل مكان. توجد سبعة أنظمة ألوان في مجموعة واحدة، ويحوّل snippet كل نظام إلى فئة CSS بخصائص مخصصة، فيستطيع أي قسم تغيير نظامه بإعداد واحد. لا يوجد إطار عمل ولا خطوة بناء. الأجزاء التفاعلية عناصر مخصصة صغيرة في أربعة ملفات مؤجلة التحميل.

  • side-drawer وcart-drawer للقائمة والبحث والسلة
  • product-form وvariant-picker وmedia-gallery وsticky-atc في صفحات المنتجات
  • facets-area للفلاتر دون إعادة تحميل، وpredictive-search للاقتراحات
  • plant-quiz وfilter-tabs في الصفحة الرئيسية

السلة: طلب واحد يحدّث كل الأقسام

عند الإضافة إلى السلة يجب تحديث الدرج وعدّاد الرأس والتنقل على الهاتف معًا. تقوم Section Rendering API بذلك في الطلب نفسه: نطلب من Shopify عرض الأقسام التي نحتاجها ونستبدل HTML الخاص بها.

formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer

كل عنصر يعرض بيانات السلة يحمل السمة data-cart-section، لذا يحتاج أي مكان جديد يعرض السلة إلى السمة فقط، لا إلى JavaScript جديد.

قال Theme Check إنه فحص 0 ملفات

على Windows كان shopify theme check ينتهي دون أخطاء ويذكر أنه فحص صفر ملفات، من أي مجلد جربناه. والنتيجة النظيفة التي لم تفحص شيئًا أسوأ من الخطأ. فاستدعينا الفاحص نفسه مباشرة عبر حزمة Node الخاصة به:

const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);

وجد خطأً واحدًا وأربعة تحذيرات، منها اسم قسم أطول من المسموح. بعد الإصلاح: 90 ملفًا، 0 أخطاء، 0 تحذيرات.

ملف zip قد ترفضه Shopify

كتب Compress-Archive في PowerShell الملف المضغوط بشرطات مائلة عكسية في المسارات، أي sections\header.liquid بدل sections/header.liquid. بعض أدوات فك الضغط وأنظمة الرفع لا تقبل ذلك. لذلك نبني الملف باستخدام ZipArchive في .NET ونكتب كل مسار بشرطات مائلة عادية بأنفسنا.

$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)

ما سنفعله بالطريقة نفسها مرة أخرى

  • بلا إطار عمل: أربعة ملفات صغيرة تُحمَّل أسرع من أي حزمة وتسهل قراءتها
  • Section Rendering API لكل ما يتعلق بالسلة
  • تشغيل Theme Check من حزمة Node في CI وإفشال البناء إذا لم يُفحص أي ملف
  • الاختبار مبكرًا على متجر تطوير حقيقي. نجح Theme Check، لكن المتجر كشف ثمانية أخطاء، وهي موضوع مقالنا القادم

يُباع Leafwise على Charming Theme. وإذا احتجت إلى قالب Shopify مبني من الصفر لمتجرك، فاطّلع على خدمة تطوير قوالب Shopify لدينا.

الأسئلة الشائعة

هل يمكنني بيع قالب مبني على Dawn خارج متجر القوالب؟

ترخيص Dawn يسمح بتوزيع القوالب المشتقة عبر متجر قوالب Shopify فقط. للبيع في مكان آخر، اكتب كودك الخاص.

كم يستغرق القالب من الصفر مقارنة بنسخة Dawn؟

وقتًا أطول في البداية، لأن السلة والفلاتر ومنطق المتغيرات تكتبها بنفسك. وفي المقابل تملك كل سطر ولا تحمل كودًا غير مستخدم.

هل يحتاج قالب Shopify حديث إلى خطوة بناء؟

لا. CSS عادي بخصائص مخصصة وعناصر مخصصة صغيرة يغطي كل ما يحتاجه Leafwise.

Share this article

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *