configure(config) كيفية سلوك السلة. إنه استدعاء إعداد، لذا فهو آمن في أعلى سكربتك تمامًا، قبل تحميل السلة.
يتحكم فيما إذا كان الدرج يفتح عندما يضيف المتسوق منتجًا.
إذا كنت تريد هذا فقط للمتجر بأكمله، فهو إعداد موجود بالفعل: Cart settings → Content → Behavior → Open cart when an item is added. استخدم
configure عندما تعتمد الإجابة على الصفحة أو المتسوق أو شيء لا يعرفه إلا كودك.true لفتح الدرج أيضًا مع إضافات الخلفية — تلك التي رصدها Aftersell لكنه لم يعالجها بنفسه.
تُعد الإضافة إضافة خلفية عندما:
- تصل عبر أحداث السلة القياسية في Shopify (تُعامل دائمًا كخلفية، أيًا كان ما شغّلها)، أو
- رأى Aftersell طلب السلة على الشبكة دون نقرة أو ضغطة مفتاح موثوقة في الثواني الثلاث تقريبًا السابقة — مثل تطبيق أو سكربت آخر يكتب إلى السلة.
open_on_add_to_cart، دون حاجة لهذا الخيار.
open_on_add_to_cart سيسمح بذلك أيضًا. مع open_on_add_to_cart: 'never'، لا يفعل هذا الخيار شيئًا.
يشغّل التحقق الأصلي من النماذج في المتصفح (reportValidity()) قبل الإضافة، ويلغي الإضافة إذا كان النموذج غير صالح. استخدمه عندما يحتوي نموذج منتجك على حقول إلزامية (رسالة نقش، ملاحظة هدية، مربع اختيار إلزامي) يستطيع المتسوقون حاليًا تخطيها.
required شاردة في مكان ما داخل نموذج المنتج كان سيبدأ خلاف ذلك في منع الإضافة إلى السلة بصمت.
يوقف اعتراض Aftersell للإضافة إلى السلة تمامًا. لمعرفة ما يفعله الاعتراض وكل طرق الانسحاب منه، راجع اعتراض الإضافة إلى السلة.
يقوم القالب حينها بالإضافة بنفسه، ويعمل مجددًا كل سكربت يستمع إلى ذلك الإرسال. لا يزال Aftersell يراقب طلب السلة على الشبكة، لذا يفتح الدرج كالمعتاد. لا تفقده بالانسحاب. على القوالب التي يتعرّف عليها Aftersell، تبقى سلة القالب نفسها خاملة، لذا لن تحصل على سلتين. أما على قالب لا يتعرّف عليه، فقد يفتح القالب سلته الخاصة إلى جانب سلتك؛ راجع هل ستفتح سلة القالب أيضًا؟.
registerSkipAddToCartRule بدلًا من ذلك:
true لإيقاف إسكات النقرة:
/cart.
على عكس skip_add_to_cart_interceptor، يُقرأ هذا عند كل نقرة، لذا يمكنك ضبطه في أي وقت ويسري مفعوله فورًا: من ready() أو من معالج حدث أو بشكل مشروط لكل صفحة.
بعض القوالب تستجيب أيضًا لنقرة أيقونة السلة بنفسها. بمجرد أن يتوقف Aftersell عن إسكاتها، فإن القالب الذي يفتح درجه الخاص سيفعل ذلك إلى جانب درجك. إذا رأيت سلتين بعد تشغيل هذا، فأضف الصنف
aftersell-cart-wont-open-cart إلى أيقونة القالب وافتح السلة من معالجك الخاص باستخدام actions.open().formatMoney. الافتراضي هو تنسيق متجرك نفسه؛ وإذا لم يكن متاحًا، تعود الأسعار إلى $X.XX.
configure يدمج القيم وformatMoney يقرأ القيمة الحية، يمكنك تغيير التنسيق أثناء التشغيل، مثلًا عندما يعمل مبدّل العملات:
هذا يغيّر كيفية عرض SDK والسلة للأسعار. لا يغيّر العملة التي يُحاسَب بها المتسوق؛ فذلك من اختصاص Shopify Markets.
- الإجراءات: اقرأ السلة وغيّرها.
- الخطافات: تحكّم على مستوى كل نموذج وكل بند، حيث يكون
configureواسعًا أكثر من اللازم. - حالات الاستخدام: حلول كاملة للطلبات الشائعة.