Notes:
- You must log in as the
rootuser in order to use this interface. - To create a plugin installation file for the cPanel interface's x3 theme, use WHM's x3 Plugin File Generator interface (Home >> Development >> x3 Plugin File Generator).
- For more information, read our Guide to cPanel Plugins documentation.
This interface generates a plugin installation file for the cPanel interface's Paper Lantern theme. The installation file automates the plugin installation process and stores the desired configuration for the plugin.
In the cPanel interface, items function as links to particular interfaces (for example, Email Accounts or File Manager). Each item must reside in a group (for example, Files or Databases).
Generate a plugin file
Important:
This interface does not validate the input in the Name and URI text boxes. Make certain that anything that you enter has no adverse effects on your server.
To generate a plugin installation file, perform the following steps:
- Enter the plugin's identifier in the Unique Identifier text box.
- If the Unique Identifier that you enter already exists, a warning message will appear. Only select the Overwrite existing cPanel item checkbox if you wish to overwrite the existing plugin. To keep the existing plugin, you must enter a different Unique Identifier value.
-
Enter the display name in the Name text box.
- Select the group in which the plugin icon will appear from the Group menu. Enter a number between
1and99in the Priority text box. A plugin icon with a priority of1appears higher than an icon with a priority of99.- To create a new group, click the add icon (
). Enter the new group name in the New Group Name text box.
- To create a new group, click the add icon (
- Enter the plugin location in the URI text box.
-
Click Browse to select an icon file for the plugin.
Notes:
- Icon files must use the PNG format.
- Paper Lantern icons must be 48x48 pixels. This interface does not resize icon files. As a result, larger images may render incorrectly.
- Click Add item to add your new item to the New Plugin Information section of the interface.
-
Repeat steps 1 through 7 for all of the items that you wish to include in the plugin installation file.
-
Enter the plugin's name in the New Plugin Information text box and click Generate to generate the new plugin installation file.
Notes:
- The plugin name can only contain lowercase letters, numbers, hyphens (
-), and underscores (_). - New plugins cannot use the same name as an existing plugin on the server.
- The plugin name can only contain lowercase letters, numbers, hyphens (
-
You can download the new plugin installation file from the banner that appears at the top of the interface. This banner will disappear when you start to create a new plugin or navigate away from the interface.
Note:
The system saves generated plugin installation files in the
/var/cpanel/cpanel_plugin_generator/directory.
Important:
After you download the plugin installation file, use the /scripts/install_plugin script to install the plugin to the Paper Lantern theme. For more information, read our Guide to cPanel Plugins documentation.
