VIN-запрос — описание и инструкция

Плагин «VIN-запрос» добавляет на сайт форму запроса запчастей по VIN-коду, хранит заявки в базе и отправляет уведомления на e‑mail и в Telegram. Есть выгрузка в CSV и интеграция с Bitrix24.

Что умеет плагин

• Форма VIN-заявки: VIN-код, марка/модель/год, список запчастей, контакты, способ связи и страница отправки.
• Хранение заявок: все заявки сохраняются в базу и доступны в бекенде.
• Уведомления: письмо на e‑mail и сообщение в Telegram (по желанию).
• Выгрузка CSV: экспорт заявок с выбором кодировки и разделителя.
• Bitrix24: создание лида и, при необходимости, контакта/компании.

Расширенные возможности

• Глубина выбора авто до 5 уровней: 2 (Марка/Модель), 3 (Марка/Модель/Год), 4 и 5 — дополнительные подкатегории каталога, управляется настройкой «Ограничить число выводимых подкатегорий».
• Настраиваемые заголовки полей: для уровней 1–3 (Марка, Модель, Год выпуска) и дополнительно для уровней 4–5.
• Фронтенд‑форма с каскадными списками: выпадающие списки автоматически подгружают варианты на каждом уровне; если вариантов нет, показывается «Нет данных».
• Сохранение всех данных: в БД добавлены поля level4 и level5, значения отправляются с формы и записываются вместе с VIN, Маркой, Моделью и Годом.
• Отображение в админке: список заявок показывает «Марка/Модель/Год/4/5», карточка заявки по клику включает уровни 4 и 5 (если заполнены).
• Уведомления и интеграции: Email и Telegram содержат уровни 4/5; в Bitrix24 уровни 4/5 добавляются в комментарии лида.

Все перечисленное работает без учета каких‑либо флагов; управление глубиной происходит через настройку в разделе VIN.

Где найти заявки

Админка → Магазин → слева в меню появится пункт «Заявки по VIN». Прямая ссылка:

Там же доступны удалённые заявки и страница экспорта (кнопки вверху).

Как встроить на сайт (интеграция в тему)

1. Подключите стили и скрипты плагина в index.html вашей темы перед </head>:

   {if $wa->shop}{shopVinzaprosPlugin::head()}{/if}

2. Выведите форму VIN-заявки в том месте, где хотите её показать (например, перед </body> или на любую страницу):

   {if $wa->shop}{shopVinzaprosPlugin::displayVin()}{/if}

Примечания:

• Форма отправляет данные AJAX‑запросом, поэтому ничего вручную подключать дополнительно не нужно.
• Список марок может заполняться автоматически из категорий (см. настройки ниже).

Настройки

1. Общие

Админка → Магазин → Настройки → Вкладка «VIN-запрос». Включите плагин и при необходимости задайте цели метрики.

2. Уведомления

• E‑mail: адрес отправителя и получателя, тема письма, HTML‑шаблон и текст «Спасибо».
• Telegram (опционально): включите переключатель, укажите chat_id и bot token. После сохранения тестируйте отправкой формы.

3. VIN-настройки

• ID категорий марок: введите через запятую ID категорий вашего каталога, из которых нужно показать список «Марка»
  Можно указать сами категории марок или их родительские — плагин подхватит дочерние.
• Способы связи: отметьте, какие варианты показывать (Телефон/WhatsApp/Telegram/Макс).
• Текст «Спасибо»: HTML‑текст, который увидит пользователь после успешной отправки.

4. Интеграция с Bitrix24 входит в премиум версию

• Включите интеграцию, укажите: домен (ваш_домен), ID пользователя (1 по умолчанию), вебхук и источник (WEB по умолчанию).
• Выберите: создавать контакт и/или компанию автоматически.
• В заявку (лид) передаются все данные формы: VIN, марка/модель/год, запчасти, контакты, способ связи, страница.

Как работает внутри

Уведомления

• E‑mail: отправляется на адрес, указанный в «Уведомления → E‑mail получателя». Шаблон письма настраивается там же.
• Telegram: если включено и заданы chat_id/token, приходит читабельное сообщение вида:

  VIN-заявка - Название сайта
  VIN: WVWZZZ...
  Марка/Модель/Год: ...
  Запчасти: ...
  Контакт: Имя, +7..., email
  Связь: Телефон/WhatsApp/Telegram (Ник)
  Со страницы: https://...

FAQ

• Почему не появляются марки в списке? Проверьте, что в «VIN-настройках» указаны корректные ID категорий (или их родителей) из вашего каталога, и что категории/подкатегории реально существуют.
• Не приходят уведомления в Telegram. Проверьте, что в «Уведомлениях» включен Telegram и верно проставлены chat_id и bot token. Затем отправьте тестовую заявку.
• Где изменить текст «Спасибо» после отправки? В «VIN-настройках» отредактируйте поле «Текст спасибо».
• Как перенести форму в другое место на странице? Перенесите вызов {if $wa->shop}{shopVinzaprosPlugin::displayVin()}{/if} в нужный шаблон/позицию.