27663afe |
1 | <?php |
4b4abf93 |
2 | |
21b8ca51 |
3 | /** |
4 | * Change password backend template |
5 | * |
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. |
10 | * |
11 | * Replace the word template everywhere with a name for your backend. |
12 | * |
77a1e3d1 |
13 | * @copyright 2003-2022 The SquirrelMail Project Team |
4b4abf93 |
14 | * @license http://opensource.org/licenses/gpl-license.php GNU Public License |
21b8ca51 |
15 | * @version $Id$ |
16 | * @package plugins |
17 | * @subpackage change_password |
27663afe |
18 | */ |
19 | |
20 | /** |
21 | * Config vars: here's room for config vars specific to your |
22 | * backend. |
23 | */ |
24 | |
25 | /** |
26 | * Define here the name of your password changing function. |
27 | */ |
28 | global $squirrelmail_plugin_hooks; |
91e0dccc |
29 | $squirrelmail_plugin_hooks['change_password_dochange']['template'] = |
30 | 'cpw_template_dochange'; |
31 | $squirrelmail_plugin_hooks['change_password_init']['template'] = |
32 | 'cpw_template_init'; |
5c34b0bb |
33 | |
34 | |
35 | /** |
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. |
39 | */ |
40 | function cpw_template_init() |
41 | { |
1b858d86 |
42 | global $oTemplate; |
5c34b0bb |
43 | |
7bd637cf |
44 | // plugin is not configured. Handle error gracefully. |
1b858d86 |
45 | error_box(_("No valid backend defined.")); |
7bd637cf |
46 | // close html and stop script execution |
1b858d86 |
47 | $oTemplate->display('footer.tpl'); |
7bd637cf |
48 | exit(); |
5c34b0bb |
49 | } |
50 | |
27663afe |
51 | |
52 | /** |
53 | * This is the function that is specific to your backend. It takes |
54 | * the current password (as supplied by the user) and the desired |
55 | * new password. It will return an array of messages. If everything |
56 | * was successful, the array will be empty. Else, it will contain |
57 | * the errormessage(s). |
58 | * Constants to be used for these messages: |
59 | * CPW_CURRENT_NOMATCH -> "Your current password is not correct." |
60 | * CPW_INVALID_PW -> "Your new password contains invalid characters." |
61 | * |
91e0dccc |
62 | * @param array data The username/currentpw/newpw data. |
27663afe |
63 | * @return array Array of error messages. |
64 | */ |
65 | function cpw_template_dochange($data) |
66 | { |
67 | // unfortunately, we can only pass one parameter to a hook function, |
68 | // so we have to pass it as an array. |
69 | $username = $data['username']; |
70 | $curpw = $data['curpw']; |
71 | $newpw = $data['newpw']; |
72 | |
73 | $msgs = array(); |
74 | |
75 | // your code here to change the password for $username from |
76 | // $currentpw into $newpw. |
77 | user_error('No valid backend defined: this is just a template', E_USER_ERROR); |
78 | |
79 | return $msgs; |
91e0dccc |
80 | } |