user/editlib.php

   1 <?php
   2 // This file is part of Moodle - http://moodle.org/
   3 //
   4 // Moodle is free software: you can redistribute it and/or modify
   5 // it under the terms of the GNU General Public License as published by
   6 // the Free Software Foundation, either version 3 of the License, or
   7 // (at your option) any later version.
   8 //
   9 // Moodle is distributed in the hope that it will be useful,
  10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 // GNU General Public License for more details.
  13 //
  14 // You should have received a copy of the GNU General Public License
  15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
  16
  17 /**
  18  * This file contains function used when editing a users profile and preferences.
  19  *
  20  * @copyright 1999 Martin Dougiamas  http://dougiamas.com
  21  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  22  * @package core_user
  23  */
  24
  25 /**
  26  * Cancels the requirement for a user to update their email address.
  27  *
  28  * @param int $userid
  29  */
  30 function cancel_email_update($userid) {
  31     unset_user_preference('newemail', $userid);
  32     unset_user_preference('newemailkey', $userid);
  33     unset_user_preference('newemailattemptsleft', $userid);
  34 }
  35
  36 /**
  37  * Performs the common access checks and page setup for all
  38  * user preference pages.
  39  *
  40  * @param int $userid The user id to edit taken from the page params.
  41  * @param int $courseid The optional course id if we came from a course context.
  42  * @return array containing the user and course records.
  43  */
  44 function useredit_setup_preference_page($userid, $courseid) {
  45     global $PAGE, $SESSION, $DB, $CFG, $OUTPUT, $USER;
  46
  47     // Guest can not edit.
  48     if (isguestuser()) {
  49         print_error('guestnoeditprofile');
  50     }
  51
  52     if (!$course = $DB->get_record('course', array('id' => $courseid))) {
  53         print_error('invalidcourseid');
  54     }
  55
  56     if ($course->id != SITEID) {
  57         require_login($course);
  58     } else if (!isloggedin()) {
  59         if (empty($SESSION->wantsurl)) {
  60             $SESSION->wantsurl = $CFG->httpswwwroot.'/user/preferences.php';
  61         }
  62         redirect(get_login_url());
  63     } else {
  64         $PAGE->set_context(context_system::instance());
  65     }
  66
  67     // The user profile we are editing.
  68     if (!$user = $DB->get_record('user', array('id' => $userid))) {
  69         print_error('invaliduserid');
  70     }
  71
  72     // Guest can not be edited.
  73     if (isguestuser($user)) {
  74         print_error('guestnoeditprofile');
  75     }
  76
  77     // Remote users cannot be edited.
  78     if (is_mnet_remote_user($user)) {
  79         if (user_not_fully_set_up($user)) {
  80             $hostwwwroot = $DB->get_field('mnet_host', 'wwwroot', array('id' => $user->mnethostid));
  81             print_error('usernotfullysetup', 'mnet', '', $hostwwwroot);
  82         }
  83         redirect($CFG->wwwroot . "/user/view.php?course={$course->id}");
  84     }
  85
  86     $systemcontext   = context_system::instance();
  87     $personalcontext = context_user::instance($user->id);
  88
  89     // Check access control.
  90     if ($user->id == $USER->id) {
  91         // Editing own profile - require_login() MUST NOT be used here, it would result in infinite loop!
  92         if (!has_capability('moodle/user:editownprofile', $systemcontext)) {
  93             print_error('cannotedityourprofile');
  94         }
  95
  96     } else {
  97         // Teachers, parents, etc.
  98         require_capability('moodle/user:editprofile', $personalcontext);
  99
 100         // No editing of primary admin!
 101         if (is_siteadmin($user) and !is_siteadmin($USER)) {  // Only admins may edit other admins.
 102             print_error('useradmineditadmin');
 103         }
 104     }
 105
 106     if ($user->deleted) {
 107         echo $OUTPUT->header();
 108         echo $OUTPUT->heading(get_string('userdeleted'));
 109         echo $OUTPUT->footer();
 110         die;
 111     }
 112
 113     $PAGE->set_pagelayout('admin');
 114     $PAGE->set_context($personalcontext);
 115     if ($USER->id != $user->id) {
 116         $PAGE->navigation->extend_for_user($user);
 117     } else {
 118         if ($node = $PAGE->navigation->find('myprofile', navigation_node::TYPE_ROOTNODE)) {
 119             $node->force_open();
 120         }
 121     }
 122
 123     return array($user, $course);
 124 }
 125
 126 /**
 127  * Loads the given users preferences into the given user object.
 128  *
 129  * @param stdClass $user The user object, modified by reference.
 130  * @param bool $reload
 131  */
 132 function useredit_load_preferences(&$user, $reload=true) {
 133     global $USER;
 134
 135     if (!empty($user->id)) {
 136         if ($reload and $USER->id == $user->id) {
 137             // Reload preferences in case it was changed in other session.
 138             unset($USER->preference);
 139         }
 140
 141         if ($preferences = get_user_preferences(null, null, $user->id)) {
 142             foreach ($preferences as $name => $value) {
 143                 $user->{'preference_'.$name} = $value;
 144             }
 145         }
 146     }
 147 }
 148
 149 /**
 150  * Updates the user preferences for teh given user.
 151  *
 152  * @param stdClass|array $usernew
 153  */
 154 function useredit_update_user_preference($usernew) {
 155     $ua = (array)$usernew;
 156     foreach ($ua as $key => $value) {
 157         if (strpos($key, 'preference_') === 0) {
 158             $name = substr($key, strlen('preference_'));
 159             set_user_preference($name, $value, $usernew->id);
 160         }
 161     }
 162 }
 163
 164 /**
 165  * Updates the provided users profile picture based upon the expected fields returned from the edit or edit_advanced forms.
 166  *
 167  * @global moodle_database $DB
 168  * @param stdClass $usernew An object that contains some information about the user being updated
 169  * @param moodleform $userform The form that was submitted to edit the form
 170  * @param array $filemanageroptions
 171  * @return bool True if the user was updated, false if it stayed the same.
 172  */
 173 function useredit_update_picture(stdClass $usernew, moodleform $userform, $filemanageroptions = array()) {
 174     global $CFG, $DB;
 175     require_once("$CFG->libdir/gdlib.php");
 176
 177     $context = context_user::instance($usernew->id, MUST_EXIST);
 178     $user = $DB->get_record('user', array('id' => $usernew->id), 'id, picture', MUST_EXIST);
 179
 180     $newpicture = $user->picture;
 181     // Get file_storage to process files.
 182     $fs = get_file_storage();
 183     if (!empty($usernew->deletepicture)) {
 184         // The user has chosen to delete the selected users picture.
 185         $fs->delete_area_files($context->id, 'user', 'icon'); // Drop all images in area.
 186         $newpicture = 0;
 187
 188     } else {
 189         // Save newly uploaded file, this will avoid context mismatch for newly created users.
 190         file_save_draft_area_files($usernew->imagefile, $context->id, 'user', 'newicon', 0, $filemanageroptions);
 191         if (($iconfiles = $fs->get_area_files($context->id, 'user', 'newicon')) && count($iconfiles) == 2) {
 192             // Get file which was uploaded in draft area.
 193             foreach ($iconfiles as $file) {
 194                 if (!$file->is_directory()) {
 195                     break;
 196                 }
 197             }
 198             // Copy file to temporary location and the send it for processing icon.
 199             if ($iconfile = $file->copy_content_to_temp()) {
 200                 // There is a new image that has been uploaded.
 201                 // Process the new image and set the user to make use of it.
 202                 // NOTE: Uploaded images always take over Gravatar.
 203                 $newpicture = (int)process_new_icon($context, 'user', 'icon', 0, $iconfile);
 204                 // Delete temporary file.
 205                 @unlink($iconfile);
 206                 // Remove uploaded file.
 207                 $fs->delete_area_files($context->id, 'user', 'newicon');
 208             } else {
 209                 // Something went wrong while creating temp file.
 210                 // Remove uploaded file.
 211                 $fs->delete_area_files($context->id, 'user', 'newicon');
 212                 return false;
 213             }
 214         }
 215     }
 216
 217     if ($newpicture != $user->picture) {
 218         $DB->set_field('user', 'picture', $newpicture, array('id' => $user->id));
 219         return true;
 220     } else {
 221         return false;
 222     }
 223 }
 224
 225 /**
 226  * Updates the user email bounce + send counts when the user is edited.
 227  *
 228  * @param stdClass $user The current user object.
 229  * @param stdClass $usernew The updated user object.
 230  */
 231 function useredit_update_bounces($user, $usernew) {
 232     if (!isset($usernew->email)) {
 233         // Locked field.
 234         return;
 235     }
 236     if (!isset($user->email) || $user->email !== $usernew->email) {
 237         set_bounce_count($usernew, true);
 238         set_send_count($usernew, true);
 239     }
 240 }
 241
 242 /**
 243  * Updates the forums a user is tracking when the user is edited.
 244  *
 245  * @param stdClass $user The original user object.
 246  * @param stdClass $usernew The updated user object.
 247  */
 248 function useredit_update_trackforums($user, $usernew) {
 249     global $CFG;
 250     if (!isset($usernew->trackforums)) {
 251         // Locked field.
 252         return;
 253     }
 254     if ((!isset($user->trackforums) || ($usernew->trackforums != $user->trackforums)) and !$usernew->trackforums) {
 255         require_once($CFG->dirroot.'/mod/forum/lib.php');
 256         forum_tp_delete_read_records($usernew->id);
 257     }
 258 }
 259
 260 /**
 261  * Updates a users interests.
 262  *
 263  * @param stdClass $user
 264  * @param array $interests
 265  */
 266 function useredit_update_interests($user, $interests) {
 267     global $CFG;
 268     require_once($CFG->dirroot . '/tag/lib.php');
 269     tag_set('user', $user->id, $interests, 'core', context_user::instance($user->id)->id);
 270 }
 271
 272 /**
 273  * Powerful function that is used by edit and editadvanced to add common form elements/rules/etc.
 274  *
 275  * @param moodleform $mform
 276  * @param array $editoroptions
 277  * @param array $filemanageroptions
 278  * @param stdClass $user
 279  */
 280 function useredit_shared_definition(&$mform, $editoroptions, $filemanageroptions, $user) {
 281     global $CFG, $USER, $DB;
 282
 283     if ($user->id > 0) {
 284         useredit_load_preferences($user, false);
 285     }
 286
 287     $strrequired = get_string('required');
 288     $stringman = get_string_manager();
 289
 290     // Add the necessary names.
 291     foreach (useredit_get_required_name_fields() as $fullname) {
 292         $mform->addElement('text', $fullname,  get_string($fullname),  'maxlength="100" size="30"');
 293         if ($stringman->string_exists('missing'.$fullname, 'core')) {
 294             $strmissingfield = get_string('missing'.$fullname, 'core');
 295         } else {
 296             $strmissingfield = $strrequired;
 297         }
 298         $mform->addRule($fullname, $strmissingfield, 'required', null, 'client');
 299         $mform->setType($fullname, PARAM_NOTAGS);
 300     }
 301
 302     $enabledusernamefields = useredit_get_enabled_name_fields();
 303     // Add the enabled additional name fields.
 304     foreach ($enabledusernamefields as $addname) {
 305         $mform->addElement('text', $addname,  get_string($addname), 'maxlength="100" size="30"');
 306         $mform->setType($addname, PARAM_NOTAGS);
 307     }
 308
 309     // Do not show email field if change confirmation is pending.
 310     if ($user->id > 0 and !empty($CFG->emailchangeconfirmation) and !empty($user->preference_newemail)) {
 311         $notice = get_string('emailchangepending', 'auth', $user);
 312         $notice .= '<br /><a href="edit.php?cancelemailchange=1&amp;id='.$user->id.'">'
 313                 . get_string('emailchangecancel', 'auth') . '</a>';
 314         $mform->addElement('static', 'emailpending', get_string('email'), $notice);
 315     } else {
 316         $mform->addElement('text', 'email', get_string('email'), 'maxlength="100" size="30"');
 317         $mform->addRule('email', $strrequired, 'required', null, 'client');
 318         $mform->setType('email', PARAM_RAW_TRIMMED);
 319     }
 320
 321     $choices = array();
 322     $choices['0'] = get_string('emaildisplayno');
 323     $choices['1'] = get_string('emaildisplayyes');
 324     $choices['2'] = get_string('emaildisplaycourse');
 325     $mform->addElement('select', 'maildisplay', get_string('emaildisplay'), $choices);
 326     $mform->setDefault('maildisplay', $CFG->defaultpreference_maildisplay);
 327
 328     $mform->addElement('text', 'city', get_string('city'), 'maxlength="120" size="21"');
 329     $mform->setType('city', PARAM_TEXT);
 330     if (!empty($CFG->defaultcity)) {
 331         $mform->setDefault('city', $CFG->defaultcity);
 332     }
 333
 334     $choices = get_string_manager()->get_list_of_countries();
 335     $choices = array('' => get_string('selectacountry') . '...') + $choices;
 336     $mform->addElement('select', 'country', get_string('selectacountry'), $choices);
 337     if (!empty($CFG->country)) {
 338         $mform->setDefault('country', $CFG->country);
 339     }
 340
 341     if (isset($CFG->forcetimezone) and $CFG->forcetimezone != 99) {
 342         $choices = core_date::get_list_of_timezones($CFG->forcetimezone);
 343         $mform->addElement('static', 'forcedtimezone', get_string('timezone'), $choices[$CFG->forcetimezone]);
 344         $mform->addElement('hidden', 'timezone');
 345         $mform->setType('timezone', PARAM_TIMEZONE);
 346     } else {
 347         $choices = core_date::get_list_of_timezones($user->timezone, true);
 348         $mform->addElement('select', 'timezone', get_string('timezone'), $choices);
 349     }
 350
 351     // Multi-Calendar Support - see MDL-18375.
 352     $calendartypes = \core_calendar\type_factory::get_list_of_calendar_types();
 353     // We do not want to show this option unless there is more than one calendar type to display.
 354     if (count($calendartypes) > 1) {
 355         $mform->addElement('select', 'calendartype', get_string('preferredcalendar', 'calendar'), $calendartypes);
 356         $mform->setDefault('calendartype', $CFG->calendartype);
 357     }
 358
 359     if (!empty($CFG->allowuserthemes)) {
 360         $choices = array();
 361         $choices[''] = get_string('default');
 362         $themes = get_list_of_themes();
 363         foreach ($themes as $key => $theme) {
 364             if (empty($theme->hidefromselector)) {
 365                 $choices[$key] = get_string('pluginname', 'theme_'.$theme->name);
 366             }
 367         }
 368         $mform->addElement('select', 'theme', get_string('preferredtheme'), $choices);
 369     }
 370
 371     $mform->addElement('editor', 'description_editor', get_string('userdescription'), null, $editoroptions);
 372     $mform->setType('description_editor', PARAM_CLEANHTML);
 373     $mform->addHelpButton('description_editor', 'userdescription');
 374
 375     if (empty($USER->newadminuser)) {
 376         $mform->addElement('header', 'moodle_picture', get_string('pictureofuser'));
 377         $mform->setExpanded('moodle_picture', true);
 378
 379         if (!empty($CFG->enablegravatar)) {
 380             $mform->addElement('html', html_writer::tag('p', get_string('gravatarenabled')));
 381         }
 382
 383         $mform->addElement('static', 'currentpicture', get_string('currentpicture'));
 384
 385         $mform->addElement('checkbox', 'deletepicture', get_string('delete'));
 386         $mform->setDefault('deletepicture', 0);
 387
 388         $mform->addElement('filemanager', 'imagefile', get_string('newpicture'), '', $filemanageroptions);
 389         $mform->addHelpButton('imagefile', 'newpicture');
 390
 391         $mform->addElement('text', 'imagealt', get_string('imagealt'), 'maxlength="100" size="30"');
 392         $mform->setType('imagealt', PARAM_TEXT);
 393
 394     }
 395
 396     // Display user name fields that are not currenlty enabled here if there are any.
 397     $disabledusernamefields = useredit_get_disabled_name_fields($enabledusernamefields);
 398     if (count($disabledusernamefields) > 0) {
 399         $mform->addElement('header', 'moodle_additional_names', get_string('additionalnames'));
 400         foreach ($disabledusernamefields as $allname) {
 401             $mform->addElement('text', $allname, get_string($allname), 'maxlength="100" size="30"');
 402             $mform->setType($allname, PARAM_NOTAGS);
 403         }
 404     }
 405
 406     if (!empty($CFG->usetags) and empty($USER->newadminuser)) {
 407         $mform->addElement('header', 'moodle_interests', get_string('interests'));
 408         $mform->addElement('tags', 'interests', get_string('interestslist'), array('display' => 'noofficial'));
 409         $mform->addHelpButton('interests', 'interestslist');
 410     }
 411
 412     // Moodle optional fields.
 413     $mform->addElement('header', 'moodle_optional', get_string('optional', 'form'));
 414
 415     $mform->addElement('text', 'url', get_string('webpage'), 'maxlength="255" size="50"');
 416     $mform->setType('url', PARAM_URL);
 417
 418     $mform->addElement('text', 'icq', get_string('icqnumber'), 'maxlength="15" size="25"');
 419     $mform->setType('icq', PARAM_NOTAGS);
 420
 421     $mform->addElement('text', 'skype', get_string('skypeid'), 'maxlength="50" size="25"');
 422     $mform->setType('skype', PARAM_NOTAGS);
 423
 424     $mform->addElement('text', 'aim', get_string('aimid'), 'maxlength="50" size="25"');
 425     $mform->setType('aim', PARAM_NOTAGS);
 426
 427     $mform->addElement('text', 'yahoo', get_string('yahooid'), 'maxlength="50" size="25"');
 428     $mform->setType('yahoo', PARAM_NOTAGS);
 429
 430     $mform->addElement('text', 'msn', get_string('msnid'), 'maxlength="50" size="25"');
 431     $mform->setType('msn', PARAM_NOTAGS);
 432
 433     $mform->addElement('text', 'idnumber', get_string('idnumber'), 'maxlength="255" size="25"');
 434     $mform->setType('idnumber', PARAM_NOTAGS);
 435
 436     $mform->addElement('text', 'institution', get_string('institution'), 'maxlength="255" size="25"');
 437     $mform->setType('institution', PARAM_TEXT);
 438
 439     $mform->addElement('text', 'department', get_string('department'), 'maxlength="255" size="25"');
 440     $mform->setType('department', PARAM_TEXT);
 441
 442     $mform->addElement('text', 'phone1', get_string('phone1'), 'maxlength="20" size="25"');
 443     $mform->setType('phone1', PARAM_NOTAGS);
 444
 445     $mform->addElement('text', 'phone2', get_string('phone2'), 'maxlength="20" size="25"');
 446     $mform->setType('phone2', PARAM_NOTAGS);
 447
 448     $mform->addElement('text', 'address', get_string('address'), 'maxlength="255" size="25"');
 449     $mform->setType('address', PARAM_TEXT);
 450 }
 451
 452 /**
 453  * Return required user name fields for forms.
 454  *
 455  * @return array required user name fields in order according to settings.
 456  */
 457 function useredit_get_required_name_fields() {
 458     global $CFG;
 459
 460     // Get the name display format.
 461     $nameformat = $CFG->fullnamedisplay;
 462
 463     // Names that are required fields on user forms.
 464     $necessarynames = array('firstname', 'lastname');
 465     $languageformat = get_string('fullnamedisplay');
 466
 467     // Check that the language string and the $nameformat contain the necessary names.
 468     foreach ($necessarynames as $necessaryname) {
 469         $pattern = "/$necessaryname\b/";
 470         if (!preg_match($pattern, $languageformat)) {
 471             // If the language string has been altered then fall back on the below order.
 472             $languageformat = 'firstname lastname';
 473         }
 474         if (!preg_match($pattern, $nameformat)) {
 475             // If the nameformat doesn't contain the necessary name fields then use the languageformat.
 476             $nameformat = $languageformat;
 477         }
 478     }
 479
 480     // Order all of the name fields in the postion they are written in the fullnamedisplay setting.
 481     $necessarynames = order_in_string($necessarynames, $nameformat);
 482     return $necessarynames;
 483 }
 484
 485 /**
 486  * Gets enabled (from fullnameformate setting) user name fields in appropriate order.
 487  *
 488  * @return array Enabled user name fields.
 489  */
 490 function useredit_get_enabled_name_fields() {
 491     global $CFG;
 492
 493     // Get all of the other name fields which are not ranked as necessary.
 494     $additionalusernamefields = array_diff(get_all_user_name_fields(), array('firstname', 'lastname'));
 495     // Find out which additional name fields are actually being used from the fullnamedisplay setting.
 496     $enabledadditionalusernames = array();
 497     foreach ($additionalusernamefields as $enabledname) {
 498         if (strpos($CFG->fullnamedisplay, $enabledname) !== false) {
 499             $enabledadditionalusernames[] = $enabledname;
 500         }
 501     }
 502
 503     // Order all of the name fields in the postion they are written in the fullnamedisplay setting.
 504     $enabledadditionalusernames = order_in_string($enabledadditionalusernames, $CFG->fullnamedisplay);
 505     return $enabledadditionalusernames;
 506 }
 507
 508 /**
 509  * Gets user name fields not enabled from the setting fullnamedisplay.
 510  *
 511  * @param array $enabledadditionalusernames Current enabled additional user name fields.
 512  * @return array Disabled user name fields.
 513  */
 514 function useredit_get_disabled_name_fields($enabledadditionalusernames = null) {
 515     // If we don't have enabled additional user name information then go and fetch it (try to avoid).
 516     if (!isset($enabledadditionalusernames)) {
 517         $enabledadditionalusernames = useredit_get_enabled_name_fields();
 518     }
 519
 520     // These are the additional fields that are not currently enabled.
 521     $nonusednamefields = array_diff(get_all_user_name_fields(),
 522             array_merge(array('firstname', 'lastname'), $enabledadditionalusernames));
 523     return $nonusednamefields;
 524 }