Корзина

Введение

В интернет-магазине корзина находится на странице /cart_items.

Для изменения состава корзины предусмотрено три операции:

добавление позиции,
обновление позиции,
групповое изменение состава корзины (с его помощью сделана кнопка пересчитать на странице корзины в стандартных шаблонах).

Все операции, меняющие состав корзины, осуществляются путем отправления POST запроса на URL /cart_items. Можно ограничиться обычными html формами, можно манипулировать корзиной при помощи ajax запросов, для этого надо использовать URL /cart_items.json. Содержание запросов не зависит от того, каким из двух способов вы работаете с корзиной.

Если вы используете html форму, то после выполнения операции покупатель будет перенаправляться на страницу корзины.

Добавление позиции

Параметры запроса:

variant_id - id модификации
quantity - добавляемое в корзину количество
comment - комментарий к позиции заказа (обязательно разрешить комментарии к заказу в бек-офисе)

Если вы используете ajax запрос, то вам вернут объект в JSON формате с атрибутами:

items - описание позиций;
items_count - количество позиций;
total_price - стоимость заказа с учетом скидок и стоимости доставки;
currency - обозначение валюты, указанное в настройках валюты;
currency_format - формат вывода стоимости, указанный в настройках валюты.
и т.д.

js

        
          /* Пример на jQuery */
$.post('/cart_items.json', {
    variant_id: 104490412,
    quantity: 1,
    comment: "test comment"
  })
  .done(function (cart) {
    console.log(cart);
  })

Добавление нескольких позиций

Параметры запроса:

variant_ids[id] - добавляемое в корзину количество экземпляром модификации с идентификатором id

Если вы используете ajax запрос, то вам вернут объект в JSON формате с атрибутами:

items - описание позиций;
items_count - количество позиций;
total_price - стоимость заказа с учетом скидок и стоимости доставки;
currency - обозначение валюты, указанное в настройках валюты;
currency_format - формат вывода стоимости, указанный в настройках валюты.
и т.д.

js

        
          /* Пример на jQuery */
$.post('/cart_items.json', {
  variant_ids: {
    98156648: 1,
    98156640: 2
    }
  })
  .done(function (cart) {
    console.log(cart);
  })

Удаление позиции

URL запроса: /cart_items/id

где id - идентификатор модификации

Параметры запроса:

_method - строка 'delete'

Если вы используете ajax запрос, то вам вернут объект в JSON формате с атрибутами:

items_count - количество позиций;
total_price - стоимость заказа с учетом скидок и стоимости доставки;
currency - обозначение валюты, указанное в настройках валюты;
currency_format - формат вывода стоимости, указанный в настройках валюты.
и т.д.

js

        
          /* Пример на jQuery */
$.post('/cart_items/98156178.json', {
    _method: "delete"
  })
  .done(function (cart) {
    console.log(cart);
  })

Обновление состава корзины

Позволяет одновременно добавлять и удалять позиции, так же позволяет менять количество заказываемых товаров.

Параметры запроса:

_method - строка 'put'
cart[quantity][id модификации] - количество (если вы хотите удалить позицию, то 0)
cart[order_line_comments][id модификации] - текст комментария к позиции заказа

Если в количестве указан 0, то модификация удаляется из корзины.

Если вы используете ajax запрос, то вам вернут объект в JSON формате с атрибутами:

total_price - стоимость заказа с учетом скидок и стоимости доставки;
currency - обозначение валюты, указанное в настройках валюты;
currency_format - формат вывода стоимости, указанный в настройках валюты.
и т.д.

Liquid js

        
          <form action="/cart_items" id="cartform" method="post">
  <input type="hidden" value="put" name="_method">
  <table>
  {% for item in cart.items %}
    <tr>
      <td><a href="{{ item.product.url }}">{{ item.title | escape }}</a></td>
      <td><input type="text" value="{{ item.quantity }}" name="cart[quantity][{{ item.id }}]"/><td>
      <td><input type="text" value="{{ item.comment }}" name="cart[order_line_comments][{{ item.id }}]"/><td>
   </tr>
  {% endfor %}
  </table>
</form>

        
          /* Пример на jQuery */
$.post('/cart_items.json', {
    _method: 'PUT',
    cart: {
      quantity: {
      109715042: 1
    }
  } 
})
.done(function (cart) {
  console.log(cart);
})

// или
$.post('/cart_items.json', $('#cartform').serialize())
  .done(function (cart) {
    console.log(cart);
  })
// Сериализованные данные _method=PUT&cart%5Bquantity%5D%5B104490412%5D=1