Общие сведения об обновлениях

All promos, both custom and those from the Plesk team, are shown in a widget on the Home screen. The widget takes the form of a carousel, enabling the user to scroll through the available promos.

A promo can include some or all of the following:

• An icon.
• A header.
• Body text.
• An action button.

We strongly recomment that your custom promos should feature each of those components to make them useful and visually appealing.

Предварительные требования

• To be able to see the promos, both custom ones and those from the Plesk team, the «Promo» widget on the Home screen must be enabled.

Challenges and Limitations

• Since the promos are only shown on the Home screen, they cannot be seen by anyone not using the Service Provider view.
• No more than five promos can be shown in the carousel. Adding a custom promo will replace one from the Plesk team. If you add more than five custom promos, only the first five will be shown.

Adding a Custom Promo

Custom promos can be added by editing the panel.ini configuration file. To add one, declare it in the [promos] section of the file.

To declare a promo, add between one and five parameters with a matching promo name. You can use some or all of the following parameters:

• custom.<promo name>.title - the title of the promo, shown in bold. If this parameter is omitted, the promo will have no title.
• custom.<promo name>.icon - the URL to an image to be used as the promo’s icon. If this parameter is omitted, or the URL is unreachable, a blank white square is shown instead of a logo.
• custom.<promo name>.text - the body text of the promo. If this parameter is omitted, the promo has no text.
• custom.<promo name>.buttonUrl - the URL of the page the user is taken to when they click the promo’s action button. If this parameter is omitted, clicking the button reloads the Plesk Home page.
• custom.<promo name>.buttonText - the text on the promo’s action button. If this parameter is omitted, a square blue button with no text is shown.

Here’s what a custom promo with all five parameters specified may look like.

Here’s how to declare this promo:

[promos]
custom.promo.title = "Visit the Example Domain"
custom.promo.icon = https://198.51.100.1/icons/promo-icon.png
custom.promo.text = "Click the button below to go to https://www.example.com/."
custom.promo.buttonUrl = "https://www.example.com/"
custom.promo.buttonText = "Let's go!"