Standardized Hooks trigger applications when cPanel & WHM performs an action. Use this system to execute custom code (hook action code) to customize how cPanel & WHM functions in specific scenarios (hookable events). For example, you could use this system to make certain that a script runs each time that a user creates an account.
For a step-by-step tutorial to create and register a hook, read our Tutorial - Create a Standardized Hook documentation.
Each standardized hook is comprised of a hookable event, a hook action, and hook registration.
Select a hookable event. — Hookable events set the action that triggers a hook, and whether the hook triggers before or after the event.
Write your custom hook action code.
Register the hook. — Use the /usr/local/cpanel/bin/manage_hooks Command Line Interface (CLI) utility to connect (register) the hook action code with the event.
The system includes a hooks registry for each hookable event. This allows hooks from your application to coexist with another application's hooks that reference the same event.
cPanel & WHM provides the /usr/local/cpanel/bin/manage_hooks CLI utility to manage standardized hooks.
Standardized Hooks System data resides in the /var/cpanel/hooks.yaml file. This database is the authoritative reference for all standardized hook data. The Standardized Hooks System also maintains a cached copy of this database in the /var/cpanel/hooks.cache file. The cache file regenerates automatically whenever you query the Standardized Hooks System is queried internally or through a management utility.
Do not edit this file by hand. Instead, manage Standardized Hooks with the /usr/local/cpanel/bin/manage_hooks utility.
We encourage anyone who develops for cPanel products to read the cPanel Blog and join our Plugin Developers mailing list.