Онлайн-запись Google Calendar, ver. 1.0.0

Онлайн-запись Google Calendar (pcode.googlecalendar)

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

Возможности

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

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

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

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

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

Установите модуль через стандартную систему обновлений или скопируйте папку

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

2. Подключение Google API

Для работы требуется файл ключей

credentials.json от Service Account Google Cloud Platform.

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

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

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

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

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

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

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

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

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

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).