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

Корзина

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


Описание 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"
	)
);?>


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

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
"БЬЮТИ-ПРОФ" ООО
Сообщение не промодерировано, возможны ошибки и неточности.
Где параметр количества товара в корзине? Не получается больше одной штуки каждой позиции добавить
0
Денис Климушин
Сообщение не промодерировано, возможны ошибки и неточности.
Цитата
пишет:
"DETAIL_URL" => "/catalog/#SECTION_CODE_PATH#/#ELEMENT_CODE#/",
Спасибо! Вы очень помогли
1
Вячеслав Гайтюкевич
Сообщение не промодерировано, возможны ошибки и неточности.
Цитата
пишет:
"DETAIL_URL" => "/catalog/#SECTION_CODE_PATH#/#ELEMENT_CODE#/",
Дай тебе Бог здоровья, добрый человек. Чтоб я без тебя делал! Поклон тебе!
2
Андрей Сенин
Также существует параметр DETAIL_URL

Если в корзине ссылки на товары отображаются не корректно - то передайте этот параметр по типу:
"DETAIL_URL" => "/catalog/#SECTION_CODE_PATH#/#ELEMENT_CODE#/",
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх