«Ракета - модуль магазина на редакции Старт. Поддержка SKU. Оплата через Робокассу. ФЗ-54.»: модуль для 1С-Битрикс

---

---

Ракета - модуль магазина от онлайн школы программирования "GuruBX". Модуль позволяет организовать интернет-магазин на младших редакциях "Старт" и "Стандарт". Принимайте оплату на вашем сайте в несколько кликов. Более 20 способов оплаты товаров и услуг через Робокассу, в том числе через Apple Pay и Samsung PayМодуль "Ракета" поддерживает торговые предложения по разной стоимости. Предлагайте клиентам различные вариации товаров - по цвету, размерам и любым другим характеристикам. В данный момент в товарах можно выбрать только 1 параметр SKU. Например, у одного товара можно указать только выбор цвета, у второго размер, у третьего еще какой-либо параметр. Модуль пока не поддерживает перекрестные параметры SKU. Такая возможность планируется в обновлении 3.0
Модуль поддерживает Робочеки - для отправки чеков в налоговую не требуется покупать или арендовать онлайн-кассу. Оплата покупок и передача фискальных чеков будет осуществляется через онлайн-кассу Robokassa. Возможно подключение к Робокассе как юридическими, так и физическими лицами.Вы можете продавать товар в одной из 4 валют - рубль, доллар, евро, тенге. В момент оплаты система автоматически сконвертирует валюту в рубли по курсу ЦБ РФ. Достаточно выбрать валюту в настройках, все остальное сделает модуль.Все заказы сохраняются не только в системе, но и по электронной почте менеджера. Клиент также получает уведомление о заказе в виде удобной таблицы. Используется штатный функционал почтовых шаблонов, что позволяет настраивать письма по собственному усмотрению.
Модуль содержит готовые адаптивные шаблоны компонентов. Вы можете сразу выбрать готовые шаблоны или внедрить свои по документации.

В составе модуля 5 компонентов:

1. Корзина
   
2. Статус заказа (2 шаблона - во всплывающем окне или в любом блоке)
   
3. Кнопка покупки (продавайте любую произвольную услугу или товар одной кнопкой)
   
4. Каталог товаров (плитка, список, слайдер, баннер)
   
5. Карточка товара (если вам необходима отдельная страница для каждого товара)
   

Компоненты "Каталог товаров" и "Карточка товара" выполнены на основе стандартных компонентов news.list и news.detail для легкой интеграции.

Также модуль содержит 3 установочных инфоблока:

1.   Заказы
   
2.   Товары
   
3.   Справочник цветов
   

Главный компонент модуля, возможна публикация в виде всплывающего окна. Корзина содержит изображение товара, артикул, цену, количество, общую цену товара, общее количество товаров и общую сумму заказа. Артикулы торговых предложений генерируются автоматически.

Компонент содержит форму заказа из 3 полей - ФИО, телефон и Email.
Для соблюдения Федерального закона 152 внедрено согласие на обработку персональных данных. Вы можете воспользоваться штатным функционалом Битрикса для создания соглашения и указать ссылку в настройках модуля.

Поле "телефон" может быть не обязательным, E-mail необходим для получения почтовых уведомлений и чека от ОФД

Быстрая проверка статуса по номеру заказа и email клиента. Ваши клиенты смогут быстро проверить статус и состав своего заказа. Размещайте в заказе общий статус и индивидуальные сообщения для клиентов. Автоматическое изменение статуса заказа при успешной оплате.Вы можете продавать произвольные услуги или товары без привязки к информационному блоку. Просто разместите на странице компонент и в настройках укажите все необходимые параметры. Компонент также полезен для реализации функции покупки в произвольных компонентах.Мы предусмотрели готовые шаблоны компонентов для реализации каталога. Вы можете воспользоваться готовыми вариантами или разработать свой шаблон на примере наших. В модуле 4 адаптивных шаблона каталога на основе Bootstrap: плитка, список, слайдер и баннер. Шаблоны разработаны на основе штатного компонента news.list для легкой интеграции.В компоненте реализован выбор SKU, возможность указания разных цен SKU, выбор количества товара, запрет на покупку товара при отсутствии на складе. В настройках компонента имеется возможность включить или отключить выбор количества товара для покупки. Отключить возможность указания количества товара можно и выборочно у конкретных товаров. Мы также подготовили пример реализации карточки товара. Шаблон разработан на основе штатного компонента news.detail. Вы можете кастомизировать шаблон по своему усмотрению.Модуль имеет отдельную страницу с настройками, где можно быстро сменить валюту, подключить необходимые библиотеки, включить возможность отправки email уведомлений, настроить параметры Робокассы и отправки фискальных чеков.

Внешний вид модуля управляется настройками компонентов, где также можно включить или выключить некоторые функции, а также выбрать любой цвет кнопок по HEX коду или загрузить свои иконки.

Минимальная версия PHP для работы модуля - 7.0.
Минимальная версия 1С Битрикс для работы модуля - 14.0

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

1. БАЗОВЫЕ НАСТРОЙКИ МОДУЛЯ

Настройки модуля располагаются в разделе "Настройки" - "Настройки продукта" - "Настройки модулей" - "Ракета - модуль магазина".

1.1 JQUERY

Для корректной работы модуля необходимо подключение библиотеки Jquery 3 версии и выше. Если в шаблоне вашего сайта библиотека не подключена в файле header.php, поставьте галочку в настройках модуля "Подключить Jquery 3.3.1".

1.2 FONTAWESOME

Для корректного отображения иконок необходимо подключить FontAwesome - поставьте соответствующую галочку в настройках модуля.

1.3 BOOTSTRAP

Также потребуется включить библиотеку Bootstrap 3 версии. Если вы планируете использовать наши компоненты каталога, поставьте галочку в настройках модуля (если в шаблоне сайта библиотека не подключена).

1.4 ПОЧТОВЫЕ УВЕДОМЛЕНИЯ

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

Используется штатные почтовые шаблоны продукта. Отредактировать письма можно в разделе "Настройки" - "Настройки продукта" - "Почтовые и СМС события" - "Почтовые шаблоны".

Модулю принадлежат 2 почтовых события:
[RAKETA_ORDER] Оформлен новый заказ
[RAKETA_ORDER_CLIENT] Уведомление клиенту при оформлении заказа

Также 2 соответствующих почтовых шаблона:
[ORDER] Оформлен новый заказ
[ORDER_CLIENT] Уведомление клиенту при оформлении заказа

Если письма не приходят на почту, проверьте работоспособность почтового сервера, а также настройки на стороне 1С Битрикс.

1.5 ЗАРЕГИСТРИРУЙТЕСЬ НА САЙТЕ РОБОКАССЫ
И НАСТРОЙТЕ МАГАЗИН

Если Вы хотите принимать оплату на сайте зарегистрируйтесь на странице https://partner.robokassa.ru/Reg/Register, как юридическое лицо, ИП или физическое лицо. Персональные данные Вы можете указать следующим этапом после подготовки модуля.

Создайте магазин в личном кабинете и заполните все поля на вкладке "Карточка магазина". На вкладке "Технические настройки" укажите:

• Идентификатор магазина - любое значение на латинице
  
• Алгоритм расчета хеша - MD5
  
• Пароль #1 и Пароль #2 (запишите)
  
• Result Url https://site.ru/raketa_pay/result.php (где site.ru - ваше доменное имя)
  
• Метод отсылки данных по Result Url - POST
  
• Success Url https://site.ru/raketa_pay/success.php (где site.ru - ваше доменное имя)
  
• Метод отсылки данных по Success Url - POST
  
• Fail Url https://site.ru/raketa_pay/fail.php (где site.ru - ваше доменное имя)
  
• Метод отсылки данных по Fail Url - POST
  

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


После получения всех необходимых настроек заполните недостающие поля в настройках модуля "Ракета" на вкладке "Настройка оплаты и чеков". После тестирования оплаты, Вы сможете перейти к заключению договора, активации вашего магазина на стороне робокассы, а также подключить Робочеки в личном кабинете. На стороне модуля необходимо будет лишь поставить галочку "Отправлять чек клиенту по email".

2. НАСТРОЙТЕ ИНФОРМАЦИОННЫЕ БЛОКИ

Модуль содержит 3 информационных блока:

1. Заказы
   
2. Товары
   
3. Цвета
   

Первым делом откройте настройки инфоблока "Заказы". В свойствах инфоблока откройте детальные настройки свойства "Статус". Измените статусы заказа по своему усмотрению, а также запомните или запишите ID статусов, которые будут использоваться сразу после создания заказа и получения оплаты от клиента. ID этих двух статусов необходимо указать в настройках модуля.

На примере ID статусов заказа - 1, 2 и 3

Вернитесь в настройки модуля "Магазин - Ракета" и укажите на первой вкладке ID статуса нового заказа, а на второй вкладке "ID статуса заказа после оплаты". Второй статус потребуется только в том случае, если вы хотите принимать оплату на сайте через Робокассу.

В инфоблоке "Цвета" вы можете указать возможные цветовые варианты для использования SKU. В свойстве "Цвет" укажите HEX код цвета без решетки #

В инфоблоке "Товары" укажите свойства и параметры SKU, которые будут использоваться на сайте.

2.2 НАСТРОЙКА SKU В ИНФОБЛОКЕ "ТОВАРЫ"

Обратите внимание! У каждого товара может быть только 1 параметр SKU, например, цвет, размер или любое другое свойство. При создании или редактировании товара Вы сможете выбрать параметр выборки SKU.

Каждый параметр SKU может иметь свою цену. Для этого в инфоблоке создаются свойства  SKU_PRICE1,  SKU_PRICE2,  SKU_PRICE3 и так далее (без ограничений по количеству). То есть SKU_PRICE1 - это цена первого значения SKU, SKU_PRICE2 - цена второго значения SKU.

Если у Вас цены SKU не меняются, заполнять не обязательно. При отсутствии цен SKU будет подставляться основная цена товара.

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

3.1 КОРЗИНА - ОБЯЗАТЕЛЬНЫЙ КОМПОНЕНТ

В визуальном редакторе выберите компонент "Ракета - компонент корзины" и разместите в файле header.php шаблона сайта. Без этого компонента модуль работать не будет, как и без наличия подключенной библиотеки JQuery. Если после размещения кода вызова компонента не появилась иконка корзины, значит отсутствует Jquery или возникает конфликт нескольких библиотек.

При настройке компонента обратите особое внимание вкладке "CSS классы обертки элементов корзины для работы скриптов".

Это актуально в случае использования модуля в собственных компонентах. Если какой-либо функционал не работает в модуле, в 90% случаев причина кроется в несоответствии обязательных параметров. Если вы используете наши компоненты, никаких дополнительных настроек делается не требуется.

Давайте рассмотрим пример простой HTML структуры товара.

• Товар - укажите в какой CSS класс обернут товар, в примере это "product"
  
• Кнопка добавления в корзину - укажите CSS класс кнопки для вызова функции добавления товара в корзину
  
• Цена товара - укажите CSS класс, в котором хранится цена. Это необходимо только в том случае, если вы используете разные цены в торговых предложениях (SKU). Оборачивайте иконку валюты в отдельный тег.
  
• Параметры SKU - укажите CSS класс, в котором размещается каждое значение SKU
  
• Количество товаров - укажите CSS класс блока с выбором количества товара, если такая функция используется
  
• Малая корзина - укажите CSS класс кнопки, которая открывается попап с корзиной
  

3.2 СТАТУС ЗАКАЗА

Компонент имеет 2 шаблона - во всплывающем окне (popup) и на отдельной странице или блоке (.default). Email и ID заказа являются обязательными параметрами. Если параметры не совпадают, заказ не будет найден.

3.3 КНОПКА ЗАКАЗА

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

3.4 КОМПОНЕНТЫ КАТАЛОГА

Модуль содержит примеры реализации каталога - компоненты raketa.products и raketa.detail - это аналоги штатных компонентов news.list и news.detail соответственно. Вы можете реализовать каталог на основе наших шаблонов или реализовать на любых других компонентах, например, "catalog". В модуле имеется 4 адаптивных шаблона каталога товаров на основе Bootstrap: плитка, список, слайдер и баннер.

4. ПРИМЕРЫ РЕАЛИЗАЦИИ

Создайте раздел, например, /catalog/

Разместите код вызова компонента "raketa.products", выберите любой шаблон и настройте по своему усмотрению. Обязательно выберите в настройках все системные свойства инфоблока (поле "Свойства").

Заполните поле "Свойство выбора цвета (SKU)", если Вы используете в каталоге выбор цвета товара. По умолчанию данное свойство имеет символьный код - SKU_COLOR_HTML

Укажите "URL страницы детального просмотра" для корректного формирования ЧПУ, например, #SITE_DIR#catalog/#ELEMENT_CODE#/, где "#ELEMENT_CODE# - это символьный код товара" (который должен быть заполнен у всех товаров), а #SITE_DIR# - корневая директория сайта.
После этого при клике на товар должна открываться отдельная страница товара, например, /catalog/chaynik-yaponskiy/

Вместо товара Вы увидите надпись "Элемент не найден" или 404 ошибку. На данном этапе важно лишь корректно сформировать URL-адрес страницы товара.

Теперь нужно создать физическую страница товара. Внутри директории /catalog/ создаем страницу detail.php и размещаем код вызова компонента "raketa.detail"

Здесь важно заполнить поле "Код новости", куда будут передаваться символьные коды элементов каталога. Значение должно быть такое:В поле "свойства" отмечаем только те свойства, которые должны отображаться на вкладке "Характеристики". Также не забываем заполнить Свойство выбора цвета (SKU), если оно используется.

Последний шаг - добавляем правило обработки адресов.
Переходим в раздел "Настройки" - "Настройки продукта" - "Обработка адресов" - "Правила обработки"

Добавляем новое правило:Теперь при открытии страницы с карточкой товара, например, /catalog/chaynik-yaponskiy/, система будет обращаться к файлу detail.php и передавать символьный код элемента. После этих несложных действий карточки товаров на вашем сайте будут открываться корректно.

4.1 КАК ОРГАНИЗОВАТЬ КАТАЛОГ с разделами?

Если Вам необходимо вывести разделы информационного блока, можете воспользоваться штатным компонентом "catalog.list". Использовать тяжелые комплексные компоненты для простых проектов не имеет смысла. Внедрение компонента разделов каталога выполняется по той же аналогии.


1) Создаем раздел /catalog/
В файле index.php этого раздела размещаем код вызова компонента catalog.list, указываем необходимые настройки, в поле SECTION_URL указываем:
2) Создаем в директории /catalog/ файл .list.php и размещаем компонент raketa.products, настройки рассматривали выше. В поле DETAIL_URL указываем:
В поле PARENT_SECTION_CODE указываем:

3) Создаем в директории /catalog/ файл .detail.php и размещаем компонент raketa.detail, настройки рассматривали выше. В поле ELEMENT_CODE указываем:

4) Создаем 2 правила обработки адресов:


Прилагаем архив с 3 файлами каталога, где вы можете посмотреть настройки

Техническая поддержка осуществляется по электронной почте support@gurubitrix.online. Рассмотрение очередной заявки выполняется в рамках очереди и зависит от загруженности команды. Максимальный срок ответа 1 рабочий день.

При обращении максимально подробно опишите возникшую проблему, приложив соответствующие скриншоты, а также доступ в административную панель сайта. Это существенно ускорит обработку запроса.