*
* This function is meant to be called by modules on each page load as it works after loadHooks has been called.
*
- * @param type $hook
- * @param type $file
- * @param type $function
+ * @param string $hook
+ * @param string $file
+ * @param string $function
*/
public static function add($hook, $file, $function)
{
* @param string $function the name of the function that the hook will call
* @param int $priority A priority (defaults to 0)
* @return mixed|bool
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function register($hook, $file, $function, $priority = 0)
{
* @param string $file the name of the file that hooks into
* @param string $function the name of the function that the hook called
* @return boolean
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function unregister($hook, $file, $function)
{
* @param integer $priority of the hook
* @param string $name of the hook to call
* @param mixed $data to transmit to the callback handler
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function fork($priority, $name, $data = null)
{
if (array_key_exists($name, self::$hooks)) {
foreach (self::$hooks[$name] as $hook) {
+ // Call a hook to check if this hook call needs to be forked
+ if (array_key_exists('hook_fork', self::$hooks)) {
+ $hookdata = ['name' => $name, 'data' => $data, 'execute' => true];
+
+ foreach (self::$hooks['hook_fork'] as $fork_hook) {
+ if ($hook[0] != $fork_hook[0]) {
+ continue;
+ }
+ self::callSingle(self::getApp(), 'hook_fork', $fork_hook, $hookdata);
+ }
+
+ if (!$hookdata['execute']) {
+ continue;
+ }
+ }
+
Worker::add($priority, 'ForkHook', $name, $hook, $data);
}
}
* Use this function when you want to be able to allow a hook to manipulate
* the provided data.
*
- * @param string $name of the hook to call
+ * @param string $name of the hook to call
* @param string|array &$data to transmit to the callback handler
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function callAll($name, &$data = null)
{
/**
* @brief Calls a single hook.
*
- * @param App $a
- * @param string $name of the hook to call
- * @param array $hook Hook data
+ * @param App $a
+ * @param string $name of the hook to call
+ * @param array $hook Hook data
* @param string|array &$data to transmit to the callback handler
+ * @throws \Friendica\Network\HTTPException\InternalServerErrorException
*/
public static function callSingle(App $a, $name, $hook, &$data = null)
{