Guide to WHM Plugins

Guide to WHM Plugins

Introduction

WHM plugins add new functionality to the WHM interface.

cPanel plugin requirements and WHM plugin requirements are not identical. For information about cPanel plugins, read our Guide to cPanel Plugins documentation.
For help to troubleshoot issues with WHM plugin development, read our Guide to Testing Custom Code documentation.

Important:

cPanel & WHM versions 64 and 66 included major updates to the WHM interface that affect most WHM plugins. If you developed your plugin for cPanel & WHM version 62 or earlier, you must update it.

Plugin development workflow

Note:

For additional information, read our Create a WHM Plugin tutorial.

When you create a WHM plugin, we recommend the following workflow:

Create your custom application (the plugin's backend code).
Create the plugin's interfaces and other files.
Create an installation script.
Important:

This script should register your plugin with AppConfig and perform several other actions.
Create your plugin's AppConfig configuration file.
Compress your plugin's files for distribution.
- We recommend that you compress your plugin's files into a tarball (.tar.gz) file for ease of distribution.
- For most plugins, the compressed file should contain the application source files, the AppConfig configuration file, an upgrade script, and an installation script.
Distribute your plugin. When you distribute this plugin across multiple servers, system administrators must perform the following actions manually:
- Decompress the plugin's .tar.gz file.
- Run the installation script.

WHM Plugins

About WHM Plugins

WHM plugins add custom features to the WHM interface.
In WHM 11.38.1+, you must use the AppConfig system to register plugins.

Compatible with:

WHM 11.32+

Child pages

Introduction

Plugin development workflow

WHM Plugins

Related Documentation