Add some explanations for form elements on the edit user page

htdocs/admin/users/edit.php

@@ -58,6 +58,7 @@ if (empty($suspended)) {
                 'rows'        => 5,
                 'cols'        => 60,
                 'title'       => get_string('reason'),
+                'description' => get_string('suspendedreasondescription', 'admin'),
             ),
             'submit' => array(
                 'type'  => 'submit',
@@ -109,27 +110,32 @@ $elements['id'] = array(
 $elements['password'] = array(
     'type'         => 'text',
     'title'        => get_string('resetpassword','admin'),
+    'description'  => get_string('resetpassworddescription','admin'),
 );
 $elements['passwordchange'] = array(
     'type'         => 'checkbox',
     'title'        => get_string('forcepasswordchange','admin'),
+    'description'  => get_string('forcepasswordchangedescription','admin'),
     'defaultvalue' => $user->passwordchange,
 );
 if ($USER->get('admin')) {
     $elements['staff'] = array(
         'type'         => 'checkbox',
         'title'        => get_string('sitestaff','admin'),
+        //'description'  => get_string('sitestaffdescription','admin'),
         'defaultvalue' => $user->staff,
     );
     $elements['admin'] = array(
         'type'         => 'checkbox',
         'title'        => get_string('siteadmin','admin'),
+        //'description'  => get_string('siteadmindescription','admin'),
         'defaultvalue' => $user->admin,
     );
 }
 $elements['quota'] = array(
     'type'         => 'bytes',
     'title'        => get_string('filequota','admin'),
+    'description'  => get_string('filequotadescription','admin'),
     'rules'        => array('integer' => true),
     'defaultvalue' => $user->quota,
 );
@@ -150,17 +156,18 @@ if (count($authinstances) > 1) {
 
     if (isset($options[$user->authinstance])) {
         $elements['authinstance'] = array(
-            'type' => 'select',
-            'title' => get_string('authenticatedby', 'admin'),
-            'options' => $options,
+            'type'         => 'select',
+            'title'        => get_string('authenticatedby', 'admin'),
+            //'description'  => get_string('authenticatedbydescription', 'admin'),
+            'options'      => $options,
             'defaultvalue' => $user->authinstance,
         );
         if ($external) {
             $un = get_field('auth_remote_user', 'remoteusername', 'authinstance', $user->authinstance, 'localusr', $user->id);
             $elements['remoteusername'] = array(
-                'type' => 'text',
-                'title' => get_string('remoteusername', 'admin'),
-                'rules' => array('regex' => '/^[a-zA-Z]+[0-9a-zA-Z\.-]*$/'),
+                'type'         => 'text',
+                'title'        => get_string('remoteusername', 'admin'),
+                'description'  => get_string('remoteusernamedescription', 'admin'),
                 'defaultvalue' => $un ? $un : $user->username,
             );
         }
@@ -258,24 +265,27 @@ foreach ($user->get('institutions') as $i) {
         'elements' => array(
             $i->institution.'_expiry' => array(
                 'type'         => 'date',
-                'title'        => get_string('membershipexpiry'),
+                'title'        => get_string('membershipexpiry', 'admin'),
+                'description'  => get_string('membershipexpirydescription', 'admin'),
                 'minyear'      => $currentdate['year'],
                 'maxyear'      => $currentdate['year'] + 20,
                 'defaultvalue' => $i->expiry
             ),
             $i->institution.'_studentid' => array(
                 'type'         => 'text',
-                'title'        => get_string('studentid'),
+                'title'        => get_string('studentid', 'admin'),
+                'description'  => get_string('institutionstudentiddescription', 'admin'),
                 'defaultvalue' => $i->studentid,
             ),
-            $i->institution.'_staff' => array(
+            /* $i->institution.'_staff' => array(
                 'type'         => 'checkbox',
                 'title'        => get_string('institutionstaff','admin'),
                 'defaultvalue' => $i->staff,
-            ),
+            ), */
             $i->institution.'_admin' => array(
                 'type'         => 'checkbox',
                 'title'        => get_string('institutionadmin','admin'),
+                'description'  => get_string('institutionadmindescription','admin'),
                 'defaultvalue' => $i->admin,
             ),
             $i->institution.'_submit' => array(

htdocs/lang/en.utf8/admin.php

@@ -251,17 +251,22 @@ $string['userunsuspended'] = 'User unsuspended';
 $string['accountsettings'] = 'Account settings';
 $string['siteaccountsettings'] = 'Site account settings';
 $string['resetpassword'] = 'Reset password';
+$string['resetpassworddescription'] = 'If you enter text here, it will replace the user\'s current password.';
 $string['forcepasswordchange'] = 'Force password change on next login';
+$string['forcepasswordchangedescription'] = 'The user will be directed to a change password page the next time they login.';
 $string['sitestaff'] = 'Site staff';
+$string['sitestaffdescription'] = 'If checked, the user can create controlled Communities, receive and release submitted views and access key user profile information.';
 $string['siteadmins'] = 'Site Admins';
 $string['siteadmin'] = 'Site administrator';
+$string['siteadmindescription'] = 'Site administrators can to do anything and go anywhere on the site';
 $string['suspended'] = 'Suspended';
 $string['suspendedreason'] = 'Reason for suspension';
-$string['suspendedreasondescription'] = 'The explanation you enter here will be displayed to the user when they try to login';
+$string['suspendedreasondescription'] = 'The text that will be displayed to the user on their next login attempt.';
 $string['unsuspenduser'] = 'Unsuspend User';
 $string['thisuserissuspended'] = 'This user has been suspended';
 $string['suspendedby'] = 'This user has been suspended by %s';
 $string['filequota'] = 'File quota (MB)';
+$string['filequotadescription'] = 'Total storage available in the user\'s files area.';
 $string['confirmremoveuserfrominstitution'] = 'Are you sure you want to remove the user from this institution?';
 
 // Login as
@@ -295,12 +300,15 @@ $string['registrationalloweddescription'] = 'Whether users can register for the
 $string['defaultmembershipperiod'] = 'Default membership period';
 $string['defaultmembershipperioddescription'] = 'How long new members remain associated with the institution';
 $string['authenticatedby'] = 'Authentication Method';
+$string['authenticatedbydescription'] = '';
 $string['remoteusername'] = 'Username for external authentication';
+$string['remoteusernamedescription'] = 'If this user is authenticated by an external method and you would like to associate them with a different identity on a remote database, enter their remote username here.';
 $string['institutionsettings'] = 'Institution Settings';
 $string['changeinstitution'] = 'Change Institution';
 $string['institutionstaff'] = 'Institution Staff';
 $string['institutionadmins'] = 'Institution Administrators';
 $string['institutionadmin'] = 'Institution Admin';
+$string['institutionadmindescription'] = 'If checked, the user can administer all users in this institution.';
 $string['settingsfor'] = 'Settings for:';
 $string['institutionadministration'] = 'Institution Administration';
 $string['institutionmembers'] = 'Institution Members';
@@ -309,6 +317,10 @@ $string['institutionmemberspagedescription'] = 'On this page you can see users w
 $string['editmembers'] = 'Edit Members';
 $string['editstaff'] = 'Edit Staff';
 $string['editadmins'] = 'Edit Admins';
+$string['membershipexpiry'] = 'Membership expires';
+$string['membershipexpirydescription'] = 'Date on which the user will be automatically removed from the institution.';
+$string['studentid'] = 'ID Number';
+$string['institutionstudentiddescription'] = 'An optional identifier specific to the institution.  This field is not editable by the user.';
 
 $string['userstodisplay'] = 'Users to display:';
 $string['institutionusersrequesters'] = 'People who have requested institution membership';