Требования
Drupal 10.6 и новее в ветке 10 или Drupal 11.3 и новее в ветке 11. Модулю нужен PHP 8.1 и новее; ваша версия Drupal может требовать более новый PHP. Для проверки новой ссылки нужен cURL.
Перед подключением
Создайте организацию в НаКогда, добавьте услуги и настройте расписание. Расширения и код виджетов предоставляются бесплатно; после пробного периода сервис НаКогда платный, постоянного бесплатного тарифа нет. Данные для подключения возьмите в разделе «Виджет» кабинета. Нужны только публичные идентификаторы или ссылка: пароль и секретный API-ключ не требуются.
Установка из официального каталога
- Рекомендуемый способ, особенно для Drupal 11: в корне Composer-проекта выполните composer require drupal/nakogda:^1.0. Composer скачает официальный выпуск с Drupal.org в каталог модулей проекта.
- В админке откройте «Расширения» (Extend), отметьте NaKogda booking and chat и нажмите «Установить».
Установка из ZIP
- Ручная установка требует доступа к файлам сервера. Для сайта, управляемого Composer, используйте рекомендуемый способ выше; загрузка ZIP через админку не требуется.
- Скачайте официальный ZIP. Распакуйте каталог nakogda в web/modules/contrib/nakogda, если публичный корень проекта — web/. При другом публичном корне используйте modules/contrib/nakogda относительно него. Файл nakogda.info.yml должен лежать непосредственно в этом каталоге.
- В админке откройте «Расширения» (Extend), отметьте NaKogda booking and chat и установите модуль.
Подключение к НаКогда
- Откройте «Конфигурация → Веб-службы → НаКогда — онлайн-запись и чат» (Configuration → Web services → NaKogda booking and chat).
- В поле «Ссылка записи или UID организации» вставьте публичную ссылку из раздела «Виджет» кабинета НаКогда или UID организации. В ссылке можно выбрать общий виджет через ?widget=UID.
- Если нужен чат, включите «Показывать плавающий чат на публичных страницах» и сохраните. При ошибке проверки новой ссылки прежние настройки сохраняются.

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

Примеры
Замените ORGANIZATION_UID и WIDGET_UID публичными UID своей организации и её виджета из кабинета НаКогда.
composer require drupal/nakogda:^1.0https://time.nakogda.ru/ORGANIZATION_UID/?widget=WIDGET_UIDПолезно знать
- В одном подключении используется одна организация. На разных страницах можно показывать разные её виджеты; UID экземпляра формы имеет приоритет перед общими настройками. Пустой UID экземпляра использует общий виджет, а если он не указан — основной виджет организации.
- Чат работает на публичных HTML-страницах без блока записи. На административных страницах форма и чат не загружаются.
- Если на сервере нет PHP cURL, включите его для проверки новой ссылки либо укажите публичный UID организации. Уже сохранённые ссылки и прямые UID не требуют повторной проверки при показе страницы.
- Услуги, расписание, записи и переписка хранятся в НаКогда. При показе формы или чата браузер загружает виджеты с time.nakogda.ru; сервис получает технические данные запроса и сведения, которые посетитель вводит в виджете.
- Если после изменения настроек видна прежняя форма, очистите кэш страниц CMS и используемого CDN или прокси. Удалите старые ручные вставки НаКогда, чтобы форма или чат не дублировались.
Отключение и удаление
Чтобы отключить запись и чат, очистите поле подключения и сохраните. Для отключения только чата снимите его флажок. Для удаления модуля и его конфигурации откройте «Расширения → Удаление» (Extend → Uninstall). При необходимости очистите отдельный кэш прокси. Данные организации в НаКогда сохраняются.