QR Scanner Pro: Сканер QR кодов с поддержкой callback функций

Что умеет решение

Модуль QR Scanner Pro обеспечивает сканирование QR-кодов и штрихкодов непосредственно в браузере без установки сторонних приложений. С его помощью можно реализовать учет и поиск товаров, регистрацию посетителей мероприятий, проверку билетов, обработку заявок и другие задачи. Результат сканирования можно перенаправить на конкретную страницу сайта или обработать с помощью пользовательской PHP-функции. Готовые примеры кода ускоряют внедрение, а гибкие настройки позволяют адаптировать интерфейс под любой дизайн и сценарий использования.

Модуль распознает широкий спектр кодов, применяемых в торговле, логистике и документообороте. Поддерживаются QR-коды, содержащие ссылки, контактные данные, текст и JSON. Работают с кодами Data Matrix, включая маркировку товаров в системе «Честный ЗНАК». Обеспечивается чтение кодов Aztec для электронных билетов и посадочных талонов. Поддерживается формат PDF417 для документов, удостоверений и проездных. Также распознаются стандартные товарные штрихкоды EAN-13, EAN-8, UPC-A и UPC-E.

Модуль поддерживает распознавание штрихкодов Code 128, Code 39, Code 93 и ITF, применяемых для складской и логистической маркировки, а также на накладных и транспортной упаковке. Также обрабатываются коды Codabar, используемые в отдельных библиотечных, медицинских и учетных системах.

Распознавание выполняется непосредственно на устройстве пользователя. Модуль использует встроенные возможности браузера; при их отсутствии активируется механизм на JavaScript. Это позволяет считывать коды в современных браузерах без установки отдельного приложения.

Сканирование в реальном времени происходит при открытии страницы сайта: пользователь наводит камеру на код, и распознавание осуществляется автоматически без нажатия кнопок. Используется основная (задняя) камера устройства.

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

Модуль предлагает два режима обработки результата. Callback-функция передает содержимое кода в PHP-функцию, а полученный ответ отображается пользователю во всплывающем окне без перезагрузки страницы. Режим редиректа перенаправляет пользователя на указанную страницу.

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

После установки автоматически формируется раздел /qr/ с готовыми демонстрационными страницами. Здесь представлены примеры работы обоих режимов обработки, что позволяет быстро познакомиться с функционалом и проверить работоспособность модуля.

Компонент digimatix:qr.scanner можно разместить на любой странице или в шаблоне сайта. Для разных разделов ресурса доступны отдельные сценарии и параметры настройки.

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

Интерфейс сканера адаптивен и корректно работает на смартфонах и планшетах.

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

Сценарий быстрого старта обеспечивает наличие рабочего примера и раздела /qr/ сразу после установки.

Интеграция проста: достаточно разместить компонент на странице, и он начинает работать.

Модуль обеспечивает гибкость дизайна: вы можете создавать собственные шаблоны, стили, подсказки и рамки наведения. Сценарии использования масштабируются: параметры компонента можно настраивать отдельно для каждого URL в зависимости от конкретной задачи. Для маркетинга и работы с контентом предусмотрено минимальное количество настроек, при этом архитектура остается расширяемой для разработчиков.

Модуль эффективен для интернет-магазинов и розничных точек при поиске товаров по штрихкоду, проверке маркировки и открытии карточек товаров по QR-коду. Организаторы мероприятий используют его для валидации электронных билетов и регистрации посетителей. Склады и логистические компании применяют решение для приема и учета товаров, сверки остатков и управления логистикой продукции. Сервисные организации размещают QR-наклейки на оборудовании для быстрого перехода к заявке, карточке объекта или форме обращения. Компании, ведущие учет посещаемости, регистрируют сотрудников, учеников и участников мероприятий с помощью индивидуальных QR-кодов. Рестораны, кафе и гостиницы используют модуль для создания электронных меню, навигации к страницам бронирования и программам лояльности, а также для реализации собственных сценариев работы с QR-кодами.

Установите модуль. После завершения установки автоматически создаётся раздел /qr/, содержащий компонент digimatix:qr.scanner. Этот раздел можно использовать как готовую страницу для тестирования работоспособности сканера.

Выберите один из трёх способов обработки данных QR-кода или штрих-кода: использование callback-функции, URL-режим или реализация собственного обработчика.

Для режима Callback укажите в параметрах компонента имя функции, например Digimatix\QrScanner\Functions::ExampleQr($_REQUEST["data"]). Создайте собственный обработчик, который принимает данные из $_REQUEST["data"] и выполняет необходимые действия: запись в базу данных, вывод модального окна или перенаправление пользователя.

В URL-режиме задайте адрес, на который будет отправлен параметр с данными считанного кода. Направление запроса (GET или POST) настраивается отдельно.

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

Настройте сценарии для различных задач. Разместите компонент на нужных страницах и задайте для каждой страницы индивидуальные параметры.

Пример минимального обработчика (callback):

открывающий тег PHP

namespace Digimatix\QrScanner;

class Functions {

public static function ExampleQr($data): void {

// Валидация и логирование

Модуль QR Scanner Pro от DIGIMATIX обеспечивает сканирование QR-кодов с поддержкой callback-функций. Приведенный фрагмент кода демонстрирует базовую обработку входящих данных: проверку обязательного наличия строкового параметра $data. Если параметр отсутствует или пуст, система возвращает HTTP-код ошибки 400. В блоке бизнес-логики реализованы возможности сохранения данных, их проверки и отправки уведомлений, например, через метод \Bitrix\Main\Mail\Event::send. Финальная часть кода предусматривает опциональный вывод ответа 'OK' при использовании шаблона компонента.

General iT может подключить «QR Scanner Pro: Сканер QR кодов с поддержкой callback функций», настроить его и проверить корректность интеграции с текущим сайтом.