Требования
MODX Revolution 2.8.9 и новее в ветке 2 или MODX 3; PHP 8.1 и новее с cURL и проверкой HTTPS-сертификатов; MySQL-совместимая база данных. Для установки нужен доступ к управлению пакетами.
Расширение ожидает проверки в официальном каталоге. Сейчас установите его из ZIP по инструкции ниже.
Перед подключением
Создайте организацию в НаКогда, добавьте услуги и настройте расписание. Расширения и код виджетов предоставляются бесплатно; после пробного периода сервис НаКогда платный, постоянного бесплатного тарифа нет. Данные для подключения возьмите в разделе «Виджет» кабинета. Нужны только публичные идентификаторы или ссылка: пароль и секретный API-ключ не требуются.
Установка из ZIP
- Скачайте nakogda-1.0.0-pl.transport.zip и загрузите его в каталог core/packages установленного MODX. Transport-пакет не нужно распаковывать.
- В менеджере MODX откройте управление пакетами и выберите «Поиск локальных пакетов» (Search Locally for Packages).
- Найдите обнаруженный пакет NaKogda и установите его. После завершения откройте «Приложения → NaKogda» (Extras → NaKogda).
Подключение к НаКогда
- Откройте «Приложения → NaKogda» в менеджере MODX.
- Вставьте публичную ссылку записи из раздела «Виджет» кабинета НаКогда или UID организации. Параметр ?widget=UID в ссылке выбирает общий виджет.
- При необходимости включите отдельный переключатель плавающего чата и сохраните настройки.

Размещение формы записи
- Вставьте [[!NaKogdaBooking]] в содержимое ресурса или шаблон, где должна появиться форма записи.
- Для отдельного виджета используйте свойство widget, как в примере ниже. Оно выбирает виджет подключённой организации только для этого вызова сниппета.
- В шаблоне должен быть закрывающий тег </body>, чтобы MODX вставил зарегистрированные скрипты.
- Сохраните ресурс, очистите кэш сайта MODX и откройте публичную страницу. Проверьте нужную форму и плавающий чат, если он включён.
Примеры
Замените ORGANIZATION_UID и WIDGET_UID публичными UID своей организации и её виджета из кабинета НаКогда.
[[!NaKogdaBooking]][[!NaKogdaBooking? &widget=`WIDGET_UID`]]Полезно знать
- В одном подключении используется одна организация. На разных страницах можно показывать разные её виджеты; UID экземпляра формы имеет приоритет перед общими настройками. Пустой UID экземпляра использует общий виджет, а если он не указан — основной виджет организации.
- Плавающий чат не зависит от сниппета записи: он может работать на страницах без формы. В менеджере MODX публичные виджеты не загружаются.
- Для установки и обновления PHP нужна функция link() и права создавать временные файлы, каталоги и жёсткие ссылки в core/components/nakogda/ и assets/components/nakogda/. Файловая система должна поддерживать стабильные ненулевые идентификаторы файлов (inode).
- После изменения ресурса или шаблона очистите кэш сайта. При нестандартном провайдере ресурсного кэша следуйте сообщению менеджера и очистите только кэш этого сайта средствами провайдера; дополнение не очищает общий Redis или Memcached.
- Услуги, расписание, записи и переписка хранятся в НаКогда. При показе формы или чата браузер загружает виджеты с time.nakogda.ru; сервис получает технические данные запроса и сведения, которые посетитель вводит в виджете.

Отключение и удаление
Чтобы отключить запись и чат, очистите поле подключения и сохраните. Для отключения только чата снимите его флажок. Для удаления деинсталлируйте NaKogda в менеджере пакетов и уберите вызовы сниппета из ресурсов и шаблонов. Страницы сайта и данные НаКогда сохраняются.