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

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

1. Функциональные возможности модуля

• Отображение виджета камеры (мобильные / планшеты) и постоянное сканирование QR-кодов.
  
• Распознавание в реальном времени и передача результата: в пользовательскую "callback-функцию" (PHP), или по "URL с параметрами" (редирект/запрос).
  
• Базовый сценарий «из коробки»: отправка данных отсканированного кода на email.
  
• Гибкая настройка параметров компонента (режим обработки, маски валидации, поведение при повторных чтениях).
  
• Поддержка собственных шаблонов оформления и встраивание в текущий шаблон сайта Битрикс.
  
• Возможность размещать компонент на разных страницах/поддоменах с разными сценариями.
  
• Локальный раздел "/qr/" создаётся автоматически. В нем размещается компонент: "digimatix:qr.scanner".
  

2. Преимущества модуля

• Универсальность: реализует любые сценарии после сканирования (авторизация, верификация билетов, инвентаризация, приёмка, акции).
  
• "Быстрый старт": рабочий пример и раздел /qr/ доступны сразу после установки.
  
• Простая интеграция: поставил компонент на страницу — работает.
  
• Гибкость дизайна: свои шаблоны, стили, подсказки, рамки наведения.
  
• Масштабируемость сценариев: разные параметры компонента на разных URL под задачу.
  
• Минимум настроек для маркетинга/контента; расширяемость для разработчиков.
  

3. Модуль может быть полезен

• E-commerce: быстрые промо-акции по QR, пост-покупочная регистрация, отслеживание гарантий.
  
• Офлайн-мероприятия: чек-ин посетителей, верификация билетов/бейджей.
  
• Склад/логистика/ритейл: инвентаризация, учёт приемки, перемещение товаров.
  
• Сервисные компании: привязка заявки по QR с объекта, авторизация исполнителя на месте.
  
• Образование/HR: отметка присутствия, выдача материалов/тестов по QR.
  
• HoReCa: электронные меню, программы лояльности, подтверждение курьеров.
  

4. Как работать с модулем

• Установка: после установки появится раздел /qr/ с размещённым компонентом `digimatix:qr.scanner`.
  
• Выбор механики обработки:
  

"Callback:" укажите в параметрах компонента функцию, например
    `Digimatix\QrScanner\Functions::ExampleQr($_REQUEST["data"]);`
    Реализуйте собственный обработчик, который получает `$_REQUEST["data"]` и выполняет нужные действия (запись в БД, показ модалки, редирект и т.п.).
  "URL-режим": задайте URL, на который будет передан параметр с данными кода (GET/POST по настройке).

• Кастомизация интерфейса: скопируйте шаблон компонента в шаблон сайта и измените верстку/подсказки/оверлей.
  
• Разные сценарии на разных страницах: разместите компонент на нужных URL и задайте разные параметры (например, `/qr/checkin/` — отметка присутствия, `/qr/stock/` — инвентаризация).
  

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

<?php
namespace Digimatix\QrScanner;

class Functions {
   public static function ExampleQr($data): void {
       // Валидация/логирование
       if (!is_string($data) || $data === '') { http_response_code(400); return; }

       // Бизнес-логика: сохранить/проверить/уведомить
       // \Bitrix\Main\Mail\Event::send([...]); // пример отправки письма

       // Опционально: вывести ответ (если используете шаблон компонента)
       echo 'OK';
   }
}