التوثيق

دليل الإعداد والاختبار

كل ما تحتاجه لتثبيت Persistent Cart وتكوينه والتحقق من عمله. تعمل الميزة الأساسية (استعادة السلال المحفوظة عند تسجيل الدخول) في خطة Free، دون الحاجة إلى أي دفع لاختبارها.

01 - قبل أن تبدأ

المتطلبات

قيد من المنصة

تُخزَّن سلال الزوار (غير المسجّلين الدخول) محليًا على الجهاز، ولا يمكن مزامنتها بين الأجهزة. هذا قيد من Shopify، وليس قيدًا في التطبيق: تتطلب الاستعادة بين الأجهزة عميلًا لديه حساب وقد سجّل الدخول.

02 - دقيقتان

التثبيت

يُفعَّل Persistent Cart من لوحة إدارة Shopify. بلا كود، ودون مطوّر. خطوتان: ثبّت التطبيق، ثم فعّل تضمين التطبيق في السمة ‎(Theme App Embed)‎.

  1. ثبّت التطبيق من صفحة التطبيق في متجر تطبيقات Shopify ووافق على صلاحيات الوصول المطلوبة. ستنتقل إلى لوحة التحكم المضمَّنة في لوحة الإدارة. تختار خطة من صفحة الخطط في Shopify؛ ولا تتطلب خطة Free أي دفع.
  2. فعّل تضمين التطبيق في السمة (مطلوب). انتقل إلى المتجر الإلكتروني ‎(Online Store)‎ ← السمات ‎(Themes)‎ ← تخصيص ‎(Customize)‎ ← تضمينات التطبيق ‎(App embeds)‎، وشغّل «Persistent cart»، ثم انقر على حفظ ‎(Save)‎.
  3. انتهى. أصبحت السلال تُحفظ الآن للعملاء الذين سجّلوا الدخول، ويظهر زر «مشاركة هذه السلة» في السلة. يستغرق الإعداد أقل من 60 ثانية.
هذه الخطوة إلزامية

من دون تفعيل تضمين التطبيق، لا تعمل أي وظيفة: لا حفظ للسلة، ولا زر مشاركة. إذا لم يعمل شيء ما، فتحقق أولًا من مفتاح تفعيل التضمين.

البدء

تختار خطة من صفحة الخطط في Shopify عند فتح التطبيق لأول مرة. لا تتطلب خطة Free أي دفع.

  1. انتقل إلى المتجر الإلكتروني (Online Store)، ثم تعديل السمة (Edit theme)، ثم تضمينات التطبيق (App embeds).
  2. فعّل «Persistent cart» في قائمة تضمينات التطبيق (App embeds).
  3. انقر على حفظ (Save).

بعد الحفظ: يحتفظ العملاء الذين سجّلوا الدخول بسلتهم عبر الأجهزة، ويظهر زر «مشاركة هذه السلة» في السلة.

حاسبة الشحن (اختياري)

يمكن أن تعرض سلة الشراء تقديرًا لتكلفة الشحن قبل الدفع. وهي كتلة منفصلة، لذا لا تظهر إلا في المكان الذي تضعها فيه.

  1. انتقل إلى المتجر الإلكتروني، ثم تحرير القالب، ثم افتح قالب سلة الشراء.
  2. إذا لم يكن قالب سلة الشراء يحتوي على قسم التطبيقات، فانقر على إضافة قسم واختر التطبيقات.
  3. في قسم التطبيقات، انقر على إضافة كتلة واختر «Shipping calculator».
  4. انقر على حفظ.

يستخدم التقدير تكاليف الشحن الخاصة بمتجرك، لسلة الشراء التي يشاهدها العميل. ويتطلب قالبًا مستضافًا على Shopify: لن تظهر الكتلة في واجهة متجر مخصصة.

إذا لم تتمكن من وضع الكتلة (متقدم)

تعرض بعض السمات سلة الشراء في درج جانبي، حيث لا يمكن وضع كتلة «Shipping calculator». في هذه السمات، يمكن للتطبيق أن يُدرج الحاسبة بنفسه في سلة الشراء الخاصة بالسمة. هذا الإعداد متوقف افتراضيًا: استخدم الكتلة أعلاه كلما أمكنك ذلك.

  1. انتقل إلى المتجر الإلكتروني (Online Store)، ثم تعديل السمة (Edit theme)، ثم تضمينات التطبيق (App embeds)، وافتح «Persistent cart».
  2. فعّل «Insert the shipping calculator into this theme's cart (advanced)».
  3. انقر على حفظ.
  4. في متجرك، أضف إلى سلة الشراء منتجًا يتطلب الشحن، ثم تحقق من صفحة سلة الشراء ومن درج سلة الشراء كليهما.

ينتمي هذا الإعداد إلى السمة التي حفظته فيها: إذا انتقلت إلى سمة أخرى، ففعّله فيها من جديد. في الصفحة التي تظهر فيها كتلة «Shipping calculator»، تبقى الحاسبة المُدرجة متوقفة، لذا لا تعرض سلة الشراء حاسبتين أبدًا.

لا يعمل؟ تحقّق مما يلي بالترتيب:
  1. هل تضمين التطبيق مفعّل؟ بدونه لا يعمل أي شيء: لا حفظ لسلة التسوق ولا زر مشاركة.
  2. هل العميل مسجّل الدخول؟ يحفظ التطبيق السلال ويزامنها للعملاء الذين سجّلوا الدخول فقط. أما سلة الزائر فهي سلة المتصفح الخاصة بـ Shopify، لذا تبقى على ذلك الجهاز.

03 - اختياري

التكوين

تعمل الإعدادات الافتراضية مباشرةً. للتخصيص، افتح صفحة الإعدادات في التطبيق داخل لوحة الإدارة. تُحفظ الإعدادات في متجرك، وتقرأها واجهة المتجر تلقائيًا.

الإعدادما يفعلهالخطة
نافذة التأكيدعندما تلتقي سلة مشتركة بسلة موجودة، تُعرض نافذة «الدمج مع منتجاتي» / «استبدال سلتي» / «إلغاء».كل الخطط
إظهار أيقونة على الزرنوع الأيقونةإظهار زر المشاركة واختيار نمطه (أيقونة رابط / مشاركة / سلة).Pro+
وجهة إعادة التوجيهإرسال العميل مباشرةً إلى الدفع عند فتح رابط سلة مشتركة.الخطط المدفوعة
مدة الصلاحيةالمدة التي تُحفظ فيها سلة محفوظة غير نشطة (7 / 14 / 30 / 60 يومًا). وفي خطة Free المدة ثابتة على يومين.الخطط المدفوعة
فئة CSS مخصصة لزر المشاركةفئة CSS مخصصة للنافذةربط زر المشاركة ونافذة التأكيد بأنماط سمتك.Pro+

04 - تحقّق من أنه يعمل

الاختبار

استمرار السلة بين الأجهزة

  1. سجّل الدخول كعميل في واجهة المتجر وأضف بعض المنتجات إلى السلة.
  2. افتح المتجر على جهاز آخر أو متصفح لم تستخدمه بعد على هذا المتجر، مسجّلًا الدخول بحساب العميل نفسه، وبسلة فارغة.
  3. حمّل أي صفحة. تُستعاد السلة المحفوظة تلقائيًا، ويُعاد تحميل الصفحة وقد عادت المنتجات إليها.

مشاركة هذه السلة

  1. في صفحة السلة أو درج السلة، انقر على «مشاركة هذه السلة» (بجوار زر الدفع). يُنسخ رابط قصير إلى الحافظة.
  2. افتح ذلك الرابط في متصفح آخر. تظهر طبقة «جارٍ دمج سلتك...» وتُضاف المنتجات.
  3. إذا كانت في سلتك منتجات بالفعل وكانت نافذة التأكيد مفعّلة، تظهر نافذة «الدمج مع منتجاتي» / «استبدال سلتي» / «إلغاء».

05 - الامتثال

البيانات والخصوصية