Настройка рекламного баннера дашборда панели

Отключить или изменить ссылку на баннер можно изменив или добавив параметр DashboardBannerUrl в конфигурационном файле панели по пути /usr/local/mgr5/etc/ispmgr.conf:

Если оставить значение параметра пустым, баннер будет отключен;
При указании прямой ссылки на баннер, стандартный баннер от ispmanager будет изменен на собственный.

Например:

DashboardBannerUrl https://domain.com/banner/banner.html

Файл с содержимым баннера может быть в любом формате, поддерживаемом языком разметки HTML, например html, jpg, gif, svg и так далее.

Баннер изменится после обновления страницы.

В URL баннера можно добавить следующие макросы , которые являются условиями для его отображения:

__mgrurl__ - адрес панели.
__nlictype__ - тип лицензии:
- user - приобретена напрямую в ispmanager;
- partner - приобретена через перепродажу.
__account__ - ID аккаунта (для партнерских лицензий).
__price__ - название тарифа:
- trial;
- lite;
- pro;
- host;
- business;
__userlang__ - язык пользователя для уведомлений:
- ru;
- en;
- и так далее.
__os__ - наименование операционной системы, например, Ubuntu 22.04.2;
__ispmgrversion__ - версия ispmanager, например, 6.140.0;
__licstatus__ - статус лицензии:
- nolicense - лицензия отсутствует;
- trial - триальная лицензия;
- trialexpired - срок триальной лицензия истек;
- commercial - коммерческая лицензия;
- reloadexpired - данные лицензии давно не обновлялись;
- expired - срок лицензии истек.

Также в URL любого баннера передаются следующие параметры:

theme - тип темы:
- light - светлая;
- dark - темная.
- token - токен для передачи высоты баннера панели для адаптирования блока iframe под нужную высоту; для получения токена и отправки высоты баннера в теле баннера можно воспользоваться следующим js-скриптом:
```
const params = new URLSearchParams(window.location.search);
window.parent.postMessage({
bannerHeight: 200, // Высота баннера
token: params.get('token'),
}, '*');
```
new design - метка использования темы Феникс: будет передано значение 1, если тема используется.

Макросы передают информацию об окружении пользователя, создавая уникальную ссылку. Макросы можно указывать в любом месте ссылки, тем самым указывая путь до конкретных баннеров или передавая значения через переменные.

Например, если требуется передать информацию через переменные о типе лицензии, языке и ОС, ссылка будет иметь следующий формат:

https://domain.com/banner/banner.html?nlictype=__nlictype__&userlang=__userlang__&os=__os__

Имя переменной может быть произвольным, например можно передать макрос __os__ в переменной osinfo :

https://domain.com/banner/banner.html?osinfo=__os__

Ссылка формата https://domain.com/banner/__userlang__.html будет указывать на баннеры в соответствии с кодом языка:

https://domain.com/banner/ru.html
https://domain.com/banner/en.html
и так далее.

Таким же образом можно указывать более сложные пути до баннеров, например:

https://domain.com/banners/__userlang__/__licstatus__.html

Методы можно использовать вместе, передавая данные для нескольких отдельных баннеров, например:

https://domain.com/banners/__userlang__/__licstatus__.html?os=__os__&nlictype=__nlictype__

ispmanager 6: Функции

Настройка рекламного баннера дашборда панели