Внимание: В бесплатном тарифном плане 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.

Войдите в свой аккаунт сервиса Dashamail, нажмите на иконку профиля и перейдите в раздел «Интеграции». Скопируйте API ключ и вставьте его в настройки модуля на сайте. Нажмите кнопку «Сохранить».

Если API подключено к аккаунту и API ключ верный – вы увидите дополнительную информацию о Вашем аккаунте: лимит подписчиков, лимит писем, дату окончания подписки.

В поле «Адресная база» появится выпадающий список адресных баз Вашего аккаунта с количеством активных подписчиков и общим количеством для каждой адресной базы.

В правом верхнем углу есть кнопка «Подсказки», которая включает отображение подсказок для каждого поля настроек.

Адресная база – в эту базу будут заносится подписчики.

Показывать поле «Имя» в форме подписки? - Если да, будет показано поле «Имя» в форме подписки. Если пользователь вошёл на сайт - туда автоматически подставится имя авторизованного пользователя.

Показывать поле пол (мужской, женский) в форме подписки? - Если да, будет показано поле выбора пола в форме подписки.

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

Укажите состояние «Опубликовано». В табе «Привязка к пунктам меню» выберите условия показа модуля на страницах сайта. Как правило, это «на каждой странице»

Так будет выглядеть модуль на стандартном шаблоне Joomla 4 и Joomla 5 – Cassiopeia

Введите имя и email для подписки. Будет показано сообщение о статусе подписки.

Если пользователь повторно попытается подписаться, то ему будет показано сообщение сервиса

Если Ваш пользователь авторизован на сайте, его данные автоматически будут подставлены в форму

Если Вам необходимо изменить внешний вид формы подписки – Вы можете создать свой собственный макет вывода модуля. Есть несколько вариантов:

Первый вариант. Он называется «переопределение макетов 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-файлах Вы можете настроить правила для отображения этих сообщений.