概要

Plesk では、プロモとはホーム画面に表示されるバナーです。Plesk チームが提供するプロモは、Plesk 管理者が追加またはインストールできるさまざまな機能や拡張を紹介するものです。さらに、管理者はカスタムプロモも追加できます。

このトピックでは、カスタムプロモを追加する方法を学習します。

概要

すべてのプロモ (カスタムプロモと Plesk チーム提供のプロモの両方) が、ホーム画面のウィジェットに表示されます。このウィジェットはカルーセル形式で、ユーザーは利用可能なプロモーションをスクロールして閲覧できます。

image promo

プロモには、以下の一部またはすべてを含めることができます。

  • アイコン

  • ヘッダ

  • 本文

  • アクションボタン

カスタムプロモを便利で視覚的に魅力的なものにするために、これらの各コンポーネントを組み込むことを強くお勧めします。

前提条件

課題と制約事項

  • プロモはホーム画面にのみ表示されるため、サービスプロバイダビューを使用していないユーザーは見ることができません。

  • カルーセルには最大 5 つのプロモを表示できます。カスタムプロモを 1 つ追加すると、Plesk チーム提供のプロモ 1 つと置き換えられます。カスタムプロモを 5 つ以上追加した場合、最初の 5 つだけが表示されます。

カスタムプロモを追加する

カスタムプロモは、 panel.ini 構成ファイルを編集 することで追加できます。追加するには、ファイルの [promos] セクションで宣言してください。

プロモを宣言するには、プロモ名が一致するパラメータを 1～5 個追加します。以下のパラメータの一部またはすべてを使用できます。

  • custom.<promo name>.title - プロモのタイトル (太字で表示)。このパラメータを省略した場合、プロモにタイトルが付きません。

  • custom.<promo name>.icon - プロモアイコンとして使用する画像の URL。このパラメータを省略した場合や、URL にアクセスできない場合は、ロゴの代わりに空の白い四角形が表示されます。

  • custom.<promo name>.text - プロモの本文。このパラメータを省略した場合、プロモにテキストが表示されません。

  • custom.<promo name>.buttonUrl - ユーザーがプロモのアクションボタンをクリックしたときに表示されるページの URL。このパラメータを省略した場合、ボタンをクリックすると Plesk ホームページが再読み込みされます。

  • custom.<promo name>.buttonText - プロモのアクションボタンに表示されるテキスト。このパラメータを省略した場合、テキストのない青い四角いボタンが表示されます。

5 つのパラメータをすべて指定したカスタムプロモは次のようになります。

image promo anatomy

このプロモを宣言する方法は次のとおりです。

[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!"