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

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

Плагин для Joomla

Пакет с системным плагином для подключения сервиса и модулем записи для позиций шаблона и выбранных страниц.

Версия 1.0.0

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

Требования

Joomla 5.4 и новее в ветке 5 или Joomla 6, PHP 8.1 и новее с учётом более высоких требований вашей версии Joomla. Для установки нужен доступ к управлению расширениями.

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

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

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

  1. Откройте карточку «NaKogda booking and chat» в официальном каталоге Joomla Extensions Directory.
  2. Скачайте выпуск 1.0.0 кнопкой «Скачать ZIP» на этой странице. В админке Joomla откройте «Система → Установка → Расширения» и загрузите пакет без распаковки. Затем настройте подключение по инструкции ниже.

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

  1. Скачайте pkg_nakogda-1.0.0.zip. В админке откройте «Система → Установка → Расширения» и загрузите ZIP на вкладке загрузки пакета без распаковки.
  2. Дождитесь завершения установки пакета. Он устанавливает системный плагин «Система — НаКогда» и модуль «Запись НаКогда».

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

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

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

  1. Откройте «Материалы → Модули сайта» и модуль «Запись НаКогда». Для ещё одной формы создайте отдельный экземпляр этого модуля.
  2. Выберите позицию шаблона, назначьте пункты меню и опубликуйте модуль. В Cassiopeia можно использовать позицию main-bottom.
  3. Поле «UID виджета» можно оставить пустым для общего виджета. Для другой формы задайте UID виджета этой же организации в нужном экземпляре модуля и назначьте ему страницы.
  4. Откройте опубликованную страницу как посетитель. Убедитесь, что модуль находится в выбранной позиции, а форма показывает нужные услуги и время.
Размещение формы записи в Joomla
Размещение формы записи в JoomlaОткрыть полный снимок

Примеры

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

Пример публичной ссылки записи
https://time.nakogda.ru/ORGANIZATION_UID/
Выбор виджета в ссылке подключения
https://time.nakogda.ru/ORGANIZATION_UID/?widget=WIDGET_UID

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

  • В одном подключении используется одна организация. На разных страницах можно показывать разные её виджеты; UID экземпляра формы имеет приоритет перед общими настройками. Пустой UID экземпляра использует общий виджет, а если он не указан — основной виджет организации.
  • Чат включается в системном плагине и доступен на публичных страницах даже без опубликованного модуля записи.
  • Обновления устанавливаются через «Система → Обновление → Расширения» или загрузку нового ZIP. Если установлен ранний пакет 0.1.0, один раз установите 1.0.0 поверх него, чтобы подключить канал обновлений; настройки и модули сохраняются.
  • При включённом прогрессивном кэше или кэшировании страниц после изменения, отключения или удаления очистите группы com_modules и page в разделе «Система → Очистить кэш».
  • Услуги, расписание, записи и переписка хранятся в НаКогда. При показе формы или чата браузер загружает виджеты с time.nakogda.ru; сервис получает технические данные запроса и сведения, которые посетитель вводит в виджете.

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

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