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

---

---

Яндекс Календарь Онлайн-Запись (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).

Этот модуль позволяет организовать полноценную систему онлайн-записи на сайте с синхронизацией событий в Яндекс Календарь.

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

1. Загрузите модуль через маркетплейс.
   
2. Перейдите в административную панель Битрикс: Рабочий стол → Настройки → Настройки продукта → Модули.
   
3. Найдите в списке модуль «Yandex Calendar Онлайн-Запись» (pcode.yandexcalendar) и нажмите Установить.
   
4. В процессе установки модуль создаст необходимый тип инфоблока и инфоблок «Yandex Calendar Заявки» для хранения истории записей.
   

2. Настройка API Яндекс (Получение токена)

Для работы модуля необходим OAuth-токен от Яндекса:

1. Зарегистрируйте приложение на Яндекс OAuth.
   
2. При регистрации выберите права (Scope) для Яндекс.Календаря - Чтение и изменение содержимого календарей и списков дел (calendar:all)
   
3. В качестве Redirect URI укажите: https://oauth.yandex.ru/verification_code.
   
4. После регистрации получите Client ID.
   
5. Перейдите по ссылке (подставив ваш ID): https://oauth.yandex.ru/authorize?response_type=token&client_id=ВАШ_CLIENT_ID
   
6. Подтвердите доступ и скопируйте полученный OAuth-токен.
   

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

Перейдите в Настройки → Настройки модулей → Yandex Calendar Онлайн-Запись:

• Yandex OAuth Токен: Вставьте токен, полученный в предыдущем шаге.
  
• ID календаря по умолчанию: Обычно это ваш email (например, user@yandex.ru). Это основной календарь, куда будут приходить записи, если у специалиста не указан свой ID. НО ЛУЧШЕ ВСЕГО УКАЗАТЬ ID КАЛЕНДАРЯ! (в настройках календаря находим пункт Экспорт и далее находим поле CalDAV, копируем только часть ссылки, после слова /calendars/ (и поправляем почту), то есть id календаря получится mailtest@yandex.ru/events-345565)
  
• Глобальный список специалистов:
  
• Добавьте специалистов (имя).
  
• Для каждого можно указать ID его личного календаря (если нужно, чтобы записи падали в разные календари)(в настройках календаря находим пункт Экспорт и далее находим поле CalDAV, копируем только часть ссылки, после слова /calendars/ (и поправляем почту), то есть id календаря получится mailtest@yandex.ru/events-345565).
  

• Глобальный список услуг:
  • Укажите название услуги и её длительность в минутах.
    
  • Привяжите услугу к конкретным специалистам (выберите из списка).
    

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

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

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

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

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

Если у вас есть идеи или пожелания по улучшению модуля — обращайтесь в техническую поддержку:
mail@profycode.pro


Мы с радостью адаптируем модуль под ваши нужды и сделаем его ещё удобнее!