Hooks - Revision history

John: Replaced content with "
Note
This page has moved to [https://developers.whmcs.com/hooks/ https://developers.whmcs.com/hooks/]
"

2017-01-04T10:45:39Z

Replaced content with "<div class="docs-alert-info"> <span class="title">Note</span><br /> This page has moved to [https://developers.whmcs.com/hooks/ https://developers.whmcs.com/hooks/] </div>"

Andrew: DOCS-6356

2016-02-22T13:00:16Z

DOCS-6356

Matt at 10:42, 15 December 2015

2015-12-15T10:42:10Z

Matt at 10:41, 15 December 2015

2015-12-15T10:41:40Z

Matt: /* What is a Hook? */

2015-12-15T10:38:07Z

‎What is a Hook?

Matt: /* Hook Points */

2015-12-15T10:37:47Z

‎Hook Points

Matt: /* The Add Hook Function */

2015-11-13T11:13:03Z

‎The Add Hook Function

Matt: /* Module Hooks */

2015-11-13T11:12:12Z

‎Module Hooks

Matt: /* Sample Code */

2015-11-13T11:11:54Z

‎Sample Code

John at 07:41, 30 July 2015

2015-07-30T07:41:05Z

@@ Line 1: / Line 1: @@
 ==What is a Hook?==
-Action Hooks allow you to add your own code to WHMCS that runs when specific events or actions occur inside the system.  WHMCS has over 100 different hook points that you can tie custom code into, and more are being added with each new release.
+Action Hooks allow you to add your own code to WHMCS. The code will run when specific events or actions occur inside the system. WHMCS has over 100 different hook points. These you can tie custom code into. With each new release, WHMCS adds more hook points.
-The possibilities with hooks are endless, but some common examples of what you might use them for are:
+The possibilities with hooks are many, but some common examples of what you might use them for are:
-*Registering users in another system when they signup via WHMCS
+*Registering users in another system when they signup via WHMCS.
-*Keeping user details in sync with third party applications
+*Keeping user details in sync with third party applications.
-*Performing additional custom actions when an order is placed in WHMCS
+*Performing extra custom actions when placing an order in WHMCS.
-*Sending notifications when certain events occur
+*Sending notifications when certain events occur.
 {{Hook_Categories}}
@@ Line 14: / Line 14: @@
 ==Creating a Hook==
-Hooks work by defining a function, and then tieing that function into a hook point. Most custom hook functions are created as a standalone hook, and thus reside in the /includes/hooks/ folder. But hooks can also be part of modules (more details later on this).
+Hooks work by defining a function, and then tying that function into a hook point. Most custom hook functions are standalone hooks, and thus live in the /includes/hooks/ folder. Hooks can also be part of modules (more details later on this).
-Custom hook functions are usually passed variables when they are called, with the variables depending on the action the hook point relates to. Some hook points will also accept a return from your custom hook function, and that allows you to influence what the system does next from your custom code.
+Custom hook functions have variables passed when called. The variables depend on the action the hook point relates to. Some hook points will also accept a return from the custom hook function. Returns will allow influence with what the system does next from the custom code.
-We recommend naming hook functions always starting with "hook_", followed by the filename, and then the particular action or task that hook is performing.  For example "hook_filename_action" - "hook_forumsetup_addclient".  This helps to ensure that no 2 hook functions from 2 separate developers ever conflict due to naming issues.
+WHMCS recommends naming hook functions always starting with "hook_". Following this, the filename. Finally the particular action or task that hook is performing. For example "hook_filename_action" - "hook_forumsetup_addclient". This will ensure that no hook functions ever conflict due to naming issues.
 ==Sample Code==
-The best way to see how hooks work is with an example, so here's an example using the [[Hooks:ClientAdd|Client Signup hook]] event that could be used to create an account on an external system such as a forum:
+The best way to see how hooks work is with an example. Below is an example using the [[Hooks:ClientAdd|Client Signup hook]] event. A developer could use this event to create an account on an external system such as a forum:
 <syntaxhighlight lang="php">
@@ Line 50: / Line 50: @@
 ==Module Hooks==
-Modules support hooks being defined that relate to a module within the relevant module directory; /modules/addons/ for addon, /modules/servers/ for provisioning and /modules/registrars for registrar modules.
+Modules support hooks that relate to a module within the relevant module directory. This is /modules/addons/ for addon, /modules/servers/ for provisioning and /modules/registrars/ for registrar modules.
-To define hooks as part of a module, simple create a file named "hooks.php" within the module folder, and include all module specific hook related code within that file.
+To define hooks as part of a module, simple create a file named "hooks.php" within the module folder. A developer can then include all module specific hook related code within that file.
-''Note to Developers:'' Hook files in module folders are only called for active modules. And active modules that contain hooks are cached. So if you add a hooks file to a module retrospectively, once the module is already active, then before the system will detect and start running that module, you must edit and resave either the addon module configuration, product configuration or domain registrar configuration for the respective module for it to be detected.
+''Note to Developers'': Hook files in module folders are only called for active modules. And active modules that contain hooks become cached. If a developer add a hooks file to a module after activation, the cache must refresh. To refresh the cache, edit and re-save either the appropriate module configuration.
 ==Hook Points==
-We've divided the hooks up into categories to help make the list more managable. So simply choose an option from below to see the hooks which exist for that category.
+We've divided the hooks up into categories to help make the list more manageable. So choose an option from below to see the hooks which exist for that category.
 {{Hook_Categories}}

← Older revision		Revision as of 10:42, 15 December 2015
Line 63:		Line 63:

	{{Developer_Links}}		{{Developer_Links}}
		+
		+	__NOTOC__

@@ Line 25: / Line 25: @@
 <syntaxhighlight lang="php">
 add_hook('ClientAdd', 1, function ($vars)
+{
@@ Line 37: / Line 46: @@
 </syntaxhighlight >
-==The Add Hook Function==
+<div class="docs-alert-info">Anonymous functions, also known as closures, are supported for the function to be called as demonstrated in the example above.</div>
 ==Module Hooks==

← Older revision		Revision as of 10:38, 15 December 2015
Line 11:		Line 11:

	{{Hook_Categories}}		{{Hook_Categories}}
−
−	~~There is also an [[Hooks:Index\|index of hooks]] available.~~

	==Creating a Hook==		==Creating a Hook==

← Older revision		Revision as of 10:37, 15 December 2015
Line 62:		Line 62:

	{{Hook_Categories}}		{{Hook_Categories}}
−
−	~~There is also an [[Hooks:Index\|index of hooks]] available.~~

	{{Developer_Links}}		{{Developer_Links}}

@@ Line 45: / Line 45: @@
 *The first part defines the hook point.  This must be one of the hook points WHMCS has implemented (listed in the pages below)
 *The number defines the priority of the hook, so for example if you have more than 1 hook for the ClientAdd function, the order in which the hooks should run
-*The third argument tells WHMCS which function to call from this hook point and so this is where you put the name of the custom hook file you create
+*The third argument tells WHMCS which function name to call from this hook point. Anonymous functions, also known as closures, are also supported as demonstrated in the example above.
 A commented out example hook file is included in WHMCS which you can use as a template. You'll find that in the folder /includes/hooks/

← Older revision		Revision as of 11:12, 13 November 2015
Line 52:		Line 52:

	Modules support hooks being defined that relate to a module within the relevant module directory; /modules/addons/ for addon, /modules/servers/ for provisioning and /modules/registrars for registrar modules.		Modules support hooks being defined that relate to a module within the relevant module directory; /modules/addons/ for addon, /modules/servers/ for provisioning and /modules/registrars for registrar modules.
−

	To define hooks as part of a module, simple create a file named "hooks.php" within the module folder, and include all module specific hook related code within that file.		To define hooks as part of a module, simple create a file named "hooks.php" within the module folder, and include all module specific hook related code within that file.

@@ Line 24: / Line 24: @@
 ==Sample Code==
-The best way to see how a hook works is with an example. So here's a sample hook function integrated into the Client Signup hook event:
+The best way to see how hooks work is with an example, so here's an example using the [[Hooks:ClientAdd|Client Signup hook]] event that could be used to create an account on an external system such as a forum:
 <syntaxhighlight lang="php">
-function hook_create_forum_account($vars)
+add_hook('ClientAdd', 1, function ($vars)
+{
      $firstname = $vars['firstname'];
      $lastname = $vars['lastname'];
      $email = $vars['email'];
-     # Run code to create remote forum account here...
+     // Run code to create remote forum account here...
 });
 </syntaxhighlight >

@@ Line 12: / Line 12: @@
 {{Hook_Categories}}
-There is also an [[Hooks:Alphabetical|alphabetical list]] of hooks available
+There is also an [[Hooks:Index|index of hooks]] available.
 ==Creating a Hook==
@@ Line 51: / Line 51: @@
 ==Module Hooks==
-As of WHMCS V4.4, addon modules support hooks being defined that relate to a module within the module directory in /modules/addons/
+Modules support hooks being defined that relate to a module within the relevant module directory; /modules/addons/ for addon, /modules/servers/ for provisioning and /modules/registrars for registrar modules.
 To define hooks as part of a module, simple create a file named "hooks.php" within the module folder, and include all module specific hook related code within that file.
@@ Line 65: / Line 64: @@
 {{Hook_Categories}}
-There is also an [[Hooks:Alphabetical|alphabetical list]] of hooks available
+There is also an [[Hooks:Index|index of hooks]] available.
 {{Developer_Links}}