Документация

Подготовка и установка

Первая установка

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

Если решение ещё не установлено, мастер показывает понятное сообщение и ссылку на подтверждение установки. Сам сайт автоматически не устанавливается. Изменённые пользователем копии мастера сохраняются.