إنتقل إلى المحتوى الرئيسي

تثبيت Vertex على متجر Shopify الخاص بك

يرشدك هذا الدليل خلال تثبيت قالب Vertex المميز B2B لـ Shopify — من الشراء، عبر تمكين B2B، وإعداد metafield، وأول نشر لك.

الوقت التقديري
  • تثبيت B2C الأساسي (القالب فقط، بدون B2B): 5 دقائق
  • تثبيت B2B الكامل (القالب + B2B الأصلي + metafields + أول شركة): 45-60 دقيقة

قبل أن تبدأ​

متطلبات خطة Shopify​

تحتاج إلىلماذا
أي خطة Shopifyيتم تثبيت Vertex على كل خطة — Basic / Shopify / Advanced / Plus
Shopify Plus أو Advanced + إضافة B2Bمطلوب فقط إذا كنت ترغب في استخدام ميزات B2B الأصلية في Shopify. بدونها، يعمل Vertex كقالب B2C صناعي مصقول.
تمكين حسابات العملاء الجديدةمطلوب لأي ميزات حساب — Settings ▸ Customer accounts ▸ Show login link in checkout

الخطوة 1 — تثبيت Vertex من Shopify Theme Store​

  1. انتقل إلى Online Store ▸ Themes في لوحة إدارة Shopify
  2. انقر على Add theme ▸ Visit Theme Store
  3. ابحث عن "Vertex" أو تصفح إلى فئة B2B & Wholesale
  4. انقر على Try theme لتثبيت Vertex كقالب غير منشور على متجرك
  5. انقر على Customize لفتح محرر القالب
في هذه المرحلة، واجهة متجرك لم تتغير

تم تثبيت القالب ولكن لم يتم نشره. يمكنك معاينة Vertex وتخصيصه دون التأثير على واجهة متجرك المباشرة. انشر (الخطوة 6) فقط عندما تكون جاهزًا.

الخطوة 2 — تمكين B2B الأصلي في Shopify (اختياري، ولكن موصى به)​

تخطَّ هذه الخطوة إذا كنت تريد B2C فقط — تختفي واجهة B2B في Vertex تلقائيًا عندما لا يكون هناك عميل B2B مسجل الدخول.

  1. انتقل إلى Settings ▸ Customer accounts
  2. فعّل New customer accounts
  3. مرر لأسفل إلى B2B وانقر على Manage
  4. انقر على Enable B2B
  5. ستظهر الآن قسم B2B جديد في شريط جانبي للوحة إدارة Shopify

→ راجع دليل إعداد B2B الكامل لإنشاء شركتك الأولى، وتعيين الكتالوجات، وتعيين شروط NET، إلخ.

الخطوة 3 — إعداد namespace vertex لـ metafield​

يقرأ Vertex العديد من metafields التي يديرها التاجر لتشغيل تحسينات صفحة المنتج (معلومات مندوب المبيعات، يُشحن من، بحث MPN، أوراق البيانات، المواصفات التقنية، سجل الأسعار).

يمكنك القيام بذلك بطريقتين:

الخيار A — الإعداد اليدوي عبر لوحة إدارة Shopify (~15 دقيقة)​

  1. انتقل إلى Settings ▸ Custom data
  2. انقر على Companies (أو Products، اعتمادًا على metafield الذي تضيفه)
  3. انقر على Add definition وأنشئ كل metafield من الجدول في دليل إعداد metafield

الخيار B — الإعداد بالجملة عبر Shopify GraphQL Admin API (~5 دقائق)​

استخدم mutations GraphQL المضمنة في دليل إعداد metafield لزرع كل تعريف metafield لـ Vertex في دفعة واحدة.

لا تحتاج إلى كل metafield للبدء

يتراجع القالب بأناقة عند فقدان metafields. كتل صفحة المنتج (الوثائق، سجل الأسعار، يُشحن من) تختفي تلقائيًا عند فراغ metafield الداعم لها. ابدأ بالأكثر تأثيرًا (vertex.mpn لبحث SKU وvertex.rep_* لشارة مندوب المبيعات) وأضف الباقي مع التوسع.

الخطوة 4 — اختيار لوحة الألوان المبدئية​

يُثبَّت Vertex كإعداد Vertex الصناعي / MRO. يتيح لك إعداد لوحة الألوان المبدئية إعادة كسائه فورًا نحو مظهر قطاع آخر بنقرة واحدة.

اللوحة المبدئيةتناسباللون المميز
مخصص (افتراضي — أزرق كوبالتي)صناعي / MROأزرق كوبالتي
Signal redقطع غيار السياراتأحمر-برتقالي
Office blueإمدادات المكاتب وتقنية المعلوماتأزرق
Inkline tealإمدادات الطباعةفيروزي

لتبديل اللوحة:

  1. في محرر القالب، انقر على Theme settings (أسفل اليسار)
  2. افتح Colors
  3. اختر لوحتك المبدئية من قائمة Starter color palette المنسدلة
  4. تعاد تلوين واجهة المتجر بأكملها في جزء المعاينة

→ راجع ما الذي يمكن أن يكون عليه Vertex لكيفية بناء تكوينات قطع غيار السيارات / المكتب وتقنية المعلومات / الطباعة من لوحة الألوان والمحدّد.

الخطوة 5 — تكوين الهيدر والتنقل والتذييل​

يتم تكوين الهيدر + التذييل عبر مجموعات الأقسام في محرر القالب:

  1. في محرر القالب، انقر على Sections (الشريط الجانبي الأيسر)
  2. انقر على Header group لتكوين:
    • شريط الإعلانات (شريط علوي بنظام ألوان داكن / تمييز / فاتح مع روابط، اجتماعيات، هاتف)
    • شريط ترحيب B2B (مرئي فقط لعملاء B2B المسجلين الدخول)
    • الهيدر الرئيسي (الشعار، البحث، التنقل)
  3. انقر على Footer group لتكوين:
    • قائمة التذييل، الروابط الاجتماعية، بريد الاتصال، الاشتراك في النشرة الإخبارية، أيقونات الدفع

→ دليل تفصيلي: دليل واجهة الهيدر والتذييل · مرجع إعدادات القالب.

الخطوة 6 — معاينة، ثم نشر​

  1. في محرر القالب، انقر على زر Preview (أعلى اليمين) لرؤية واجهة متجرك في علامة تبويب جديدة
  2. انقر عبر:
    • الصفحة الرئيسية
    • صفحة مجموعة
    • صفحة منتج
    • سلة التسوق
    • صفحة تسجيل دخول العميل
  3. إذا تم تكوين حساب اختبار مشتري B2B، سجّل الدخول وتحقق من:
    • يظهر شريط الترحيب الأزرق الكوبالتي مع اسم الشركة + شارة شروط NET
    • تظهر شرائح التسعير بالكميات على صفحة المنتج (إذا تم تعيينها لكتالوج هذا المشتري)
    • تظهر شارة مندوب المبيعات في الهيدر (إذا تم تعيين metafield vertex.rep_name)
  4. عد إلى Online Store ▸ Themes، ابحث عن Vertex في Theme library
  5. انقر على قائمة ⋯ بجوار Vertex ▸ Publish

واجهة متجرك الآن مباشرة على Vertex 🎉

استكشاف أخطاء التثبيت​

"لا أرى شريط ترحيب B2B الأزرق الكوبالتي"​

الأسباب (بترتيب الاحتمال):

  1. أنت لست مسجل الدخول كعميل B2B. يظهر الشريط الأزرق الكوبالتي فقط عندما يكون customer.b2b? صحيحًا وcustomer.current_company معينًا. سجّل الدخول كمشتري B2B مرتبط بشركة.
  2. وضع الواجهة معين إلى B2C-only. افتح Theme settings ▸ B2B ▸ Storefront mode وتأكد من ضبطه على Hybrid (auto) أو B2B-only.
  3. B2B الأصلي غير مفعّل في لوحة إدارة Shopify. أكد الخطوة 2 أعلاه.

"الأسعار تظهر 'سجل الدخول لرؤية الأسعار' رغم تسجيل دخولي"​

مفتاح Theme settings ▸ B2B ▸ Hide prices until customer logs in مفعّل. للتعطيل، ألغِ تحديد المربع.

"شارة مندوب المبيعات لا تظهر في الهيدر"​

تظهر الشارة فقط عندما يكون لشركة المشتري قيمة metafield vertex.rep_name معينة. تحقق في Customers ▸ Companies ▸ [اسم الشركة] ▸ Metafields من أن vertex.rep_name ممتلئ.

→ راجع FAQ + استكشاف الأخطاء للمزيد.

الخطوات التالية​