weekly release 3.10.1+
[moodle.git] / 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/>.
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');
31 $groupid = required_param('group', PARAM_INT);
32 $cancel  = optional_param('cancel', false, PARAM_BOOL);
34 $group = $DB->get_record('groups', array('id'=>$groupid), '*', MUST_EXIST);
35 $course = $DB->get_record('course', array('id'=>$group->courseid), '*', MUST_EXIST);
37 $PAGE->set_url('/group/members.php', array('group'=>$groupid));
38 $PAGE->set_pagelayout('admin');
40 require_login($course);
41 $context = context_course::instance($course->id);
42 require_capability('moodle/course:managegroups', $context);
44 $returnurl = $CFG->wwwroot.'/group/index.php?id='.$course->id.'&group='.$group->id;
46 if ($cancel) {
47     redirect($returnurl);
48 }
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));
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 }
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 }
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');
89 $groupname = format_string($group->name);
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);
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);
102 // Store the rows we want to display in the group info.
103 $groupinforow = array();
105 // Check if there is a description to display.
106 if (!empty($group->description)) {
107     $grouprenderer = $PAGE->get_renderer('core_group');
108     $groupdetailpage = new \core_group\output\group_details($groupid);
109     echo $grouprenderer->group_details($groupdetailpage);
112 /// Print the editing form
113 ?>
115 <div id="addmembersform">
116     <form id="assignform" method="post" action="<?php echo $CFG->wwwroot; ?>/group/members.php?group=<?php echo $groupid; ?>">
117     <div>
118     <input type="hidden" name="sesskey" value="<?php p(sesskey()); ?>" />
120     <table class="generaltable generalbox groupmanagementtable boxaligncenter" summary="">
121     <tr>
122       <td id='existingcell'>
123           <p>
124             <label for="removeselect"><?php print_string('groupmembers', 'group'); ?></label>
125           </p>
126           <?php $groupmembersselector->display(); ?>
127           </td>
128       <td id='buttonscell'>
129         <p class="arrow_button">
130             <input class="btn btn-secondary" name="add" id="add"
131                    type="submit" value="<?php echo $OUTPUT->larrow().'&nbsp;'.get_string('add'); ?>"
132                    title="<?php print_string('add'); ?>" /><br />
133             <input class="btn btn-secondary" name="remove" id="remove"
134                    type="submit" value="<?php echo get_string('remove').'&nbsp;'.$OUTPUT->rarrow(); ?>"
135                    title="<?php print_string('remove'); ?>" />
136         </p>
137       </td>
138       <td id='potentialcell'>
139           <p>
140             <label for="addselect"><?php print_string('potentialmembs', 'group'); ?></label>
141           </p>
142           <?php $potentialmembersselector->display(); ?>
143       </td>
144       <td>
145         <p><?php echo($strusergroupmembership) ?></p>
146         <div id="group-usersummary"></div>
147       </td>
148     </tr>
149     <tr><td colspan="3" id='backcell'>
150         <input class="btn btn-secondary" type="submit" name="cancel"
151                value="<?php print_string('backtogroups', 'group'); ?>" />
152     </td></tr>
153     </table>
154     </div>
155     </form>
156 </div>
158 <?php
159     //outputs the JS array used to display the other groups users are in
160     $potentialmembersselector->print_user_summaries($course->id);
162     //this must be after calling display() on the selectors so their setup JS executes first
163     $PAGE->requires->js_init_call('init_add_remove_members_page', null, false, $potentialmembersselector->get_js_module());
165     echo $OUTPUT->footer();