Skip to main content
configure(config) задаёт поведение корзины. Это вызов настройки, поэтому его безопасно размещать в самом начале вашего скрипта, до загрузки корзины.
Вы можете вызывать его несколько раз, и значения объединяются. Более поздний вызов переопределяет только указанные в нём ключи, оставляя остальные без изменений.
Передача undefined очищает ключ, а не пропускает его. configure({ open_on_add_to_cart: undefined }) сбрасывает эту опцию к значению по умолчанию, отбрасывая всё, что задал более ранний вызов. Чтобы оставить опцию без изменений, полностью опустите ключ.

​
Опции

​
open_on_add_to_cart

Управляет тем, открывается ли drawer, когда покупатель добавляет товар.
Типичное применение — держать drawer закрытым на одной конкретной странице, оставляя настройку продавца без изменений везде остальном:
Если вам просто нужно включить это для всего магазина, это уже есть в настройках: Cart settings → Content → Behavior → Open cart when an item is added. Используйте configure, когда ответ зависит от страницы, покупателя или чего-то, что знает только ваш код.

​
open_on_background_add

Установите значение true, чтобы также открывать drawer при фоновых добавлениях — тех, которые Aftersell обнаружил, но не обрабатывал сам. Добавление считается фоновым, когда:
  • оно пришло через стандартные события корзины Shopify (всегда считаются фоновыми, чем бы они ни были вызваны), или
  • Aftersell увидел запрос к корзине в сети без доверенного клика или нажатия клавиши в предшествующие ~3 секунды — например, когда в корзину пишет другое приложение или скрипт.
Добавление, которое Aftersell увидел в сети и которое последовало за кликом покупателя, не является фоновым: оно уже открывает drawer согласно open_on_add_to_cart, без необходимости в этой опции.
Это дополнительный фильтр, а не переопределение: фоновое добавление открывает drawer только в том случае, если open_on_add_to_cart тоже это позволил бы. При open_on_add_to_cart: 'never' эта опция ничего не делает.
Прибегайте к этому, когда сторонняя кнопка добавления корректно добавляет товар, но оставляет drawer закрытым. Если товар вообще никогда не попадает в корзину, это проблема перехвата. См. skip_add_to_cart_interceptor и сценарий использования с page builder.

​
validate_form_on_add_to_cart

Запускает нативную валидацию формы браузера (reportValidity()) перед добавлением и отменяет добавление, если форма невалидна. Используйте, когда форма вашего товара имеет обязательные поля (сообщение для гравировки, подарочная записка, обязательный чекбокс), которые покупатели в настоящее время могут пропустить.
Браузер показывает собственное сообщение валидации на проблемном поле. По умолчанию выключено, потому что тема со случайным атрибутом required где-то в форме товара иначе начала бы молча блокировать добавление в корзину.

​
skip_add_to_cart_interceptor

Полностью отключает перехват добавления в корзину со стороны Aftersell. О том, что делает перехват, и обо всех способах отказаться от него см. Перехват добавления в корзину. Тема тогда сама выполняет добавление, и каждый скрипт, слушающий этот submit, снова запускается. Aftersell по-прежнему следит за запросом корзины в сети, поэтому drawer открывается как обычно. Отказавшись от перехвата, вы его не теряете. На темах, которые Aftersell распознаёт, собственная корзина темы остаётся неактивной, поэтому вы не получите две корзины. На теме, которую он не распознаёт, тема может открыть свою корзину рядом с вашей; см. Откроется ли также корзина темы?.
Эта опция читается один раз, при загрузке. Она работает только из вызова настройки, выполняющегося до загрузки корзины: скрипта Initialization вашей корзины. Установка её позже (внутри ready() или из обработчика события) не имеет эффекта и завершается молча.
Это грубый инструмент, отключающий перехват для каждой формы на странице. Чтобы исключить только одну форму, используйте вместо этого хук registerSkipAddToCartRule:

​
skip_open_cart_interceptor

Клик по иконке корзины открывает drawer Aftersell. Чтобы делать это надёжно, Aftersell останавливает клик, чтобы ничего другое на странице его не обработало, а это также мешает вашим скриптам его увидеть. Если событие аналитики или пикселя срабатывает везде, кроме иконки корзины, дело именно в этом. Установите значение true, чтобы перестать заглушать клик:
Ваши слушатели тогда будут срабатывать, а drawer по-прежнему будет открываться ровно так же, как раньше. Клик также по-прежнему не будет переходить на /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.

​
Что дальше