Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

Корзина

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


Описание sale.basket.basket

Одностраничный компонент отображает список товаров, отправленных пользователем в корзину.Товары в корзине могут быть отложены и будут храниться, либо удалены из корзины, также пользователь может перейти к оформлению заказа. Компонент стандартный и входит в дистрибутив модуля.

С версии 18.1.0 модуля Интернет-магазин в составе шаблона .default доступна новая страница empty.php. Теперь при переходе в пустую корзину будет отображаться содержимое страницы empty.php вместо стандартной надписи "Корзина пуста". Кастомизируя шаблон, можно настроить собственное описание пустой корзины.

В визуальном редакторе компонент расположен по пути: Магазин > Корзина > Корзина.

Компонент относится к модулю Интернет-магазин.



Параметры

Поле Параметр Описание
Основные параметры
Использовать механизм отложенной актуализации данных товаров с провайдером DEFERRED_REFRESH [Y|N] При выборе данной опции запрос актуализации данных о товаре (цены, наличие и др. из каталога) будет отправляться в фоновом режиме после отображения основной информации о товарах. Таким образом, получается выигрыш по времени для более быстрого отображения страницы.
Использовать динамическую подгрузку товаров USE_DYNAMIC_SCROLL [Y|N] При динамической подгрузке изначально отображаются первые 30 позиций в корзине, а последующие появляются при прокручивании страницы. Данная опция эффективна для магазинов с большими корзинами (с количеством позиций выше 30).
Отображать фильтр товаров SHOW_FILTER [Y|N] Опция отвечает за подключение фильтра, с помощью которого можно искать товары в корзине по наименованию, свойствам и другим параметрам товара. Данная опция эффективна для магазинов с большими корзинами.
Разрешить восстановление удалённых товаров SHOW_RESTORE [Y|N] Предоставляется возможность восстановить только что удаленный товар в корзине без перехода в каталог.
Внешний вид
Выводимые колонки COLUMNS_LIST Задаются поля, которые будут выведены в качестве названий колонок в таблице товаров, находящихся в корзине.
Колонки, отображаемые на мобильных устройствах COLUMNS_LIST_MOBILE Выбираются элементы корзины, которые будут отображаться в мобильной версии сайта.
Цветовая тема TEMPLATE_THEME Указывается цветовая тема для отображения списка товаров корзины.
Отображение блока с общей информацией по корзине TOTAL_BLOCK_DISPLAY Указывается один из двух способов отображения положение блока с с полем ввода номера купона, общей стоимостью заказа и кнопками его оформления.
Доступные способы отображения:
  • Над корзиной
  • Под корзиной
Режим отображения корзины DISPLAY_MODE Задается режим отображения корзины: «Расширенный» или «Компактный».
Отображать цену в отдельной колонке PRICE_DISPLAY_MODE [Y|N] Цена за 1 единицу товара будет отображаться в отдельной колонке.
Показывать процент скидки рядом с изображением SHOW_DISCOUNT_PERCENT [Y|N] Выводить рядом с изображением товара стикер с размером действующей скидки. Расположение стикера можно задать в дополнительном поле.
Расположение процента скидки DISCOUNT_PERCENT_POSITION Задается место расположения стикера на изображении: по центру, справа, слева или внизу.
Порядок отображения блоков товара PRODUCT_BLOCKS_ORDER Указывается порядок отображения блоков товара. Для изменения положение блока товара ухватите его в конструкторе левой кнопкой мыши и сместите вверх или вниз на нужную позицию.
Использовать анимацию цен USE_PRICE_ANIMATION [Y|N] Если опция включена, то при изменении количества товара в корзине цена по виду товара и общая стоимость заказа быстро «прокручиваются» до нужного значения (как на спидометре). Если опция отключена, суммы изменяются моментально без визуальных эффектов.
Свойства меток товара LABEL_PROP Указывается, какие метки товара (стикеры) будут отображаться на странице.
Дополнительные настройки
Страница оформления заказа PATH_TO_ORDER Задается путь к странице c процедурой оформления заказа. Если страница находится в текущей директории, то достаточно указать ее название.
Спрятать поле ввода купона HIDE_COUPON [Y|N] На странице с корзиной товаров станет скрытым поле для ввода купона на скидку .
Отображать значение НДС PRICE_VAT_SHOW_VALUE [Y|N] При отмеченной опции будет показано значение НДС для товара.
Использовать предавторизацию для оформления заказа (PayPal Express Checkout) USE_PREPAYMENT [Y|N] Станет доступной к использованию оптимизированная версия ExpressCheckout Shortcut, когда система Paypal автоматически отображает информацию клиента для выполнения заказа.
Использовать дробное значение количества QUANTITY_FLOAT [Y|N] Возможность использования дробного количества товара.
Автоматически рассчитывать количество товара кратное коэффициенту CORRECT_RATIO [Y|N] Будет выводиться количество товара, кратное заданному коэффициенту (опция удобна при оптовых продажах).
Автопересчет корзины AUTO_CALCULATION [Y|N] Корзина станет пересчитываться автоматически.
Устанавливать заголовок страницы SET_TITLE [Y|N] В качестве заголовка страницы будет установлено Моя корзина.
Название переменной действия ACTION_VARIABLE Указывается имя переменной, в которой передается действие. Значение поля по умолчанию action. Значение параметра должно быть уникальным среди всех используемых компонентов на одной странице.
Включить режим совместимости COMPATIBLE_MODE Включение режима совместимости старых шаблонов с новыми версиями модуля.
Путь к странице для продолжения покупок EMPTY_BASKET_HINT_PATH Относительно корня сайта указывается путь к странице, на которую должен перенаправляться пользователь для продолжения покупок.
Настройка торговых предложений
Свойства, влияющие на пересчет корзины OFFERS_PROPS Указываются свойства торговых предложений, которые должны отображаться в корзине и влияют на пересчет корзины.
Настройки изображений
Дополнительная картинка ADDITIONAL_PICT_PROP_2 Добавление в корзину изображения из дополнительной фотогалереи товара.
Дополнительная картинка (предложения) ADDITIONAL_PICT_PROP_3 Добавление в корзину изображения из торгового предложения.
Режим отображения изображений товаров BASKET_IMAGES_SCALING Определение размера основного фото товара. Доступные режимы:
  • Стандартный — маленькое фото
  • Адаптивный — фото среднего размера
  • Без сжатия — фото максимального размера
Настройки "Подарков"
Показывать блок "Подарки"USE_GIFTS[Y|N] При отмеченной опции будет отображаться блок с доступными подарками.
Вывод блока "Подарки" GIFTS_PLACE Выбирается способ отображения блока с подарками: над или под корзиной.
Текст заголовка "Подарки"GIFTS_BLOCK_TITLEУказывается текст заголовка блока с подарками.
Скрыть заголовок "Подарки"GIFTS_HIDE_BLOCK_TITLE[Y|N] При отмеченной опции заголовок блока подарков будет скрыт.
Текст метки "Подарка"GIFTS_TEXT_LABEL_GIFTУказывается текст метки, которая проставляется для подарка.
Название переменной, в которой передается количество товараGIFTS_PRODUCT_QUANTITY_VARIABLEЗадается имя переменной, в которой будет передаваться количество товара.
Название переменной, в которой передаются характеристики товараGIFTS_PRODUCT_PROPS_VARIABLEЗадается имя переменной, в которой будет передаваться характеристики товара.
Показывать старую ценуGIFTS_SHOW_OLD_PRICE[Y|N] Если задана скидка на товар, то при отмеченной опции будет отображаться старая цена.
Показывать процент скидкиGIFTS_SHOW_DISCOUNT_PERCENT[Y|N] При отмеченной опции будет отображаться процентное значение скидки, если она задана.
Показывать названиеGIFTS_SHOW_NAME[Y|N] При отмеченной опции будет отображено название элемента.
Показывать изображениеGIFTS_SHOW_IMAGE[Y|N] При отмеченной опции будет показано изображение элемента.
Текст кнопки "Выбрать"GIFTS_MESS_BTN_BUYЗадается текст, который должен быть отображен на кнопке "Выбрать".
Текст кнопки "Подробнее"GIFTS_MESS_BTN_DETAILЗадается текст, который должен быть отображен на кнопке "Подробнее".
Количество элементов на страницеGIFTS_PAGE_ELEMENT_COUNTУказывается количество элементов, отображаемых на одной странице.
Показывать цены в одной валютеGIFTS_CONVERT_CURRENCYПри установке флажка цены будут выводиться в одной валюте, даже если в каталоге они будут заданы в разных валютах.
Не отображать товары, которых нет на складахHIDE_NOT_AVAILABLE[Y|N] При отмеченной опции будут скрыты товары, для которых общее доступное количество меньше либо равно нулю (не остатки по складам), включен количественный учет и не разрешена покупка при отсутствии товара.
Настройки аналитики
Отправлять данные электронной торговли в Google и ЯндексUSE_ENHANCED_ECOMMERCE[Y|N] Включение опции. После включения станут доступны ещё два поля
Имя контейнера данныхDATA_LAYER_NAMEУказываются свойства инфоблока, которые будут отображены в списке просмотренных товаров. При выборе пункта (не выбрано)-> и без указания кодов свойств в строках ниже, свойства выведены не будут.
Свойство брендовBRAND_PROPERTYУказывается свойство инфоблока, откуда система должна брать название бренда товара (производитель, марка, модель и т.п.).
. Требуется дополнительная настройка в Google Analytics Enhanced Ecommerce и/или Яндекс.Метрике.

Примечание: Настройка Яндекс метрикой не сложна, и данные в ней отображаются довольно быстро (полчаса-час). У Google используется Google Tag Manager с плагином электронной коммерции, его нужно настроить и добавить на страницу в шаблоне. После настройки на "той" стороне, нужно настроить компоненты для работы с электронной коммерцией и включить это поле настройки.



Пример вызова

<?$APPLICATION->IncludeComponent(
	"bitrix:sale.basket.basket",
	"",
	Array(
		"ACTION_VARIABLE" => "action",
		"AUTO_CALCULATION" => "Y",
		"TEMPLATE_THEME" => "blue",
		"COLUMNS_LIST" => array("NAME","DISCOUNT","WEIGHT","DELETE","DELAY","TYPE","PRICE","QUANTITY"),
		"COMPONENT_TEMPLATE" => ".default",
		"GIFTS_BLOCK_TITLE" => "Выберите один из подарков",
		"GIFTS_CONVERT_CURRENCY" => "Y",
		"GIFTS_HIDE_BLOCK_TITLE" => "N",
		"GIFTS_HIDE_NOT_AVAILABLE" => "N",
		"GIFTS_MESS_BTN_BUY" => "Выбрать",
		"GIFTS_MESS_BTN_DETAIL" => "Подробнее",
		"GIFTS_PAGE_ELEMENT_COUNT" => "4",
		"GIFTS_PRODUCT_PROPS_VARIABLE" => "prop",
		"GIFTS_PRODUCT_QUANTITY_VARIABLE" => "",
		"GIFTS_SHOW_DISCOUNT_PERCENT" => "Y",
		"GIFTS_SHOW_IMAGE" => "Y",
		"GIFTS_SHOW_NAME" => "Y",
		"GIFTS_SHOW_OLD_PRICE" => "Y",
		"GIFTS_TEXT_LABEL_GIFT" => "Подарок",
		"GIFTS_PLACE" => "BOTTOM",
		"HIDE_COUPON" => "N",
		"OFFERS_PROPS" => array("SIZES_SHOES","SIZES_CLOTHES"),
		"PATH_TO_ORDER" => "/personal/order.php",
		"PRICE_VAT_SHOW_VALUE" => "N",
		"QUANTITY_FLOAT" => "N",
		"SET_TITLE" => "Y",
		"USE_GIFTS" => "Y",
		"USE_PREPAYMENT" => "N"
	)
);?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024