# Квэлп: Мастерская Расскажите об услугах, покажите работы и познакомьте клиентов с мастерами. Заявки и онлайн-запись помогают перейти от знакомства к визиту. ## Подготовка и установка ## Первая установка 1. Создайте резервную копию файлов и БД целевого Битрикса. Проверьте PHP 8.2+, UTF-8, `main` 26.800.0+ и модули `iblock`, `fileman`, `search`. 2. После публикации установите **qwelp.workshopnext** через Маркетплейс. Для локальной проверки разработчиком содержимое `.last_version/` из архива размещается в `/local/modules/qwelp.workshopnext/`; затем модуль устанавливается штатным интерфейсом партнёрских решений Битрикса. Архив сам по себе не является готовым корнем сайта. 3. Запустите мастер **«Мастерская — новый сайт»** из результата установки, настроек модуля или списка мастеров Битрикса. Мастер имеет код `qwelp:workshopnext`. 4. Выберите существующий пустой сайт либо создайте новый сайт в свободном каталоге. Мастер предлагает свободный двухсимвольный код нового сайта, например `s1`; его можно изменить. Укажите каталог `/workshop/` или другой свободный каталог — он должен отсутствовать. Для установки в `/` выберите заранее подготовленный пустой сайт с этим каталогом. За один запуск устанавливается один сайт с одной веткой управления «Мастерская»; тестовые сайты в поставку не включены. 5. Введите название, телефон и email администратора для заявок. Дождитесь сообщения о завершении. Не подменяйте установку импортом копии рабочей базы. Мастер откажется перезаписывать существующий `index.php`, изменённые файлы и чужое наполнение. Это также относится к файлам, уже находящимся в корне сайта. При конфликте подготовьте пустой каталог или отдельно согласуйте перенос существующего сайта; автоматического удаления нет. Повторный запуск для того же сайта продолжает сохранённые этапы и не создаёт дубликаты. В актуальном проверенном ядре репозиторий мастеров расположен в `/bitrix/wizards/`. Модуль копирует туда только собственный мастер через InstallFiles. Шаблон, компоненты, административные страницы и защищённые настройки находятся в `/local/`. ## После установки Откройте **Мастерская** в левом меню админки либо `/local/tools/workshopnext-content.php?site=<код>`. Там доступны главная страница, услуги, работы, новости, акции, мастера, контакты, тексты, логотип и оформление. Контент редактируется штатными формами инфоблоков, изменения сбрасывают связанные кеши. - **Логотип и название:** PNG/JPEG/WebP до 2 МБ, название и подпись; предпросмотр и сохранение. - **Оформление:** светлая/тёмная тема, цвета, шрифты, шапка и подвал, порядок и видимость разделов, виды баннера, эффект и скорость анимации, автопрокрутка, расположение кнопки «Наверх». - **Рабочий режим панели:** доступна администратору, изменения сохраняются для всех посетителей. **Демо-режим:** каждый посетитель меняет оформление в собственной сессии, без изменения данных и общих настроек. По умолчанию включён рабочий режим. - **Карты:** введите собственный ключ и разрешённый домен Яндекс Карт; настройте адреса и координаты центров. Ключ разработчика не поставляется. - **Защита формы:** обычная капча с обновлением изображения; SmartCaptcha после ввода своих клиентского и серверного ключей; настройка отключения защиты. Серверный ключ хранится в закрытом конфигурационном файле, а не в контенте. - **Счётчики и скрипты:** свои подключения и категория согласия cookie. Добавление произвольного кода доступно только администратору с правом `edit_php`. В админке Битрикса задайте настоящий домен, имя сайта и email отправителя. Сгенерируйте sitemap штатным генератором для нового сайта, проверьте robots.txt именно в корне домена. Файл robots.txt в подпапке не управляет индексацией всего домена. Замените примеры контактов, мастеров, фотографий, услуг и правовые тексты данными своей организации. Настройте HTTPS, почтовый транспорт, разрешённые домены внешних сервисов. Ключи карт/капчи, счётчики, пользователи и реальные заявки из исходного сайта в поставку не включаются. ## Заявки и почта Форма сохраняет заявку в отдельном закрытом инфоблоке сайта. Администратору создаётся почтовое событие `QWELP_WORKSHOPNEXT_REQUEST`; активный почтовый шаблон привязан к соответствующему сайту. Посетитель получает сообщение об успешном приёме на странице. Поля email в текущей форме нет, поэтому подтверждение посетителю по электронной почте не отправляется. Сохранённая заявка и письмо в очереди — разные состояния. Реальная доставка зависит от настройки почтового транспорта Битрикса и сервера. В локальной проверке подтверждены сохранение и очередь, не доставка во внешний ящик. ## Удаление и повторная установка Удаление модуля снимает его регистрацию и обработчики событий, удаляет неизменённые файлы его мастера. Сайты, шаблон, компоненты, контент, изображения, заявки, почтовые шаблоны и настройки сохраняются. Сайт требует установленного модуля; для продолжения его работы установите модуль снова. Повторная установка не сбрасывает данные. Полное удаление сайта и его данных выполняется владельцем отдельно. Функция автоматического разрушительного удаления в поставке отсутствует. ## Если установка остановилась Проверьте сообщение, свободное место, доступ к БД и права записи. Нажмите «Повторить шаг». Если сессия администратора истекла, войдите снова, откройте мастер и выберите уже созданный сайт. Он продолжит с сохранённого этапа. Не меняйте каталог сайта в ходе установки. ## Онлайн-запись ### Два способа записи Клиент может записаться в центр или к определённому мастеру. Администратор настраивает график, длительность приёма и вместимость. Поддерживаются автоматическое подтверждение и подтверждение администратором. ### После установки Демонстрационные расписания не переносятся в новый сайт. Задайте рабочие дни и доступное время, затем включите онлайн-запись для нужных центров. Проверьте форму, доступные интервалы и уведомления на своём сайте. ### Уведомления Решение сохраняет запись и выполняет попытку отправить уведомления после сохранения. Получение письма зависит от настройки почтового транспорта. Перед открытием записи проверьте реальную доставку. ## Обновление 1.0.4 Если решение ещё не установлено, мастер показывает понятное сообщение и ссылку на подтверждение установки. Сам сайт автоматически не устанавливается. Изменённые пользователем копии мастера сохраняются.