OX8.RU: Сканер штрих-кодов камерой смартфона для любого сайта

Технические особенности и требования

• PHP 7.4 или выше — Модуль «Информационные блоки» (iblock) — обязателен
  
• Модуль «Торговый каталог» (catalog) — опционально, для поиска по складским штрихкодам
  
• Устройство пользователя должно иметь камеру и работать по HTTPS (требование браузеров для доступа к камере)
  
• Установка и базовая настройка выполняется администратором сайта без специальной квалификации через стандартный интерфейс 1С-Битрикс
  
• Для размещения компонента на страницах сайта может потребоваться базовое знание работы с компонентами Битрикс или доступ к визуальному редактору
  

Ограничения

• Качество распознавания зависит от камеры устройства, освещения и качества печати штрихкода. Обязательно ставьте пробную версию для тестирования.
  
• Для доступа к камере сайт обязан работать по HTTPS
  
• Поиск выполняется только по точному совпадению штрихкода в указанных свойствах инфоблоков
  

Установка

• Установите модуль из Маркетплейса 1С-Битрикс стандартным способом: Административная панель → Marketplace → Каталог решений → найдите «OX8.RU: Сканер штрих-кодов» → «Установить»
  
• После установки модуль доступен в разделе Настройки → Настройки продукта → Настройки модулей → «OX8.RU: Сканер штрих-кодов камерой смартфона для любого сайта»
  

Настройка модуля

Вкладка «Общие настройки»:

• Время кеша результатов (секунд) — время кеширования результатов поиска. 0 — кеш отключён. По умолчанию: 60
  
• Максимальное количество результатов — ограничение числа найденных товаров. От 1 до 50. По умолчанию: 10
  
• Режим отладки — включает запись PHP-логов в файл и JS-логов в консоль браузера.
  

Вкладка «Источники поиска»:

• Настройки задаются индивидуально для каждого сайта (на многосайтовых конфигурациях).
  
• Использовать складские штрихкоды (модуль catalog) — если включено, модуль дополнительно ищет товары по штрихкодам в таблице b_catalog_store_barcode. Требует установленного модуля «Торговый каталог»
  
• Источники поиска — список инфоблоков и свойств, в которых хранятся штрихкоды. Нажмите «Добавить источник», выберите инфоблок и отметьте свойства, по которым нужно искать. Можно добавить несколько источников
  

Размещение компонента на сайте

Разместите компонент «ox8ru:barcode.scanner» на нужных страницах сайта через визуальный редактор или в коде шаблона:
<?$APPLICATION->IncludeComponent( 'ox8ru:barcode.scanner', '.default', [ 'MODE' => 'button', 'BUTTON_TEXT' => 'Сканировать штрих-код', 'CSS_CLASS' => '', 'SELECTOR' => '', 'AUTO_OPEN' => 'N', 'SITE_ID' => '', ] );?>
Доступные настройки:
1. Режим отображения (MODE) — способ вывода сканера на страницу:

• «button» — кнопка (по умолчанию)
  
• «link» — ссылка
  
• «selector» — привязка к произвольному элементу страницы по CSS-селектору
  
• «auto» — автоматическое открытие сканера при загрузке страницы
  

2. Текст кнопки/ссылки (BUTTON_TEXT) — текст на кнопке или ссылке.
3. CSS-класс (CSS_CLASS)

• дополнительный CSS-класс для кнопки/ссылки. Позволяет стилизовать элемент под дизайн сайта
  

4. CSS-селектор (SELECTOR)

• для режима «selector»: CSS-селектор элемента, по клику на который откроется сканер (например: #my-scan-button, .barcode-link)
  

5. Автоматически открывать сканер (AUTO_OPEN)

• если включено, сканер откроется сразу при загрузке страницы
  

6. ID сайта (SITE_ID) — для многосайтовых конфигураций.

• Если пусто — используется текущий сайт
  

Проверка работы

• Откройте страницу с размещённым компонентом на мобильном устройстве (обязательно по HTTPS)
  
• Нажмите кнопку сканирования — должен появиться интерфейс сканера с видеопотоком камеры
  
• Наведите камеру на штрихкод — при успешном распознавании модуль выполнит поиск и откроет карточку товара
  
• Если камера недоступна — введите штрихкод вручную в поле ввода и нажмите «Найти»