ispmanager 6: Functions

/
/
Setting up banner ads on the panel dashboard

Setting up banner ads on the panel dashboard

A banner link can be disabled or modified by changing or adding the DashboardBannerUrl parameter in the configuration file /usr/local/mgr5/etc/ispmgr.conf:

  • If the parameter value is left empty, the banner will be disabled;
  • When a direct link to a banner is specified, the standard ispmanager banner will be replaced with a custom one.

For example:

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

A file with banner content can be in any format supported by the HTML markup language, such as html, jpg, gif, svg, etc.

 

If different language locales require use of different banners, the __lang__ placeholder can be used to create variants. For example:

DashboardBannerUrl https://example.com/banner/__lang__.html

In this case, it is necessary to submit multiple versions of the banner with names corresponding to languages. 

For example:

  • DashboardBannerUrl https://example.com/banner/en.html - for a banner in English;
  • DashboardBannerUrl https://example.com/banner/fr.html - for a banner in French;
  • DashboardBannerUrl https://example.com/banner/ru.html - for a banner in Russian.

The banner will be updated after refreshing the page.

You can also add the following parameters to the URL of the banner to modify it:

  • lictype - license type:
    • user - purchased directly from ispmanager;
    • partner - purchased through reselling.
  • price - tariff name:
    • trial;
    • lite;
    • pro;
    • host;
    • business;
  • userlang - user language for notifications:
    • ru;
    • en;
    • etc.
  • os - OS name, for example, Ubuntu 22.04.2;
  • ispmgrversion - ispmanager version, for example, 6.104.0;
  • licstatus - license status:
    • nolicense - no license;
    • trial - trial license;
    • trialexpired - trial license expired;
    • commercial - commercial license;
    • reloadexpired - license data hasn't been updated in a long time;
    • expired - license expired.

 

For example, for a particular banner to be displayed only on a server running CentOS 7.9 in a 6.99.0 version panel that is currently on a trial license, the URL should look like this:

https://example.com/banner/ru.html?mgrurl=https://<panel-ip-address>:1500/ispmgr&price=trial&os=CentOS%207%2E9&ispmgrversion=6%2E99%2E0&licstatus=trial