Онлайн-запись Яндекс Календарь, ver. 1.0.1

Яндекс Календарь Онлайн-Запись (pcode.yandexcalendar)

Мощный и гибкий модуль для организации онлайн-записи на услуги с полной интеграцией API Яндекс Календарь и 1С-Битрикс.

Возможности

Модуль позволяет развернуть полноценную систему бронирования на вашем сайте за 5 минут. Клиенты выбирают услугу, специалиста и удобное время, а заявка мгновенно попадает в Яндекс Календарь сотрудника и в CRM (Инфоблок) сайта.

Ключевые функции:

• Двусторонняя синхронизация с Яндекс: Проверка занятости слотов в реальном времени. Если слот занят в календаре, он недоступен для записи на сайте.
  
• 4 Режима работы:
  1. Простой (Simple): Запись в один календарь (для частных специалистов).
     
  2. Услуги (Services): Выбор услуги -> Запись (разная длительность услуг).
     
  3. Специалисты (Specialists): Выбор мастера -> Запись (у каждого свой календарь).
     
  4. Полный (Full): Выбор Услуги + Выбор Специалиста -> Умная фильтрация.
     
• Интеграция с Инфоблоками: Все заявки дублируются в специальный инфоблок "Yandex Calendar Заявки" (создается автоматически). Это база ваших лидов внутри Битрикса.
  
• Гибкое расписание: Настройка рабочих дней и часов глобально или для каждой услуги отдельно.
  
• Современный UI:
  • Адаптивный дизайн (Mobile-First).
    
  • AJAX-подгрузка слотов (без перезагрузки страницы).
    
  • Приятный календарь и выбор времени.
    
  • Стилизация под любой дизайн (CSS переменные).
    

Установка и Настройка

1. Установка модуля

Установите модуль через стандартную систему обновлений и нажмите "Установить" в админке. Во время установки модуль автоматически создаст необходимые Инфоблоки и Типы инфоблоков.

2. Подключение Яндекс OAuth

Для работы требуется создать приложение в Яндекс OAuth

и создать после этого OAuth токен

1. Перейдите в настройки модуля: Настройки -> Настройки модулей -> Yandex Calendar Онлайн-Запись.
   
2. Введите OAuth токен.
   
3. Там же вы можете настроить Глобальный список услуг и специалистов.
   

3. Размещение компонента

Добавьте компонент

pcode:yandex.calendar на любую страницу сайта.

Основные параметры компонента:

• Режим работы: Выберите один из 4-х режимов.
  
• Рабочее время: Укажите начало и конец рабочего дня (например, с 9 до 18).
  
• Длительность слота: Базовое время приема (например, 60 мин).
  
• ID Календаря: Если используете простой режим, укажите Email календаря здесь. В режимах "Специалисты" ID берутся из глобальных настроек.
  

Режимы работы подробнее

SIMPLE (Простая запись)

Идеально для лендингов и личных страниц. Просто календарь и форма. Все заявки падают в один общий Яндекс Календарь.

SPECIALISTS (Выбор специалиста)

Для клиник, салонов красоты, барбершопов. Пользователь сначала выбирает специалиста (например, "Мастер Иван"), и видит свободное время именно этого мастера.

• Требует настройки "Специалистов" в настройках модуля.
  

SERVICES (Выбор услуги)

Для сервисов с разными процедурами. "Стрижка" (30 мин) или "Окрашивание" (120 мин). Система автоматически рассчитает, сколько слотов нужно занять.

FULL (Полный цикл)

Связывает услуги и специалистов. Выбираем "Массаж", и система предлагает только тех специалистов, кто делает массаж. Выбираем мастера — видим его свободное время.

Техническая информация

• Код модуля: pcode.googlecalendar
  
• Компонент: pcode:google.calendar
  
• Зависимости: PHP 7.4+, модуль iblock, наличие credentials.json с правами доступа к календарям.
  
• Особенности: Использует Google API Client PHP Library (включена в модуль).
  

Кастомизация

Внешний вид полностью настраивается через CSS. Шаблон компонента находится в

.default и использует понятные классы (.booking-widget, .time-slot, .booking-success).