Онлайн-запись Google Calendar

---

---

Онлайн-запись 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).

Описание модуля

Модуль pcode.googlecalendar позволяет организовать профессиональную онлайн-запись на вашем сайте 1С-Битрикс, используя Google Календарь как основной источник расписания.

Как это работает:
1.  Клиент заходит на сайт и видит форму записи.
2.  Модуль "спрашивает" у Google Календаря: "Какие слоты свободны на выбранный день?".
3.  Google проверяет ваши встречи и отдает только свободное время.
4.  Клиент выбирает время, заполняет форму (Имя, Телефон).
5.  В вашем календаре **моментально** создается встреча с данными клиента.
6.  В Битриксе (в Инфоблоке) создается дубль заявки для отчетности.

Инструкция по установке модуля в видео формате: https://youtu.be/rB4olZChJHc
---

Шаг 1. Установка файлов модуля

   Установка в Административной панели:

• Зайдите в Админку Битрикса.
  
• Перейдите: Marketplace (или Настройки) -> Установленные решения.
  
• В списке найдите модуль: Google Calendar Онлайн-Запись (pcode.googlecalendar).
  
• Нажмите кнопку (гамбургер) слева от названия -> Установить.
  
• Система сообщит об успешной установке и создании необходимых Инфоблоков.
  

Шаг 2. Получение ключей Google API (Самый важный этап)

Чтобы сайт мог управлять вашим календарем, нужно создать специального "Робота" (Service Account) в Google и дать ему права.

1.  Создание Проекта:

• Зайдите на Google Cloud Console.
  
• В левом верхнем углу (рядом с логотипом Google Cloud) нажмите на список проектов и выберите New Project (Создать проект).
  
• Назовите его, например, `MyBookingSite` и нажмите Create.
  

2.  Включение API:

• В меню слева выберите APIs & Services -> Library.
  
• В поиске введите: `Google Calendar API`.
  
• Нажмите на карточку результата и нажмите кнопку Enable (Включить)
  

3.  Создание Сервисного Аккаунта:

• Перейдите в меню APIs & Services -> Credentials (Учетные данные).
  
• Нажмите сверху +CREATE CREDENTIALS -> Service Account.
  
• Service account name: введите любое имя, например `booking-bot`.
  
• Нажмите Create and Continue.
  
• В "Grant this service account access to project" выберите роль Owner** (Владелец) или Editor (для простоты, чтобы точно работало). Нажмите Continue -> Done.
  

4.  Создание Ключа (JSON):

• В списке "Service Accounts" (внизу страницы Credentials) нажмите на email только что созданного аккаунта (он выглядит как `booking-bot@project-id.iam.gserviceaccount.com`).
  
• Перейдите на вкладку KEYS (Ключи).
  
• Нажмите ADD KEY -> Create new key.
  
• Выберите тип JSON и нажмите Create.
  

Шаг 3. Настройка параметров модуля

• Перейдите в Настройки → Настройки модулей → Онлайн-запись Google Calendar:
  
• Путь к файлу ключей: Загрузите и укажите файл json (ключ), который вы создавали в Google Cloud Console.
  
• ID календаря по умолчанию: Обычно это ваш email (например, user@gmail.com). Это основной календарь, куда будут приходить записи, если у специалиста не указан свой ID. НО ЛУЧШЕ ВСЕГО УКАЗАТЬ ID КАЛЕНДАРЯ! (в настройках календаря находим пункт Интеграция календаря и далее находим поле Идентификатор календаря, копируем и вставляем)
  
• Глобальный список специалистов:
  
• Добавьте специалистов (имя).
  
• Для каждого можно указать ID его личного календаря (если нужно, чтобы записи падали в разные календари)((в настройках календаря находим пункт Интеграция календаря и далее находим поле Идентификатор календаря, копируем и вставляем).
  
• Глобальный список услуг:
  
• Укажите название услуги и её длительность в минутах.
  
• Привяжите услугу к конкретным специалистам (выберите из списка).
  

Шаг 4. Размещение компонента на сайте

  Откройте нужную страницу сайта в режиме правки и разместите компонент

$APPLICATION->IncludeComponent(
"pcode:google.calendar",
".default",
....

Шаг 5. Проверка работы

• На странице появится виджет с выбором услуги, специалиста и даты.
  
• При выборе даты компонент через API Google проверяет занятость выбранного календаря и выводит только свободные слоты.
  
• После заполнения формы:
  
• Событие мгновенно создается в Google Календарь.
  
• Данные клиента сохраняются в инфоблок Битрикса «Google Calendar Заявки».
  

По вопросам технической поддержки обращайтесь на email: mail@profycode.pro