Overview

The instructions on the “Mail Client Setup” page cover a number of popular mail clients, and also advise how to use autodiscover. However, if there is a need to add specific instructions particular to your installation, add links to your own help resources, and so on, the content of the page can be customized by creating and editing a copy of a template file.

Challenges and Limitations

Customizing the “Mail Client Setup” page comes with the following challenges and limitations:

• Customizing the content of the page requires the use of the Markdown markup language. There is no WYSIWIG editor in Plesk for editing the page.
• It also removes the tabs found on the page by default. There is no ability to add tabs to the page using Markdown.

Customizing the Page

To customize the “Mail Client Setup” page:

1. Log in to the Plesk server via SSH or RDP.

2. Run the following command to create a copy of the template file:

   • (Plesk for Linux) cp /usr/local/psa/admin/conf/email_client_configuration_instructions.md{.sample,}
   • (Plesk for Windows) cd "%plesk_dir%\admin\conf" && copy email_client_configuration_instructions.md.sample email_client_configuration_instructions.md

   This will create the email_client_configuration_instructions.md file you will need to edit. Editing the template file (email_client_configuration_instructions.md.sample) will not result in any changes.

3. Edit the created email_client_configuration_instructions.md file using the text editor of your choice. Make sure to follow the Markdown syntax.

Once you have created the email_client_configuration_instructions.md file, the default “Mail Client Setup” page will be replaced by the placeholder page defined by the content of the file. Changes you make to the file will take effect immediately.

To revert to the default “Mail Client Setup” page, rename or remove the email_client_configuration_instructions.md file.

Hiding the Setup Wizard Link

If you do not want users to be able to copy the setup wizard link on the “Mail Client Setup” page, the link can be hidden.

To hide the setup wizard link:

1. Start editing the panel.ini file, found here:

   • (Plesk for Linux) /usr/local/psa/admin/conf/panel.ini
   • (Plesk for Windows) %plesk_dir%admin\conf\panel.ini

   You can also edit the file in the Plesk interface using the Panel.ini Editor extension.

2. Add the following lines to the panel.ini file, and then save it:

   [mail]
   showClientConfiguratorLink = false
   

The setup wizard link will no longer appear on the “Mail Client Setup” page.