group/members.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 /**
  19  * Add/remove members from group.
  20  *
  21  * @copyright 2006 The Open University and others, N.D.Freear AT open.ac.uk, J.White AT open.ac.uk and others
  22  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  23  * @package   core_group
  24  */
  25 require_once(__DIR__ . '/../config.php');
  26 require_once(__DIR__ . '/lib.php');
  27 require_once($CFG->dirroot . '/user/selector/lib.php');
  28 require_once($CFG->dirroot . '/course/lib.php');
  29 require_once($CFG->libdir . '/filelib.php');
  30
  31 $groupid = required_param('group', PARAM_INT);
  32 $cancel  = optional_param('cancel', false, PARAM_BOOL);
  33
  34 $group = $DB->get_record('groups', array('id'=>$groupid), '*', MUST_EXIST);
  35 $course = $DB->get_record('course', array('id'=>$group->courseid), '*', MUST_EXIST);
  36
  37 $PAGE->set_url('/group/members.php', array('group'=>$groupid));
  38 $PAGE->set_pagelayout('admin');
  39
  40 require_login($course);
  41 $context = context_course::instance($course->id);
  42 require_capability('moodle/course:managegroups', $context);
  43
  44 $returnurl = $CFG->wwwroot.'/group/index.php?id='.$course->id.'&group='.$group->id;
  45
  46 if ($cancel) {
  47     redirect($returnurl);
  48 }
  49
  50 $groupmembersselector = new group_members_selector('removeselect', array('groupid' => $groupid, 'courseid' => $course->id));
  51 $potentialmembersselector = new group_non_members_selector('addselect', array('groupid' => $groupid, 'courseid' => $course->id));
  52
  53 if (optional_param('add', false, PARAM_BOOL) && confirm_sesskey()) {
  54     $userstoadd = $potentialmembersselector->get_selected_users();
  55     if (!empty($userstoadd)) {
  56         foreach ($userstoadd as $user) {
  57             if (!groups_add_member($groupid, $user->id)) {
  58                 print_error('erroraddremoveuser', 'group', $returnurl);
  59             }
  60             $groupmembersselector->invalidate_selected_users();
  61             $potentialmembersselector->invalidate_selected_users();
  62         }
  63     }
  64 }
  65
  66 if (optional_param('remove', false, PARAM_BOOL) && confirm_sesskey()) {
  67     $userstoremove = $groupmembersselector->get_selected_users();
  68     if (!empty($userstoremove)) {
  69         foreach ($userstoremove as $user) {
  70             if (!groups_remove_member_allowed($groupid, $user->id)) {
  71                 print_error('errorremovenotpermitted', 'group', $returnurl,
  72                         $user->fullname);
  73             }
  74             if (!groups_remove_member($groupid, $user->id)) {
  75                 print_error('erroraddremoveuser', 'group', $returnurl);
  76             }
  77             $groupmembersselector->invalidate_selected_users();
  78             $potentialmembersselector->invalidate_selected_users();
  79         }
  80     }
  81 }
  82
  83 // Print the page and form
  84 $strgroups = get_string('groups');
  85 $strparticipants = get_string('participants');
  86 $stradduserstogroup = get_string('adduserstogroup', 'group');
  87 $strusergroupmembership = get_string('usergroupmembership', 'group');
  88
  89 $groupname = format_string($group->name);
  90
  91 $PAGE->requires->js('/group/clientlib.js');
  92 $PAGE->navbar->add($strparticipants, new moodle_url('/user/index.php', array('id'=>$course->id)));
  93 $PAGE->navbar->add($strgroups, new moodle_url('/group/index.php', array('id'=>$course->id)));
  94 $PAGE->navbar->add($stradduserstogroup);
  95
  96 /// Print header
  97 $PAGE->set_title("$course->shortname: $strgroups");
  98 $PAGE->set_heading($course->fullname);
  99 echo $OUTPUT->header();
 100 echo $OUTPUT->heading(get_string('adduserstogroup', 'group').": $groupname", 3);
 101
 102 // Store the rows we want to display in the group info.
 103 $groupinforow = array();
 104
 105 // Check if there is a picture to display.
 106 if (!empty($group->picture)) {
 107     $picturecell = new html_table_cell();
 108     $picturecell->attributes['class'] = 'left side picture';
 109     $picturecell->text = print_group_picture($group, $course->id, true, true, false);
 110     $groupinforow[] = $picturecell;
 111 }
 112
 113 // Check if there is a description to display.
 114 $group->description = file_rewrite_pluginfile_urls($group->description, 'pluginfile.php', $context->id, 'group', 'description', $group->id);
 115 if (!empty($group->description)) {
 116     if (!isset($group->descriptionformat)) {
 117         $group->descriptionformat = FORMAT_MOODLE;
 118     }
 119
 120     $options = new stdClass;
 121     $options->overflowdiv = true;
 122
 123     $contentcell = new html_table_cell();
 124     $contentcell->attributes['class'] = 'content';
 125     $contentcell->text = format_text($group->description, $group->descriptionformat, $options);
 126     $groupinforow[] = $contentcell;
 127 }
 128
 129 // Check if we have something to show.
 130 if (!empty($groupinforow)) {
 131     $groupinfotable = new html_table();
 132     $groupinfotable->attributes['class'] = 'groupinfobox';
 133     $groupinfotable->data[] = new html_table_row($groupinforow);
 134     echo html_writer::table($groupinfotable);
 135 }
 136
 137 /// Print the editing form
 138 ?>
 139
 140 <div id="addmembersform">
 141     <form id="assignform" method="post" action="<?php echo $CFG->wwwroot; ?>/group/members.php?group=<?php echo $groupid; ?>">
 142     <div>
 143     <input type="hidden" name="sesskey" value="<?php p(sesskey()); ?>" />
 144
 145     <table class="generaltable generalbox groupmanagementtable boxaligncenter" summary="">
 146     <tr>
 147       <td id='existingcell'>
 148           <p>
 149             <label for="removeselect"><?php print_string('groupmembers', 'group'); ?></label>
 150           </p>
 151           <?php $groupmembersselector->display(); ?>
 152           </td>
 153       <td id='buttonscell'>
 154         <p class="arrow_button">
 155             <input name="add" id="add" type="submit" value="<?php echo $OUTPUT->larrow().'&nbsp;'.get_string('add'); ?>" title="<?php print_string('add'); ?>" /><br />
 156             <input name="remove" id="remove" type="submit" value="<?php echo get_string('remove').'&nbsp;'.$OUTPUT->rarrow(); ?>" title="<?php print_string('remove'); ?>" />
 157         </p>
 158       </td>
 159       <td id='potentialcell'>
 160           <p>
 161             <label for="addselect"><?php print_string('potentialmembs', 'group'); ?></label>
 162           </p>
 163           <?php $potentialmembersselector->display(); ?>
 164       </td>
 165       <td>
 166         <p><?php echo($strusergroupmembership) ?></p>
 167         <div id="group-usersummary"></div>
 168       </td>
 169     </tr>
 170     <tr><td colspan="3" id='backcell'>
 171         <input type="submit" name="cancel" value="<?php print_string('backtogroups', 'group'); ?>" />
 172     </td></tr>
 173     </table>
 174     </div>
 175     </form>
 176 </div>
 177
 178 <?php
 179     //outputs the JS array used to display the other groups users are in
 180     $potentialmembersselector->print_user_summaries($course->id);
 181
 182     //this must be after calling display() on the selectors so their setup JS executes first
 183     $PAGE->requires->js_init_call('init_add_remove_members_page', null, false, $potentialmembersselector->get_js_module());
 184
 185     echo $OUTPUT->footer();