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

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

Плагин для MODX

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

Версия 1.0.0-pl

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

Требования

MODX Revolution 2.8.9 и новее в ветке 2 или MODX 3; PHP 8.1 и новее с cURL и проверкой HTTPS-сертификатов; MySQL-совместимая база данных. Для установки нужен доступ к управлению пакетами.

Расширение ожидает проверки в официальном каталоге. Сейчас установите его из ZIP по инструкции ниже.

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

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

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

  1. Скачайте nakogda-1.0.0-pl.transport.zip и загрузите его в каталог core/packages установленного MODX. Transport-пакет не нужно распаковывать.
  2. В менеджере MODX откройте управление пакетами и выберите «Поиск локальных пакетов» (Search Locally for Packages).
  3. Найдите обнаруженный пакет NaKogda и установите его. После завершения откройте «Приложения → NaKogda» (Extras → NaKogda).

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

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

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

  1. Вставьте [[!NaKogdaBooking]] в содержимое ресурса или шаблон, где должна появиться форма записи.
  2. Для отдельного виджета используйте свойство widget, как в примере ниже. Оно выбирает виджет подключённой организации только для этого вызова сниппета.
  3. В шаблоне должен быть закрывающий тег </body>, чтобы MODX вставил зарегистрированные скрипты.
  4. Сохраните ресурс, очистите кэш сайта 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; сервис получает технические данные запроса и сведения, которые посетитель вводит в виджете.
Форма записи НаКогда на сайте MODX
Форма записи НаКогда на сайте MODXОткрыть полный снимок

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

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