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

Все интеграции

Плагин для 1С-Битрикс

Компонент записи для визуального редактора и шаблонов Битрикса, отдельный чат и настройки для каждого сайта.

Версия 0.1.0

В официальном каталоге

Требования

«1С-Битрикс: Управление сайтом», PHP 8.2 и новее. Проверены редакции «Старт», «Стандарт», «Малый бизнес» и «Бизнес». Для установки нужен доступ администратора.

Перед подключением

Создайте организацию в НаКогда, добавьте услуги и настройте расписание. Расширения и код виджетов предоставляются бесплатно; после пробного периода сервис НаКогда платный, постоянного бесплатного тарифа нет. Данные для подключения возьмите в разделе «Виджет» кабинета. Нужны только публичные идентификаторы или ссылка: пароль и секретный API-ключ не требуются.

Установка из официального каталога

  1. Откройте карточку «НаКогда — онлайн-запись и чат» в 1С-Битрикс.Маркете и нажмите «Установить». Выберите сайт и следуйте штатному мастеру Битрикса.
  2. В админке откройте «Marketplace → Установленные решения» и убедитесь, что модуль «НаКогда — онлайн-запись и чат» установлен.

Установка из ZIP

  1. Скачайте ZIP и распакуйте его в /local/modules/. Проверьте путь установщика: /local/modules/nakogda.booking/install/index.php.
  2. Откройте «Marketplace → Установленные решения» в админке и нажмите «Установить» у модуля «НаКогда — онлайн-запись и чат».

Подключение к НаКогда

  1. Откройте «Настройки → Настройки продукта → Настройки модулей» и выберите «НаКогда — онлайн-запись и чат». Выберите нужный сайт в многосайтовой установке.
  2. Вставьте публичную ссылку записи из раздела «Виджет» кабинета НаКогда или UID организации. Параметр ?widget=UID в ссылке выбирает общий виджет для этого сайта.
  3. Если нужен плавающий чат, включите его отдельно. Сохраните настройки подключения.
Настройки НаКогда в 1С-Битрикс
Настройки НаКогда в 1С-БитриксОткрыть полный снимок

Размещение формы записи

  1. В визуальном редакторе добавьте компонент «НаКогда → Запись НаКогда». Для PHP-шаблона используйте вызов IncludeComponent из примера.
  2. Чтобы показать другой виджет на странице, заполните параметр WIDGET_UID компонента. Пустое значение использует виджет из настроек сайта или основной виджет организации.
  3. Проверьте, что шаблон сайта вызывает $APPLICATION->ShowHead(): через него Битрикс выводит скрипт компонента.
  4. Сохраните страницу и откройте публичный адрес. Проверьте услуги, доступное время и чат, если он включён.

Примеры

Замените ORGANIZATION_UID и WIDGET_UID публичными UID своей организации и её виджета из кабинета НаКогда.

Основной виджет из настроек
<?php $APPLICATION->IncludeComponent('nakogda:booking', '', []); ?>
Другой виджет на отдельной странице
<?php
$APPLICATION->IncludeComponent('nakogda:booking', '', [
	'WIDGET_UID' => 'WIDGET_UID',
]);
?>

Полезно знать

  • В одном подключении используется одна организация. На разных страницах можно показывать разные её виджеты; UID экземпляра формы имеет приоритет перед общими настройками. Пустой UID экземпляра использует общий виджет, а если он не указан — основной виджет организации.
  • Подключение сохраняется отдельно для каждого сайта в установке Битрикса. При настройке следующего сайта проверьте выбранный сайт и его организацию.
  • Чат включается в настройках модуля и работает на публичных HTML-страницах. Размещать компонент записи для него не требуется.
  • Услуги, расписание, записи и переписка хранятся в НаКогда. При показе формы или чата браузер загружает виджеты с time.nakogda.ru; сервис получает технические данные запроса и сведения, которые посетитель вводит в виджете.
  • Если после изменения настроек видна прежняя форма, очистите кэш страниц CMS и используемого CDN или прокси. Удалите старые ручные вставки НаКогда, чтобы форма или чат не дублировались.

Отключение и удаление

Чтобы отключить только чат, снимите его флажок. Чтобы отключить запись и чат, очистите поле подключения и сохраните. Перед удалением уберите компоненты НаКогда со страниц, затем удалите модуль через «Marketplace → Установленные решения». Настройки и файлы компонента в Битриксе будут удалены; данные НаКогда сохранятся.