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

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

Плагин для Drupal

Блоки записи с настройками видимости страниц, отдельный UID для каждого блока и независимый плавающий чат.

Версия 1.0.2

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

Требования

Drupal 10.6 и новее в ветке 10 или Drupal 11.3 и новее в ветке 11. Модулю нужен PHP 8.1 и новее; ваша версия Drupal может требовать более новый PHP. Для проверки новой ссылки нужен cURL.

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

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

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

  1. Рекомендуемый способ, особенно для Drupal 11: в корне Composer-проекта выполните composer require drupal/nakogda:^1.0. Composer скачает официальный выпуск с Drupal.org в каталог модулей проекта.
  2. В админке откройте «Расширения» (Extend), отметьте NaKogda booking and chat и нажмите «Установить».

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

  1. Ручная установка требует доступа к файлам сервера. Для сайта, управляемого Composer, используйте рекомендуемый способ выше; загрузка ZIP через админку не требуется.
  2. Скачайте официальный ZIP. Распакуйте каталог nakogda в web/modules/contrib/nakogda, если публичный корень проекта — web/. При другом публичном корне используйте modules/contrib/nakogda относительно него. Файл nakogda.info.yml должен лежать непосредственно в этом каталоге.
  3. В админке откройте «Расширения» (Extend), отметьте NaKogda booking and chat и установите модуль.

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

  1. Откройте «Конфигурация → Веб-службы → НаКогда — онлайн-запись и чат» (Configuration → Web services → NaKogda booking and chat).
  2. В поле «Ссылка записи или UID организации» вставьте публичную ссылку из раздела «Виджет» кабинета НаКогда или UID организации. В ссылке можно выбрать общий виджет через ?widget=UID.
  3. Если нужен чат, включите «Показывать плавающий чат на публичных страницах» и сохраните. При ошибке проверки новой ссылки прежние настройки сохраняются.
Настройки НаКогда в Drupal
Настройки НаКогда в DrupalОткрыть полный снимок

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

  1. Откройте «Структура → Схема блоков» (Structure → Block layout). Разместите блок NaKogda booking в нужной области публичной темы.
  2. В настройках блока задайте страницы, на которых он должен показываться, и сохраните размещение.
  3. Поле Widget UID оставьте пустым для общего виджета. Для другой формы создайте отдельный блок, укажите UID виджета той же организации и настройте видимость страниц.
  4. Откройте публичную страницу как посетитель. Проверьте форму в нужной области темы и чат, если он включён.
Размещение формы записи в Drupal
Размещение формы записи в DrupalОткрыть полный снимок

Примеры

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

Установка через Composer
composer require drupal/nakogda:^1.0
Выбор виджета в ссылке подключения
https://time.nakogda.ru/ORGANIZATION_UID/?widget=WIDGET_UID

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

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

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

Чтобы отключить запись и чат, очистите поле подключения и сохраните. Для отключения только чата снимите его флажок. Для удаления модуля и его конфигурации откройте «Расширения → Удаление» (Extend → Uninstall). При необходимости очистите отдельный кэш прокси. Данные организации в НаКогда сохраняются.