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

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

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

Скриншоты

Технические данные

Вы смотрели