d4449614e751eba8b9a4b0da28f800c7cbebd9d8
[moodle.git] / admin / settings / users.php
1 <?php
3 // This file defines settingpages and externalpages under the "users" category
5 $ADMIN->add('users', new admin_category('accounts', new lang_string('accounts', 'admin')));
6 $ADMIN->add('users', new admin_category('roles', new lang_string('permissions', 'role')));
8 if ($hassiteconfig
9  or has_capability('moodle/user:create', $systemcontext)
10  or has_capability('moodle/user:update', $systemcontext)
11  or has_capability('moodle/user:delete', $systemcontext)
12  or has_capability('moodle/role:manage', $systemcontext)
13  or has_capability('moodle/role:assign', $systemcontext)
14  or has_capability('moodle/cohort:manage', $systemcontext)
15  or has_capability('moodle/cohort:view', $systemcontext)) { // speedup for non-admins, add all caps used on this page
18     // stuff under the "accounts" subcategory
19     $ADMIN->add('accounts', new admin_externalpage('editusers', new lang_string('userlist','admin'), "$CFG->wwwroot/$CFG->admin/user.php", array('moodle/user:update', 'moodle/user:delete')));
20     $ADMIN->add('accounts', new admin_externalpage('userbulk', new lang_string('userbulk','admin'), "$CFG->wwwroot/$CFG->admin/user/user_bulk.php", array('moodle/user:update', 'moodle/user:delete')));
21     $ADMIN->add('accounts', new admin_externalpage('addnewuser', new lang_string('addnewuser'), "$CFG->wwwroot/user/editadvanced.php?id=-1", 'moodle/user:create'));
23     // "User default preferences" settingpage.
24     $temp = new admin_settingpage('userdefaultpreferences', new lang_string('userdefaultpreferences', 'admin'));
25     if ($ADMIN->fulltree) {
26         $choices = array();
27         $choices['0'] = new lang_string('emaildisplayno');
28         $choices['1'] = new lang_string('emaildisplayyes');
29         $choices['2'] = new lang_string('emaildisplaycourse');
30         $temp->add(new admin_setting_configselect('defaultpreference_maildisplay', new lang_string('emaildisplay'),
31             new lang_string('emaildisplay_help'), 2, $choices));
33         $choices = array();
34         $choices['0'] = new lang_string('textformat');
35         $choices['1'] = new lang_string('htmlformat');
36         $temp->add(new admin_setting_configselect('defaultpreference_mailformat', new lang_string('emailformat'), '', 1, $choices));
38         $choices = array();
39         $choices['0'] = new lang_string('emaildigestoff');
40         $choices['1'] = new lang_string('emaildigestcomplete');
41         $choices['2'] = new lang_string('emaildigestsubjects');
42         $temp->add(new admin_setting_configselect('defaultpreference_maildigest', new lang_string('emaildigest'),
43             new lang_string('emaildigest_help'), 0, $choices));
46         $choices = array();
47         $choices['1'] = new lang_string('autosubscribeyes');
48         $choices['0'] = new lang_string('autosubscribeno');
49         $temp->add(new admin_setting_configselect('defaultpreference_autosubscribe', new lang_string('autosubscribe'),
50             '', 1, $choices));
52         $choices = array();
53         $choices['0'] = new lang_string('trackforumsno');
54         $choices['1'] = new lang_string('trackforumsyes');
55         $temp->add(new admin_setting_configselect('defaultpreference_trackforums', new lang_string('trackforums'),
56             '', 0, $choices));
57     }
58     $ADMIN->add('accounts', $temp);
60     $ADMIN->add('accounts', new admin_externalpage('profilefields', new lang_string('profilefields','admin'), "$CFG->wwwroot/user/profile/index.php", 'moodle/site:config'));
61     $ADMIN->add('accounts', new admin_externalpage('cohorts', new lang_string('cohorts', 'cohort'), $CFG->wwwroot . '/cohort/index.php', array('moodle/cohort:manage', 'moodle/cohort:view')));
64     // stuff under the "roles" subcategory
66     // "userpolicies" settingpage
67     $temp = new admin_settingpage('userpolicies', new lang_string('userpolicies', 'admin'));
68     if ($ADMIN->fulltree) {
69         if (!during_initial_install()) {
70             $context = context_system::instance();
72             $otherroles      = array();
73             $guestroles      = array();
74             $userroles       = array();
75             $creatornewroles = array();
77             $defaultteacherid = null;
78             $defaultuserid    = null;
79             $defaultguestid   = null;
81             $roles = role_fix_names(get_all_roles(), null, ROLENAME_ORIGINALANDSHORT);
82             foreach ($roles as $role) {
83                 $rolename = $role->localname;
84                 switch ($role->archetype) {
85                     case 'manager':
86                         $creatornewroles[$role->id] = $rolename;
87                         break;
88                     case 'coursecreator':
89                         break;
90                     case 'editingteacher':
91                         $defaultteacherid = isset($defaultteacherid) ? $defaultteacherid : $role->id;
92                         $creatornewroles[$role->id] = $rolename;
93                         break;
94                     case 'teacher':
95                         $creatornewroles[$role->id] = $rolename;
96                         break;
97                     case 'student':
98                         break;
99                     case 'guest':
100                         $defaultguestid = isset($defaultguestid) ? $defaultguestid : $role->id;
101                         $guestroles[$role->id] = $rolename;
102                         break;
103                     case 'user':
104                         $defaultuserid = isset($defaultuserid) ? $defaultuserid : $role->id;
105                         $userroles[$role->id] = $rolename;
106                         break;
107                     case 'frontpage':
108                         break;
109                     default:
110                         $creatornewroles[$role->id] = $rolename;
111                         $otherroles[$role->id] = $rolename;
112                         break;
113                 }
114             }
116             if (empty($guestroles)) {
117                 $guestroles[0] = new lang_string('none');
118                 $defaultguestid = 0;
119             }
121             if (empty($userroles)) {
122                 $userroles[0] = new lang_string('none');
123                 $defaultuserid = 0;
124             }
126             $restorersnewrole = $creatornewroles;
127             $restorersnewrole[0] = new lang_string('none');
129             $temp->add(new admin_setting_configselect('notloggedinroleid', new lang_string('notloggedinroleid', 'admin'),
130                           new lang_string('confignotloggedinroleid', 'admin'), $defaultguestid, ($guestroles + $otherroles)));
131             $temp->add(new admin_setting_configselect('guestroleid', new lang_string('guestroleid', 'admin'),
132                           new lang_string('guestroleid_help', 'admin'), $defaultguestid, ($guestroles + $otherroles)));
133             $temp->add(new admin_setting_configselect('defaultuserroleid', new lang_string('defaultuserroleid', 'admin'),
134                           new lang_string('configdefaultuserroleid', 'admin'), $defaultuserid, ($userroles + $otherroles)));
135             $temp->add(new admin_setting_configselect('creatornewroleid', new lang_string('creatornewroleid', 'admin'),
136                           new lang_string('creatornewroleid_help', 'admin'), $defaultteacherid, $creatornewroles));
137             $temp->add(new admin_setting_configselect('restorernewroleid', new lang_string('restorernewroleid', 'admin'),
138                           new lang_string('restorernewroleid_help', 'admin'), $defaultteacherid, $restorersnewrole));
140             // release memory
141             unset($otherroles);
142             unset($guestroles);
143             unset($userroles);
144             unset($creatornewroles);
145             unset($restorersnewrole);
146         }
148         $temp->add(new admin_setting_configcheckbox('autologinguests', new lang_string('autologinguests', 'admin'), new lang_string('configautologinguests', 'admin'), 0));
150         $temp->add(new admin_setting_configmultiselect('hiddenuserfields', new lang_string('hiddenuserfields', 'admin'),
151                    new lang_string('confighiddenuserfields', 'admin'), array(),
152                        array('description' => new lang_string('description'),
153                              'email' => new lang_string('email'),
154                              'city' => new lang_string('city'),
155                              'country' => new lang_string('country'),
156                              'timezone' => new lang_string('timezone'),
157                              'webpage' => new lang_string('webpage'),
158                              'icqnumber' => new lang_string('icqnumber'),
159                              'skypeid' => new lang_string('skypeid'),
160                              'yahooid' => new lang_string('yahooid'),
161                              'aimid' => new lang_string('aimid'),
162                              'msnid' => new lang_string('msnid'),
163                              'firstaccess' => new lang_string('firstaccess'),
164                              'lastaccess' => new lang_string('lastaccess'),
165                              'lastip' => new lang_string('lastip'),
166                              'mycourses' => new lang_string('mycourses'),
167                              'groups' => new lang_string('groups'),
168                              'suspended' => new lang_string('suspended', 'auth'),
169                        )));
171         // Select fields to display as part of user identity (only to those
172         // with moodle/site:viewuseridentity).
173         // Options include fields from the user table that might be helpful to
174         // distinguish when adding or listing users ('I want to add the John
175         // Smith from Science faculty').
176         // Username is not included as an option because in some sites, it might
177         // be a security problem to reveal usernames even to trusted staff.
178         // Custom user profile fields are not currently supported.
179         $temp->add(new admin_setting_configmulticheckbox('showuseridentity',
180                 new lang_string('showuseridentity', 'admin'),
181                 new lang_string('showuseridentity_desc', 'admin'), array('email' => 1), array(
182                     'idnumber'    => new lang_string('idnumber'),
183                     'email'       => new lang_string('email'),
184                     'phone1'      => new lang_string('phone1'),
185                     'phone2'      => new lang_string('phone2'),
186                     'department'  => new lang_string('department'),
187                     'institution' => new lang_string('institution'),
188                     'city'        => new lang_string('city'),
189                     'country'     => new lang_string('country'),
190                 )));
191         $setting = new admin_setting_configtext('fullnamedisplay', new lang_string('fullnamedisplay', 'admin'),
192             new lang_string('configfullnamedisplay', 'admin'), 'language', PARAM_TEXT, 50);
193         $setting->set_force_ltr(true);
194         $temp->add($setting);
195         $temp->add(new admin_setting_configtext('alternativefullnameformat', new lang_string('alternativefullnameformat', 'admin'),
196                 new lang_string('alternativefullnameformat_desc', 'admin'),
197                 'language', PARAM_RAW, 50));
198         $temp->add(new admin_setting_configtext('maxusersperpage', new lang_string('maxusersperpage','admin'), new lang_string('configmaxusersperpage','admin'), 100, PARAM_INT));
199         $temp->add(new admin_setting_configcheckbox('enablegravatar', new lang_string('enablegravatar', 'admin'), new lang_string('enablegravatar_help', 'admin'), 0));
200         $temp->add(new admin_setting_configtext('gravatardefaulturl', new lang_string('gravatardefaulturl', 'admin'), new lang_string('gravatardefaulturl_help', 'admin'), 'mm'));
201     }
203     $ADMIN->add('roles', $temp);
205     if (is_siteadmin()) {
206         $ADMIN->add('roles', new admin_externalpage('admins', new lang_string('siteadministrators', 'role'), "$CFG->wwwroot/$CFG->admin/roles/admins.php"));
207     }
208     $ADMIN->add('roles', new admin_externalpage('defineroles', new lang_string('defineroles', 'role'), "$CFG->wwwroot/$CFG->admin/roles/manage.php", 'moodle/role:manage'));
209     $ADMIN->add('roles', new admin_externalpage('assignroles', new lang_string('assignglobalroles', 'role'), "$CFG->wwwroot/$CFG->admin/roles/assign.php?contextid=".$systemcontext->id, 'moodle/role:assign'));
210     $ADMIN->add('roles', new admin_externalpage('checkpermissions', new lang_string('checkglobalpermissions', 'role'), "$CFG->wwwroot/$CFG->admin/roles/check.php?contextid=".$systemcontext->id, array('moodle/role:assign', 'moodle/role:safeoverride', 'moodle/role:override', 'moodle/role:manage')));
212 } // end of speedup