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

---

---

Подходит для любых редакций 1С-Битрикс, как интернет-магазинов, так и для сайтов с витриной (без корзины).

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

Функционал

• Быстрый поиск товара по штрихкоду без ручного ввода артикула
  
• Сканирование любых линейных и 2D-штрихкодов камерой мобильного устройства (EAN-13, EAN-8, UPC-A, UPC-E, Code 128, Code 39, QR Code, DataMatrix, ITF, Codabar и другие)
  
• Поиск товаров по штрихкодам в свойствах инфоблоков и в складских штрихкодах модуля «Торговый каталог» (catalog)
  
• Мгновенный переход на карточку найденного товара
  
• Ручной ввод штрихкода с клавиатуры, если камера недоступна
  

Возможности

•    Настройка нескольких источников поиска: любые инфоблоки и их свойства, в которых хранятся штрихкоды
  
•    Поддержка складских штрихкодов модуля «Торговый каталог» (b_catalog_store_barcode)
  
•    Работа на многосайтовых конфигурациях — индивидуальные настройки источников для каждого сайта
  
•    4 режима встраивания компонента: кнопка, ссылка, привязка к произвольному CSS-селектору, автооткрытие сканера
  
•    Кеширование результатов поиска с настраиваемым TTL
  
•    Ограничение максимального количества результатов поиска
  
•    Управление фонариком (вспышкой) на устройствах с поддержкой
  
•    Адаптивный интерфейс для мобильных устройств и десктопа
  
•    Режим отладки с логированием в файл и браузерную консоль
  
•    Полная локализация: русский и английский языки
  

Преимущества

•    Распознавание выполняется на стороне клиента (в браузере) — данные не передаются на сторонние серверы
  
•    Не требуется подключение или оплата внешних систем и сервисов
  
•    Поддержка многосайтовости
  
•    Поддержка поиска в нескольких инфоблоках
  
•    4 режима запуска (клик по кнопке, клик по ссылке, клик по css селектору, автооткрытие сканера при загрузке страницф)
  

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

• 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» на нужных страницах сайта через визуальный редактор или в коде шаблона:

Доступные настройки:
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)
  
• Нажмите кнопку сканирования — должен появиться интерфейс сканера с видеопотоком камеры
  
• Наведите камеру на штрихкод — при успешном распознавании модуль выполнит поиск и откроет карточку товара
  
• Если камера недоступна — введите штрихкод вручную в поле ввода и нажмите «Найти»
  

Техническая поддержка бесплатных решений (а так же помощь в установке) осуществляется на платной основе по e-mail: support@ox8.ru

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

1. Адрес сайта.
   
2. Логин и пароль для доступа в административный раздел 1С-Битрикс.
   
3. Адрес сервера, логин и пароль для доступа к сайту по FTP или SSH.
   
4. Описание проблемы и как ее воспроизвести.
   
5. Скриншоты экрана с ошибкой.
   

Поддержка осуществляется Пн-Пт с 10:00 до 17:00 по московскому времени.