Hooking into domain processes

You can write standardized hooks for the following API2 function calls:

Api2::AddonDomain::addaddondomain()

Api2::SubDomain::addsubdomain()

Api2::Park::park()


#!/usr/bin/env perl

package YourAddonModule;

use warnings;
use strict;

sub describe {
my $create_addon_hook = {
'category' => 'Cpanel',
'event' => 'Api2::AddonDomain::addaddondomain',
'stage' => 'pre', # or post
'hook' => 'YourAddonModule::your_hook_subroutine',
'exectype' => 'module',
};
return [$create_addon_hook];
}

sub your_addon_hook {
my ( $context, $data ) = @_;
my $args = $data->{'args'};
my ( $dir, $newdomain, $subdomain ) = ( $args->{'dir'}, $args->{'newdomain'}, $args->{'subdomain'} );
print "HOOK TEST : Created $newdomain with dir = $dir and subdomain = $subdomain","\n";
}


Here's a link to more readable version of the code: YourAddonDomain.pm

Save this as: /var/cpanel/perl5/lib/YourAddonModule.pm

(Note that you may have to create that directory with 'mkdir -p /var/cpanel/perl5/lib')

Then you can register the hook with:

'/usr/local/cpanel/bin/manage_hooks add module YourAddonModule.pm'

Subdomain and Parked domain hooks will follow similarly, you may refer to the documentation for further information.