776d4f2061204aed72a5835305e5d461152fedd7
4 * Change password backend template
6 * This is a template for a password changing mechanism. Currently,
7 * this contains two parts: the first is to register your function
8 * in the squirrelmail_plugin_hooks global, and the second is
9 * the function that does the actual changing.
11 * Replace the word template everywhere with a name for your backend.
13 * @copyright © 2003-2005 The SquirrelMail Project Team
14 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
17 * @subpackage change_password
21 * Config vars: here's room for config vars specific to your
26 * Define here the name of your password changing function.
28 global $squirrelmail_plugin_hooks;
29 $squirrelmail_plugin_hooks['change_password_dochange']['template'] =
30 'cpw_template_dochange';
31 $squirrelmail_plugin_hooks['change_password_init']['template'] =
36 * Use this function to do any backend-specific initialization,
37 * e.g. checking requirements, before the password change form
38 * is displayed to the user.
40 function cpw_template_init()
45 * If SM_PATH isn't defined, define it. Required to include files.
48 if (!defined('SM_PATH')) {
49 define('SM_PATH','../../../');
52 // load error_box() function
53 include_once(SM_PATH
. 'functions/display_messages.php');
55 // plugin is not configured. Handle error gracefully.
56 error_box(_("No valid backend defined."),$color);
57 // close html and stop script execution
58 echo "</body></html>\n";
64 * This is the function that is specific to your backend. It takes
65 * the current password (as supplied by the user) and the desired
66 * new password. It will return an array of messages. If everything
67 * was successful, the array will be empty. Else, it will contain
68 * the errormessage(s).
69 * Constants to be used for these messages:
70 * CPW_CURRENT_NOMATCH -> "Your current password is not correct."
71 * CPW_INVALID_PW -> "Your new password contains invalid characters."
73 * @param array data The username/currentpw/newpw data.
74 * @return array Array of error messages.
76 function cpw_template_dochange($data)
78 // unfortunately, we can only pass one parameter to a hook function,
79 // so we have to pass it as an array.
80 $username = $data['username'];
81 $curpw = $data['curpw'];
82 $newpw = $data['newpw'];
86 // your code here to change the password for $username from
87 // $currentpw into $newpw.
88 user_error('No valid backend defined: this is just a template', E_USER_ERROR
);