X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;f=functions%2Fplugin.php;h=b28f550d89effcb9efc1942f9dbc4b31d55dadb9;hb=fc380412e4affcb0ff647acbf72b0baa28699fde;hp=fdc7020dee4ce3785994d67ddd6384b63a659142;hpb=0a17ec326717611f4e339d44986741ef53f3c0f6;p=squirrelmail.git diff --git a/functions/plugin.php b/functions/plugin.php index fdc7020d..b28f550d 100644 --- a/functions/plugin.php +++ b/functions/plugin.php @@ -3,74 +3,200 @@ /** * plugin.php * - * Copyright (c) 1999-2001 The SquirrelMail Development Team + * Copyright (c) 1999-2005 The SquirrelMail Project Team * Licensed under the GNU GPL. For full terms see the file COPYING. * * This file provides the framework for a plugin architecture. * * Documentation on how to write plugins might show up some time. * - * $Id$ + * @version $Id$ + * @package squirrelmail */ -/*****************************************************************/ -/*** THIS FILE NEEDS TO HAVE ITS FORMATTING FIXED!!! ***/ -/*** PLEASE DO SO AND REMOVE THIS COMMENT SECTION. ***/ -/*** + Base level indent should begin at left margin, as ***/ -/*** the first line of the function definition below. ***/ -/*** + All identation should consist of four space blocks ***/ -/*** + Tab characters are evil. ***/ -/*** + all comments should use "slash-star ... star-slash" ***/ -/*** style -- no pound characters, no slash-slash style ***/ -/*** + FLOW CONTROL STATEMENTS (if, while, etc) SHOULD ***/ -/*** ALWAYS USE { AND } CHARACTERS!!! ***/ -/*** + Please use ' instead of ", when possible. Note " ***/ -/*** should always be used in _( ) function calls. ***/ -/*** Thank you for your help making the SM code more readable. ***/ -/*****************************************************************/ +/** Everything needs global.. */ +require_once(SM_PATH . 'functions/global.php'); +require_once(SM_PATH . 'functions/prefs.php'); global $squirrelmail_plugin_hooks; $squirrelmail_plugin_hooks = array(); - // This function adds a plugin - function use_plugin ($name) { +/** + * This function adds a plugin. + * @param string $name Internal plugin name (ie. delete_move_next) + * @return void + */ +function use_plugin ($name) { + if (file_exists(SM_PATH . "plugins/$name/setup.php")) { + include_once(SM_PATH . "plugins/$name/setup.php"); + $function = "squirrelmail_plugin_init_$name"; + if (function_exists($function)) { + $function(); + } + } +} - if (file_exists('../plugins/'.$name.'/setup.php')) { - include_once('../plugins/'.$name.'/setup.php'); - $function = 'squirrelmail_plugin_init_'.$name; +/** + * This function executes a hook. + * @param string $name Name of hook to fire + * @return mixed $data + */ +function do_hook ($name) { + global $squirrelmail_plugin_hooks, $currentHookName; + $data = func_get_args(); + $currentHookName = $name; + + if (isset($squirrelmail_plugin_hooks[$name]) + && is_array($squirrelmail_plugin_hooks[$name])) { + foreach ($squirrelmail_plugin_hooks[$name] as $function) { + /* Add something to set correct gettext domain for plugin. */ if (function_exists($function)) { - $function(); + $function($data); } } + } + + $currentHookName = ''; + /* Variable-length argument lists have a slight problem when */ + /* passing values by reference. Pity. This is a workaround. */ + return $data; +} + +/** + * This function executes a hook and allows for parameters to be passed. + * + * @param string name the name of the hook + * @param mixed param the parameters to pass to the hook function + * @return mixed the return value of the hook function + */ +function do_hook_function($name,$parm=NULL) { + global $squirrelmail_plugin_hooks, $currentHookName; + $ret = ''; + $currentHookName = $name; + + if (isset($squirrelmail_plugin_hooks[$name]) + && is_array($squirrelmail_plugin_hooks[$name])) { + foreach ($squirrelmail_plugin_hooks[$name] as $function) { + /* Add something to set correct gettext domain for plugin. */ + if (function_exists($function)) { + $ret = $function($parm); + } + } } - // This function executes a hook - function do_hook ($name) { - global $squirrelmail_plugin_hooks; - $Data = func_get_args(); - if (isset($squirrelmail_plugin_hooks[$name]) && - is_array($squirrelmail_plugin_hooks[$name])) { - foreach ($squirrelmail_plugin_hooks[$name] as $function) { - // Add something to set correct gettext domain for plugin - if (function_exists($function)) { - $function($Data); + $currentHookName = ''; + + /* Variable-length argument lists have a slight problem when */ + /* passing values by reference. Pity. This is a workaround. */ + return $ret; +} + +/** + * This function executes a hook, concatenating the results of each + * plugin that has the hook defined. + * + * @param string name the name of the hook + * @param mixed parm optional hook function parameters + * @return string a concatenation of the results of each plugin function + */ +function concat_hook_function($name,$parm=NULL) { + global $squirrelmail_plugin_hooks, $currentHookName; + $ret = ''; + $currentHookName = $name; + + if (isset($squirrelmail_plugin_hooks[$name]) + && is_array($squirrelmail_plugin_hooks[$name])) { + foreach ($squirrelmail_plugin_hooks[$name] as $function) { + /* Concatenate results from hook. */ + if (function_exists($function)) { + $ret .= $function($parm); + } + } + } + + $currentHookName = ''; + + /* Variable-length argument lists have a slight problem when */ + /* passing values by reference. Pity. This is a workaround. */ + return $ret; +} + +/** + * This function is used for hooks which are to return true or + * false. If $priority is > 0, any one or more trues will override + * any falses. If $priority < 0, then one or more falses will + * override any trues. + * Priority 0 means majority rules. Ties will be broken with $tie + * + * @param string name the hook name + * @param mixed parm the parameters for the hook function + * @param int priority + * @param bool tie + * @return bool the result of the function + */ +function boolean_hook_function($name,$parm=NULL,$priority=0,$tie=false) { + global $squirrelmail_plugin_hooks, $currentHookName; + $yea = 0; + $nay = 0; + $ret = $tie; + + if (isset($squirrelmail_plugin_hooks[$name]) && + is_array($squirrelmail_plugin_hooks[$name])) { + + /* Loop over the plugins that registered the hook */ + $currentHookName = $name; + foreach ($squirrelmail_plugin_hooks[$name] as $function) { + if (function_exists($function)) { + $ret = $function($parm); + if ($ret) { + $yea++; + } else { + $nay++; } } } + $currentHookName = ''; - // Variable-length argument lists have a slight problem when - // passing values by reference. Pity. This is a workaround. - return $Data; + /* Examine the aftermath and assign the return value appropriately */ + if (($priority > 0) && ($yea)) { + $ret = true; + } elseif (($priority < 0) && ($nay)) { + $ret = false; + } elseif ($yea > $nay) { + $ret = true; + } elseif ($nay > $yea) { + $ret = false; + } else { + // There's a tie, no action needed. + } + return $ret; } + // If the code gets here, there was a problem - no hooks, etc. + return NULL; +} - /* -------------------- MAIN --------------------- */ +/** + * This function checks whether the user's USER_AGENT is known to + * be broken. If so, returns true and the plugin is invisible to the + * offending browser. + * *** THIS IS A TEST FOR JAVASCRIPT SUPPORT *** + * FIXME: This function needs to have its name changed! + * + * @return bool whether this browser properly supports JavaScript + */ +function soupNazi(){ + return !checkForJavascript(); +} +/*************************************/ +/*** MAIN PLUGIN LOADING CODE HERE ***/ +/*************************************/ - // On startup, register all plugins configured for use - if (isset($plugins) && is_array($plugins)) { - foreach ($plugins as $name) { - use_plugin($name); - } +/* On startup, register all plugins configured for use. */ +if (isset($plugins) && is_array($plugins)) { + foreach ($plugins as $name) { + use_plugin($name); } +} -?> +?> \ No newline at end of file