User Home Page

The PLACE_ADMIN_HOME and PLACE_RESELLER_HOME custom buttons are placed on the Administrator’s and the Reseller’s home pages, in the section Custom Buttons.

PLACE_CUSTOMER_HOME is placed on Websites & Domains pages, in the right sidebar, and is visible to all users.

Navigation Menu

PLACE_ADMIN_NAVIGATION and PLACE_RESELLER_NAVIGATION place custom buttons in the Navigation Menu for the Administrator and the Reseller correspondingly.

PLACE_HEADER_NAVIGATION custom button appears in the header, following the user name.

By default, the buttons are placed in the Links to Additional Services section of the menu. The section parameter with the following values allows to place custom buttons in different sections of the menu:

• SECTION_NAV_GENERAL - the top section
• SECTION_NAV_HOSTING - Hosting Services section
• SECTION_NAV_PROFILE - My Profile section
• SECTION_NAV_ADDITIONAL - Links to Additional Services section
• SECTION_NAV_SERVER_MANAGEMENT - Server Management section

The order parameter can be used to specify the position of the custom button in the list within a section (“1” for the first position in the list and so on). If left unspecified, the custom button will be added to the end of the section.

Tools & Settings Page

PLACE_ADMIN_TOOLS_AND_SETTINGS and PLACE_RESELLER_TOOLS_AND_SETTINGS are used to add custom buttons to the Tools & Settings page for the Administrator and to the Tools & Utilities page for the Reseller.

By default, the buttons are placed in the Additional Services section of either page. The section parameter allows to specify the section. For the Administrator:

• SECTION_ADMIN_TOOLS_MAIL - Mail section
• SECTION_ADMIN_TOOLS_PLESK - Plesk section
• SECTION_ADMIN_TOOLS_GENERAL - General Settings section
• SECTION_ADMIN_TOOLS_SECURITY - Security section
• SECTION_ADMIN_TOOLS_APPEARANCE - Plesk Appearance section
• SECTION_ADMIN_TOOLS_STATISTICS - Statistics section
• SECTION_ADMIN_TOOLS_APPS_AND_DBS - Applications & Databases section
• SECTION_ADMIN_TOOLS_EXTERNAL_SERVICES - External Services section
• SECTION_ADMIN_TOOLS_SERVER_MANAGEMENT - Server Management section
• SECTION_ADMIN_TOOLS_ADDITIONAL_SERVICES - Additional Services section
• SECTION_ADMIN_TOOLS_TOOLS_AND_RESOURCES - Tools & Resources section
• SECTION_ADMIN_TOOLS_TROUBLESHOOTING_BUTTONS - Assistance and Troubleshooting section

For the Reseller:

• SECTION_RESELLER_TOOLS_SERVICES - Services section
• SECTION_RESELLER_TOOLS_RESOURCES - Resources section
• SECTION_RESELLER_TOOLS_PLESK_MANAGEMENT - Plesk Management section
• SECTION_RESELLER_TOOLS_ADDITIONAL_SERVICES - Additional Services section

The order parameter can be used to specify the position of the custom button in the list within a section (“1” for the first position in the list and so on). If left unspecified, the custom button will be added to the end of the section.

Right Sidebar

• PLACE_DOMAIN - the top section
• PLACE_CUSTOMER_HOME - Additional Services section

Other Locations

• PLACE_COMMON - appears in several locations simultaneously: the Links to Additional Services section in the Navigation Menu, the top section and the Additional Services section in the right sidebar.
• PLACE_HOSTING_PANEL_TABS - appears as an additional tab on the subscription page, also appears as one of the items in the Navigation Menu in the Customer interface.

• PLACE_TOOLBAR - adds a new button above all lists.
• PLACE_DOMAIN_PROPERTIES - appears as an additional button on the Webspaces & Domains tab (in Active View mode). Parameter additionalComments provides additional information clarifying the purpose of the button. Can be either single-line (string) or multi-line (array).
• PLACE_LIST_ACTIONS - appears as an additional button on other lists with Active View mode available.
• PLACE_HOSTING_PANEL_NAVIGATION - appears as an additional item in the Navigation Menu in the Administrator’s interface in Power User mode.

Parameters

Example

The following examples shows how to add several custom buttons. The used method:

• getButtons()

Use the following code:

class Modules_CustomButtons_CustomButtons extends pm_Hook_CustomButtons
{

    public function getButtons()
    {
        return [[
            'place' => self::PLACE_DOMAIN,
            'title' => 'Domain Button',
            'description' => 'Description for domain button',
            'icon' => pm_Context::getBaseUrl() . 'images/icon.png',
            'link' => pm_Context::getBaseUrl() . 'index.php/index/index',
        ], [
            'place' => [
                self::PLACE_HOSTING_PANEL_NAVIGATION,
                self::PLACE_ADMIN_TOOLS_AND_SETTINGS,
                self::PLACE_RESELLER_TOOLS_AND_SETTINGS,
            ],
            'title' => 'Multi Place Button',
            'description' => 'Description for multi place button',
            'link' => 'https://plesk.com/',
            'newWindow' => true,
        ]];
    }

}

class Modules_CustomButtons_CustomButtons extends pm_Hook_CustomButtons
{
    public function getButtons()
    {
        return [[
            'place' => self::PLACE_ADMIN_TOOLS_AND_SETTINGS,
            'section' => 'toolsAndResourcesButtons',
            'order' => 1,
            'title' => 'My Button 1',
            'description' => 'Description for my button 1',
            'link' => pm_Context::getActionUrl('index', 'another'),
        ], [
            'place' => self::PLACE_ADMIN_TOOLS_AND_SETTINGS,
            'section' => 'generalButtons',
            'order' => 4,
            'title' => 'My Button 2',
            'description' => 'Description for my button 2',
            'link' => pm_Context::getActionUrl('index', 'another'),
        ]];
    }
}

Remarks

The important aspects of implementing custom buttons that should be paid attention to are their appropriate placement and decoration.