'; //print_r($this->found_hooks); //echo ''; } } /*! @function process @abstract executes all the hooks (the user has rights to) for a given location @syntax process($args,$order='',$no_permission_check = False) @param $args location-name as string or array: @param $args['location'] location-name @param $order or $args['order'] array of appnames (as value), which should be executes first @param $args is passed to the hook, if its a new method-hook @param $no_permission_check if True execute all hooks, not only the ones a user has rights to @note $no_permission_check should *ONLY* be used when it *HAS* to be. (jengo) @returns array with results of each hook call (with appname as key): \ False if no hook exists, True if old hook exists \ and whatever the new method-hook returns (can be True or False too!). */ function process($args, $order = '', $no_permission_check = False) { //echo "
hooks::process("; print_r($args); echo ")
\n"; if ($order == '') { $order = is_array($args) && isset($args['order']) ? $args['order'] : array($GLOBALS['phpgw_info']['flags']['currentapp']); } /* First include the ordered apps hook file */ foreach($order as $appname) { $results[$appname] = $this->single($args,$appname,$no_permission_check); if (!isset($results[$appname])) // happens if the method hook has no return-value { $results[$appname] = False; } } /* Then add the rest */ if ($no_permission_check) { $apps = $GLOBALS['phpgw_info']['apps']; } else { $apps = $GLOBALS['phpgw_info']['user']['apps']; } settype($apps,'array'); foreach($apps as $app) { $appname = $app['name']; if (!isset($results[$appname])) { $results[$appname] = $this->single($args,$appname,$no_permission_check); } } return $results; } /*! @function single @abstract executes a single hook of a given location and application @syntax single($args,$appname='',$no_permission_check = False) @param $args location-name as string or array: @param $args['location'] location-name @param $appname or $args['appname'] name of the app, which's hook to execute, if empty the current app is used @param $args is passed to the hook, if its a new method-hook @param $no_permission_check if True execute all hooks, not only the ones a user has rights to @param $try_unregisterd If true, try to include old file-hook anyway (for setup) @note $no_permission_check should *ONLY* be used when it *HAS* to be. (jengo) @returns False if no hook exists, True if an old hook exist and whatever the new method-hook returns */ function single($args, $appname = '', $no_permission_check = False,$try_unregistered = False) { //echo "hooks::single("; print_r($args); echo ",'$appname','$no_permission_check','$try_unregistered')
\n"; if (is_array($args)) { $location = $args['location']; } else { $location = $args; } if (!$appname) { $appname = is_array($args) && isset($args['appname']) ? $args['appname'] : $GLOBALS['phpgw_info']['flags']['currentapp']; } $SEP = filesystem_separator(); /* First include the ordered apps hook file */ if (isset($this->found_hooks[$appname][$location]) || $try_unregistered) { $parts = explode('.',$method = $this->found_hooks[$appname][$location]); if (count($parts) != 3 || ($parts[1] == 'inc' && $parts[2] == 'php')) { if ($try_unregistered && empty($method)) { $method = 'hook_'.$location.'.inc.php'; } $f = PHPGW_SERVER_ROOT . $SEP . $appname . $SEP . 'inc' . $SEP . $method; if (file_exists($f) && ( $GLOBALS['phpgw_info']['user']['apps'][$appname] || (($no_permission_check || $location == 'config' || $appname == 'phpgwapi') && $appname)) ) { include($f); return True; } else { return False; } } else // new style method-hook { return ExecMethod($method,$args); } } else { return False; } } /*! @function count @abstract loop through the applications and count the hooks */ function count($location) { $count = 0; foreach($GLOBALS['phpgw_info']['user']['apps'] as $appname => $data) { if (isset($this->found_hooks[$appname][$location])) { ++$count; } } return $count; } /*! @function read() @abstract currently not being used */ function read() { //if (!is_array($this->found_hooks)) //{ $this->hooks(); //} return $this->found_hooks; } /*! @function register_hooks @abstract Register and/or de-register an application's hooks @syntax register_hooks($appname,$hooks='') @param $appname Application 'name' @param $hooks array with hooks to register, eg $setup_info[$app]['hooks'] or not used for only deregister the hooks */ function register_hooks($appname,$hooks='') { if(!$appname) { return False; } $db_appname = $this->db->db_addslashes($appname); $this->db->query("DELETE FROM phpgw_hooks WHERE hook_appname='$db_appname'",__LINE__,__FILE__); if (!is_array($hooks)) // only deregister { return True; } //echo "ADDING hooks for: $appname
"; foreach($hooks as $key => $hook) { if (!is_numeric($key)) // new method-hook { $location = $key; $filename = $hook; } else { $location = $hook; $filename = "hook_$hook.inc.php"; } $this->db->query("INSERT INTO phpgw_hooks (hook_appname,hook_location,hook_filename)". " VALUES ('$appname','$location','$filename');"); } return True; } /*! @function register_all_hooks @abstract Register the hooks of all applications (used by admin) */ function register_all_hooks() { $SEP = filesystem_separator(); foreach($GLOBALS['phpgw_info']['apps'] as $appname => $app) { $f = PHPGW_SERVER_ROOT . $SEP . $appname . $SEP . 'setup' . $SEP . 'setup.inc.php'; if(@file_exists($f)) { include($f); $this->register_hooks($appname,$setup_info[$appname]['hooks']); } } } } ?>