Skip to main content
يضبط configure(config) كيفية سلوك السلة. إنه استدعاء إعداد، لذا فهو آمن في أعلى سكربتك تمامًا، قبل تحميل السلة.
يمكنك استدعاؤه أكثر من مرة وتُدمج القيم. الاستدعاء اللاحق يتجاوز فقط المفاتيح التي يذكرها، تاركًا البقية كما هي.
تمرير undefined يمسح المفتاح بدلًا من تخطيه. configure({ open_on_add_to_cart: undefined }) يعيد ضبط ذلك الخيار إلى قيمته الافتراضية، متجاهلًا ما ضبطه استدعاء سابق. لترك خيار كما هو، أغفل المفتاح تمامًا.

​
الخيارات

​
open_on_add_to_cart

يتحكم فيما إذا كان الدرج يفتح عندما يضيف المتسوق منتجًا.
استخدام شائع هو إبقاء الدرج مغلقًا في صفحة محددة واحدة مع ترك إعداد التاجر كما هو في كل مكان آخر:
إذا كنت تريد هذا فقط للمتجر بأكمله، فهو إعداد موجود بالفعل: Cart settings → Content → Behavior → Open cart when an item is added. استخدم configure عندما تعتمد الإجابة على الصفحة أو المتسوق أو شيء لا يعرفه إلا كودك.

​
open_on_background_add

اضبطه على true لفتح الدرج أيضًا مع إضافات الخلفية — تلك التي رصدها Aftersell لكنه لم يعالجها بنفسه. تُعد الإضافة إضافة خلفية عندما:
  • تصل عبر أحداث السلة القياسية في Shopify (تُعامل دائمًا كخلفية، أيًا كان ما شغّلها)، أو
  • رأى Aftersell طلب السلة على الشبكة دون نقرة أو ضغطة مفتاح موثوقة في الثواني الثلاث تقريبًا السابقة — مثل تطبيق أو سكربت آخر يكتب إلى السلة.
الإضافة التي رآها Aftersell على الشبكة وسبقتها فعلًا نقرة متسوق ليست إضافة خلفية: فهي تفتح الدرج بالفعل وفق open_on_add_to_cart، دون حاجة لهذا الخيار.
هذا بوابة إضافية، وليس تجاوزًا: تفتح إضافة الخلفية الدرج فقط إذا كان open_on_add_to_cart سيسمح بذلك أيضًا. مع open_on_add_to_cart: 'never'، لا يفعل هذا الخيار شيئًا.
الجأ إلى هذا عندما يضيف زر إضافة تابع لطرف ثالث العنصر بشكل صحيح لكنه يترك الدرج مغلقًا. أما إذا لم يصل العنصر إلى السلة إطلاقًا، فتلك مشكلة اعتراض. راجع skip_add_to_cart_interceptor وحالة استخدام منشئ الصفحات.

​
validate_form_on_add_to_cart

يشغّل التحقق الأصلي من النماذج في المتصفح (reportValidity()) قبل الإضافة، ويلغي الإضافة إذا كان النموذج غير صالح. استخدمه عندما يحتوي نموذج منتجك على حقول إلزامية (رسالة نقش، ملاحظة هدية، مربع اختيار إلزامي) يستطيع المتسوقون حاليًا تخطيها.
يعرض المتصفح رسالة التحقق الخاصة به على الحقل المخالف. معطَّل افتراضيًا، لأن قالبًا يحتوي على سمة required شاردة في مكان ما داخل نموذج المنتج كان سيبدأ خلاف ذلك في منع الإضافة إلى السلة بصمت.

​
skip_add_to_cart_interceptor

يوقف اعتراض Aftersell للإضافة إلى السلة تمامًا. لمعرفة ما يفعله الاعتراض وكل طرق الانسحاب منه، راجع اعتراض الإضافة إلى السلة. يقوم القالب حينها بالإضافة بنفسه، ويعمل مجددًا كل سكربت يستمع إلى ذلك الإرسال. لا يزال Aftersell يراقب طلب السلة على الشبكة، لذا يفتح الدرج كالمعتاد. لا تفقده بالانسحاب. على القوالب التي يتعرّف عليها Aftersell، تبقى سلة القالب نفسها خاملة، لذا لن تحصل على سلتين. أما على قالب لا يتعرّف عليه، فقد يفتح القالب سلته الخاصة إلى جانب سلتك؛ راجع هل ستفتح سلة القالب أيضًا؟.
يُقرأ هذا الخيار مرة واحدة، عند الإقلاع. لا يعمل إلا من استدعاء إعداد يُنفَّذ قبل تحميل السلة: سكربت Initialization الخاص بسلتك. ضبطه لاحقًا (داخل ready() أو من معالج حدث) لا يكون له أي تأثير، ويفشل بصمت.
هذه أداة فجّة تعطّل الاعتراض لكل نموذج على الصفحة. لاستثناء نموذج واحد فقط، استخدم خطاف registerSkipAddToCartRule بدلًا من ذلك:

​
skip_open_cart_interceptor

النقر على أيقونة السلة يفتح درج Aftersell. لفعل ذلك بشكل موثوق، يوقف Aftersell النقرة حتى لا يعالجها أي شيء آخر على الصفحة، وهذا يوقف أيضًا سكربتاتك من رؤيتها. إذا كان حدث تحليلات أو بكسل ينطلق في كل مكان ما عدا أيقونة السلة، فهذا هو السبب. اضبط هذا على true لإيقاف إسكات النقرة:
تعمل مستمعاتك حينها، ولا يزال الدرج يفتح تمامًا كما في السابق. كما أن النقرة لا تزال لا تنتقل إلى /cart.
هذا يفعل أقل مما يوحي به الاسم. فهو لا يتخطى معترض أيقونة السلة. إنه فقط يوقف إسكاته للمستمعات الأخرى. لا يزال Aftersell يعالج النقرة ولا يزال يفتح سلتك. للحصول على عنصر تحكم يتجاهله Aftersell كليًا، استخدم الصنف aftersell-cart-wont-open-cart بدلًا من ذلك؛ راجع اعتراض الإضافة إلى السلة.
على عكس skip_add_to_cart_interceptor، يُقرأ هذا عند كل نقرة، لذا يمكنك ضبطه في أي وقت ويسري مفعوله فورًا: من ready() أو من معالج حدث أو بشكل مشروط لكل صفحة.
بعض القوالب تستجيب أيضًا لنقرة أيقونة السلة بنفسها. بمجرد أن يتوقف Aftersell عن إسكاتها، فإن القالب الذي يفتح درجه الخاص سيفعل ذلك إلى جانب درجك. إذا رأيت سلتين بعد تشغيل هذا، فأضف الصنف aftersell-cart-wont-open-cart إلى أيقونة القالب وافتح السلة من معالجك الخاص باستخدام actions.open().

​
money_format

يتجاوز تنسيق العملة في Shopify الذي يستخدمه formatMoney. الافتراضي هو تنسيق متجرك نفسه؛ وإذا لم يكن متاحًا، تعود الأسعار إلى $X.XX.
لأن configure يدمج القيم وformatMoney يقرأ القيمة الحية، يمكنك تغيير التنسيق أثناء التشغيل، مثلًا عندما يعمل مبدّل العملات:
هذا يغيّر كيفية عرض SDK والسلة للأسعار. لا يغيّر العملة التي يُحاسَب بها المتسوق؛ فذلك من اختصاص Shopify Markets.

​
إلى أين تذهب بعد ذلك