Внимание: В бесплатном тарифном плане API по умолчанию отключен. Для работы модуля попросите нашу техподдержку открыть его на вашем аккаунте.
Модуль отображает форму подписки для пользователей сайта. Данные о подписчике передаются в сервис e-mail маркетинга Dashamail.
Установка модуля
Зайдите в панель администратора сайта на CMS Joomla. Для этого к домену сайта в адресной строке браузера добавьте слово «administrator», чтобы получился адрес вида https://site.ru/administrator и нажмите клавишу enter. Откроется форма входа в панель администратора.
Введите свой логин и пароль пользователя с правами Super User и войдите в панель управления сайтом.
Установка расширений CMS Joomla происходит в разделе «Система». Его можно найти в левом меню. Далее в блоке «Установка» выбираем пункт «Расширения».
Установщик расширений Joomla предлагает несколько вариантов установки. Можно указать локальный файл на своём компьютере (перетащить его мышкой в браузер), установить из каталога на сервере (предварительно закачать файл в этот каталог), указать ссылку на файл.
После успешной установки Вам будет отображено сообщение.
Настройка модуля
Для настройки модуля необходимо перейти в раздел «Система» - блок «Управление» - «Модули сайта». Или же в левом меню выбрать «Контент» - «Модули сайта»
В менеджере модулей Вы увидите список всех созданных модулей. Среди них может быть модуль с названием «Dashamail form».
Если такого модуля в списке нет, то нажмите кнопку «Создать» в верхней панели и выберите тип модуля «Dashamail form»
После у Вас откроются настройки модуля. В случае, если Вы создаете новый модуль – будет показано информационное сообщение «There is no module id specified. May be you are creating a new module now».
Если Вы начнёте редактировать уже существующий модуль – информационное сообщение будет другим: «There is no api key specified in module id [MODULE ID]»
Получение API ключа сервиса Dashamail
Для подключения API к Вашему аккаунту Вам необходимо обратиться в техническую поддержку сервиса Dashamail.
Войдите в свой аккаунт сервиса Dashamail, нажмите на иконку профиля и перейдите в раздел «Интеграции». Скопируйте API ключ и вставьте его в настройки модуля на сайте. Нажмите кнопку «Сохранить».
Если API подключено к аккаунту и API ключ верный – вы увидите дополнительную информацию о Вашем аккаунте: лимит подписчиков, лимит писем, дату окончания подписки.
В поле «Адресная база» появится выпадающий список адресных баз Вашего аккаунта с количеством активных подписчиков и общим количеством для каждой адресной базы.
В правом верхнем углу есть кнопка «Подсказки», которая включает отображение подсказок для каждого поля настроек.
Параметры модуля
Адресная база – в эту базу будут заносится подписчики.
Показывать поле «Имя» в форме подписки? - Если да, будет показано поле «Имя» в форме подписки. Если пользователь вошёл на сайт - туда автоматически подставится имя авторизованного пользователя.
Показывать поле пол (мужской, женский) в форме подписки? - Если да, будет показано поле выбора пола в форме подписки.
Чтобы модуль отображался на сайте, укажите позицию в шаблоне Вашего сайта, где будет выводиться модуль.
Укажите состояние «Опубликовано». В табе «Привязка к пунктам меню» выберите условия показа модуля на страницах сайта. Как правило, это «на каждой странице»
Так будет выглядеть модуль на стандартном шаблоне Joomla 4 и Joomla 5 – Cassiopeia
Введите имя и email для подписки. Будет показано сообщение о статусе подписки.
Если пользователь повторно попытается подписаться, то ему будет показано сообщение сервиса
Если Ваш пользователь авторизован на сайте, его данные автоматически будут подставлены в форму
Изменение внешнего вида модуля (HTML-вёрстка)
Если Вам необходимо изменить внешний вид формы подписки – Вы можете создать свой собственный макет вывода модуля. Есть несколько вариантов:
Первый вариант. Он называется «переопределение макетов Joomla». В интернете много информации по этой теме.
Второй вариант. Макет вывода модуля находится в папке modules/mod_dashamailform/tmpl, файл default.php. Чтобы создать свой макет вывода и не потерять изменения файла при обновлении модуля, нужно скопировать, переименовать штатный файл и положить рядом со стандартным макетом.
Например, мы копируем файл modules/mod_dashamailform/tmpl/default.php, делаем необходимые изменения, внедряем HTML-вёрстку, переименовываем его, например в default2.php и закачиваем обратно. Тогда в настройках модуля, в табе «Дополнительные параметры» в параметре «Макет» появится Ваш макет вывода.
Такой способ внедрения собственной HTML-вёрстки (или же использование механизма переопределения макетов Joomla) позволит не потерять свои изменения файлов при обновлении модуля.
Кастомизация сообщения сервиса
В макете модуля под формой находится div-контейнер с id «mod_dashamail-[тут id модуля]-status» (например, «mod_dashamail-142-status»). Вы можете добавлять любые собственные CSS-классы к этому контейнеру.
В случае если сервис возвращает сообщение об успешной подписке, к контейнеру добавляется CSS-класс «success».
В случае, если сервис возвращает сообщение об ошибке, к контейнеру добавляется CSS-класс «error».
В своих CSS-файлах Вы можете настроить правила для отображения этих сообщений.
Видеоинструкция по установке модуля