Корзина

Для отображения корзины и всех этапов заказа (адрес доставки, варианты оплаты и т. д.) необходимо создать несколько разделов и подключить к ним следующие компоненты:

При попадании на первую страницу корзины, покупатель увидит список товаров, которые уже есть в корзине

Для правки визуальной части этой страницы перейдите в компонент «Корзина». В окне «Префикс списка объектов» находится вся визуальная часть страницы, включая служебные методы. При необходимости вы можете внести в визуальное отображение свои правки. В тот момент, когда покупатель нажимает на кнопку «Оформить заказ» он перенаправляется на страницу «Заказы» причём в режиме добавления. Визуальный вид этой страницы правится в компоненте «Заказ», шаблон действия «Добавление». Код страниц добавления оснащён большим количеством комментариев, описание методов вы можете найти в разделе «Справочник API».

Вернёмся к корзине. Для работы с ней существуют следующие методы:

Доступ к содержимому корзины:

$netshop->cart->get_items();
// или
$netshop->get_cart_contents();

Количество наименований товаров в корзине:

$netshop->cart->get_item_count();
// или
count($netshop->get_cart_contents());

Стоимость всех товаров в корзине:

$netshop->cart->get_totals();

Сумма по полю:

// ∑(Weight × Qty)
$netshop->cart->get_items()->get_field_sum('Weight');
// или
$netshop->get_cart_contents()->get_field_sum('Weight');

Путь к скрипту добавления товара в корзину:

$netshop->get_add_to_cart_url(); // эквивалент nc_module_path('netshop') . "actions/cart.php"

Список оповещений о невозможности заказать выбранное количество товаров:

$netshop->cart->get_quantity_notifications();
// вернёт null или объект nc_netshop_cart_notifications, который имеет метод __toString(), поэтому можно так:
echo $netshop->cart->get_quantity_notifications();

// если нужно вывести нестандартное сообщение:
$notifications = $netshop->cart->get_quantity_notifications();
if ($notifications) {
  foreach ($notifications->get_all() as $message) {
    $item = $message['item']; // для краткости
    echo "Вы хотели $message[requested_qty] $item[Units] товара с названием «$item[Name]», но у нас есть всего $item[Qty]...";
  }
}

Разметка, которую возвращает метод nc_netshop_cart_notifications::__toString():

<div class='tpl-block-message tpl-block-netshop-cart-message-list tpl-status-error'>
    <div class='tpl-block-netshop-cart-message'>Сообщение 1</div>
    <div class='tpl-block-netshop-cart-message'>Сообщение 2</div>
</div>

Корзина в макете

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

<?
$netshop = nc_netshop::get_instance();
$total_items = $netshop->cart->get_item_count();?>
<div class="tpl-field-title"><a class="tpl-block-headercart" href="<?= $netshop->get_add_to_cart_url(); ?>">Корзина товаров</a><br>
    <div class="tpl-field-description">
        <? if ($total_items) { ?>
            В корзине
            <span class="tpl-field-amount"><?= $total_items; ?> <?= plural_form($total_items, 'товар', 'товара', 'товаров'); ?></span>
            <br>на сумму
            <? $totals = $netshop->cart->get_totals(); ?>
            <span class="<?= $totals ? 'tpl-field-summary' : ''; ?>"><?= $netshop->format_price($totals); ?></span>
        <? } else { ?>
            Корзина пуста
        <? } ?>
    </div>
 </div>

Скрипт добавления товаров в корзину

Скрипт, добавляющий товары в корзину, находится по адресу /netcat/modules/netshop/actions/cart.php. Запросы к скрипту должны выполняться методом POST.

Добавление товара

Есть два способа добавить товары в корзину.

1. Передав количество товаров для каждого из товаров. Такой способ удобен, если нужно одновременно добавить несколько товаров с разным количеством.
   • cart[ID компонента][ID товара] = количество
     Строку "[ID компонента][ID товара]" можно получить из свойства RowID объекта nc_netshop_item ($item['RowID']).
   Пример формы добавления товара в корзину:

   <form action="<?= nc_modules("netshop")->get_add_to_cart_url() ?>" method="post">
       <input type="hidden" name="redirect_url" value="<?= $item['URL'] ?>" />
       <input type="hidden" name="cart_mode" value="add" />
       <input type="number" name="cart<?= $item['RowID'] ?>" value="1" min="0" />
       <button type="submit">В корзину</button>
   </form>

2. Передав список товаров с одинаковым количеством. Такой способ удобен, если для выбора товаров используется выпадающий список (select) или список с переключателями (input type=radio, input type=checkbox).
   • items[] — массив, в котором значения — ID компонента и ID объекта, разделённые двоеточием (например: "520:10" — компонент 520, объект 10); такое значение можно получить из свойства _ItemKey объекта nc_netshop_item ($item['_ItemKey']).
   • qty — количество добавляемого товара (одинаковое для всех товаров, перечисленных в items[]), по умолчанию равно 1.
   Пример формы добавления товара в корзину:

   <form action="<?= nc_modules("netshop")->get_add_to_cart_url() ?>" method="post">
       <input type="hidden" name="redirect_url" value="<?= $item['URL'] ?>" />
       <input type="hidden" name="cart_mode" value="add" />
       <label>
           <input type="checkbox" name="items[]" value="<?= $item['_ItemKey'] ?>" /> 
           $item['FullName']
       </label>
       <button type="submit">В корзину</button>
   </form>

Добавление товара без перезагрузки страницы

Для добавления товара без перезагрузки страницы вы можете использовать AJAX-запрос, добавив параметр json=1.

Скрипт вернёт информацию о содержимом корзины после запрошенных изменений в виде JSON-строки. Объект ответа имеет следующие свойства:

• Items: информация о товарах в корзине. Тип значения — объект, в котором ключ — "ID_компонента:ID_товара", а значение — объект с данными о каждом из товаров в корзине, имеющий свойства:
  • Class_ID: ID компонента
  • Message_ID: ID объекта
  • Name: название товара
  • VariantName: название варианта товара
  • Vendor: производитель
  • FullName: полное наименование (Vendor + Name + VariantName)
  • Image: путь к картинке, указанной в поле Image
  • ItemPrice: цена со скидкой, float
  • ItemPriceF: цена со скидкой, отформатированная
  • OriginalPrice: цена без скидки, float
  • OriginalPriceF: цена без скидки, отформатированная
  • Qty: количество
  • TotalPrice: стоимость со скидкой, float
  • TotalPriceF: стоимость со скидкой, отформатированная
  • ItemDiscount: скидка на 1 шт. товара, float
  • ItemDiscountF: скидка на 1 шт. товара, отформатированная
  • DiscountPercent: процент скидки
  • TotalDiscount: общая скидка на позицию, float
  • TotalDiscountF: общая скидка на позицию, отформатированная
  • URL: путь к странице товара
• QuantityNotifications: сообщения о невозможности добавить выбранное количество товара в корзину. Тип значения — объект, ключ для каждого из товаров соответствует ключу в объекте Items.
  • Message: текст сообщения
  • RequestedQty: запрошенное количество
• TotalItemPrice: стоимость товаров со скидками, float
• TotalItemPriceF: сумма товаров со скидками, отформатированная
• TotalItemOriginalPrice: сумма товаров без скидок, float
• TotalItemOriginalPriceF: сумма товаров без скидок, отформатированная
• TotalCount: количество наименований товаров в корзине
• TotalItemCount: количество товаров в корзине
• TotalItemDiscountSum: сумма скидок, float
• TotalItemDiscountSumF: сумма скидок, отформатированная

Пример скрипта с использованием jQuery:

$(function() {

    /**
     * Обработчик ответа на запрос на добавление товара в корзину
     */
    function processCartResponse(response) {
        // Обновим блок «Корзина» на странице
        var totalItems = response.TotalItemCount;
        var cartHtml = totalItems
            ? 'В корзине ' +
              '<span class="tpl-property-amount">' + totalItems + ' ' + pluralForm(totalItems, 'товар', 'товара', 'товаров') + '</span>' +
              '<br>на сумму <span class="tpl-property-totals">' + response.TotalItemPriceF + '</span>'
            : 'Ваша корзина пуста';

        $('.tpl-cart-summary').html(cartHtml);

        // Сообщения о невозможности добавить выбранное количество товара в корзину
        if (response.QuantityNotifications) {
            // Обработка таких сообщений не показана в этом примере для краткости
        }

        // Сообщение о том, что товар успешно добавлен в корзину:
        alert('Товар добавлен в корзину');
    }

    /**
     * Обработчик ошибки запроса на добавление товара в корзину
     */
    function processCartError() {
        alert('Не удалось добавить товар в корзину');
    }

    /**
     * Склонение русских слов
     * @param {Number} itemQuantity  Количество товаров
     * @param {String} one           «товар»
     * @param {String} two           «товара»
     * @param {String} many          «товаров»
     * @returns {String}
     */
    function pluralForm(itemQuantity, one, two, many) {
        itemQuantity = Math.abs(itemQuantity) % 100;
        var underHundred = itemQuantity % 10,
            result = many;

        if (underHundred > 1 && underHundred < 5) { result = two; }
        if (underHundred == 1) { result = one; }
        if (itemQuantity > 10 && itemQuantity < 20) { result = many; }

        return result;
    }

    /**
     * Инициализация кнопок «Положить в корзину» (предполагается, что у таких
     * кнопок есть CSS-класс .tpl-link-cart-add).
     */
    $('.tpl-link-cart-add').on('click', function(e) {
        var form = $(e.target).closest('form');
        $.post(form.attr('action'), form.serialize() + "&json=1", null, 'json')
            .success(function(response) { processCartResponse(response); })
            .error(processCartError);
        return false;
    });
});

Удаление товара из корзины

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

Дополнительные параметры скрипта

• redirect_url — URL, на который следует выполнить переадресацию после окончания работы скрипта (если не установлен параметр json). Если redirect_url не задан, будет выполнена попытка переадресации на ссылающуюся страницу (HTTP_REFERER). Всегда задавайте этот параметр, так как HTTP_REFERER может быть не определён!
• cart_mode — если равно "add", то указанное количество добавляется к имеющемуся, иначе количество товара замещается указанным.
• cart_params — массив с дополнительными параметрами. Будет добавлен ко всем добавляемым и изменяемым товарам в корзине, в дальнейшем доступен через свойство 'OrderParameters' (например: $item['OrderParameters']).
• item_params — аналогично cart_params, но только для одного товара: item_params[id компонента][id товара][дополнительный параметр] = значение. Переданные значения в дальнейшем будут доступны через свойство 'OrderParameters' (например: $item['OrderParameters']). В случае, когда переданы и cart_params для всех товаров, и item_params для конкретного товара, будут использованы только данные из item_params.
• cart_clear — если указано значение, очищает содержимое корзины.