group_edit.php 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377
  1. <?php
  2. /* For licensing terms, see /license.txt */
  3. /**
  4. * This script displays an area where teachers can edit the group properties and member list.
  5. * Groups are also often called "teams" in the Dokeos code.
  6. *
  7. * @author various contributors
  8. * @author Roan Embrechts (VUB), partial code cleanup, initial virtual course support
  9. * @package chamilo.group
  10. * @todo course admin functionality to create groups based on who is in which course (or class).
  11. */
  12. /* INIT SECTION */
  13. // Name of the language file that needs to be included
  14. $language_file = 'group';
  15. require '../inc/global.inc.php';
  16. $this_section = SECTION_COURSES;
  17. /* Libraries & settings */
  18. require_once api_get_path(LIBRARY_PATH).'groupmanager.lib.php';
  19. /* Constants & variables */
  20. $current_group = GroupManager :: get_group_properties(api_get_group_id());
  21. /* Header */
  22. $nameTools = get_lang('EditGroup');
  23. $interbreadcrumb[] = array ('url' => 'group.php', 'name' => get_lang('Groups'));
  24. $is_group_member = GroupManager :: is_tutor_of_group(api_get_user_id(), api_get_group_id());
  25. if (!api_is_allowed_to_edit(false,true) && !$is_group_member) {
  26. api_not_allowed(true);
  27. }
  28. /* FUNCTIONS */
  29. /**
  30. * List all users registered to the course
  31. */
  32. function search_members_keyword($firstname, $lastname, $username, $official_code, $keyword) {
  33. if (api_strripos($firstname, $keyword) !== false || api_strripos($lastname, $keyword) !== false || api_strripos($username, $keyword) !== false || api_strripos($official_code, $keyword) !== false) {
  34. return true;
  35. } else {
  36. return false;
  37. }
  38. }
  39. /**
  40. * function to sort users after getting the list in the db. Necessary because there are 2 or 3 queries. Called by usort()
  41. */
  42. function sort_users($user_a, $user_b) {
  43. if (api_sort_by_first_name()) {
  44. $cmp = api_strcmp($user_a['firstname'], $user_b['firstname']);
  45. if ($cmp !== 0) {
  46. return $cmp;
  47. } else {
  48. $cmp = api_strcmp($user_a['lastname'], $user_b['lastname']);
  49. if ($cmp !== 0) {
  50. return $cmp;
  51. } else {
  52. return api_strcmp($user_a['username'], $user_b['username']);
  53. }
  54. }
  55. } else {
  56. $cmp = api_strcmp($user_a['lastname'], $user_b['lastname']);
  57. if ($cmp !== 0) {
  58. return $cmp;
  59. } else {
  60. $cmp = api_strcmp($user_a['firstname'], $user_b['firstname']);
  61. if ($cmp !== 0) {
  62. return $cmp;
  63. } else {
  64. return api_strcmp($user_a['username'], $user_b['username']);
  65. }
  66. }
  67. }
  68. }
  69. /**
  70. * Function to check the given max number of members per group
  71. */
  72. function check_max_number_of_members($value) {
  73. $max_member_no_limit = $value['max_member_no_limit'];
  74. if ($max_member_no_limit == MEMBER_PER_GROUP_NO_LIMIT) {
  75. return true;
  76. }
  77. $max_member = $value['max_member'];
  78. return is_numeric($max_member);
  79. }
  80. /**
  81. * Function to check if the number of selected group members is valid
  82. */
  83. function check_group_members($value) {
  84. if ($value['max_member_no_limit'] == MEMBER_PER_GROUP_NO_LIMIT) {
  85. return true;
  86. }
  87. if (isset($value['max_member']) && isset($value['group_members']) && $value['max_member'] < count($value['group_members'])) {
  88. return array ('group_members' => get_lang('GroupTooMuchMembers'));
  89. }
  90. return true;
  91. }
  92. /* MAIN CODE */
  93. // Build form
  94. $form = new FormValidator('group_edit');
  95. $form->addElement('header', '', $nameTools);
  96. $form->addElement('hidden', 'action');
  97. $form->addElement('hidden', 'referer');
  98. // Group name
  99. $form->add_textfield('name', get_lang('GroupName'));
  100. // Description
  101. $form->addElement('textarea', 'description', get_lang('Description'), array ('cols' => 50, 'rows' => 6));
  102. // Search Members of group
  103. //$form = new FormValidator('search_member', 'get', 'group_edit', '', null, false);
  104. //$renderer = & $form->defaultRenderer();
  105. //$renderer->setElementTemplate('<span>{element}</span> ');
  106. //$form->add_textfield('keyword', get_lang('GroupMembers'), false);
  107. //$form->addElement('style_submit_button', 'submit', get_lang('Search'), 'class="search"');
  108. // Getting all the users
  109. /*
  110. if (isset($_SESSION['id_session'])) {
  111. $complete_user_list = CourseManager :: get_user_list_from_course_code($_course['id'], true, $_SESSION['id_session']);
  112. $complete_user_list2 = CourseManager :: get_coach_list_from_course_code($_course['id'], $_SESSION['id_session']);
  113. $complete_user_list = array_merge($complete_user_list, $complete_user_list2);
  114. } else {
  115. $complete_user_list = CourseManager :: get_user_list_from_course_code($_course['id']);
  116. }
  117. foreach ($complete_user_list as $user_id => $o_course_user) {
  118. if ((isset ($_GET['keyword']) && search_members_keyword($o_course_user['firstname'], $o_course_user['lastname'], $o_course_user['username'], $o_course_user['official_code'], $_GET['keyword'])) || !isset($_GET['keyword']) || empty($_GET['keyword'])) {
  119. $groups_name = GroupManager :: get_user_group_name($user_id);
  120. if ($is_western_name_order) {
  121. $temp[] = $o_course_user['firstname'];
  122. $temp[] = $o_course_user['lastname'];
  123. } else {
  124. $temp[] = $o_course_user['lastname'];
  125. $temp[] = $o_course_user['firstname'];
  126. }
  127. $temp[] = $o_course_user['role'];
  128. $temp[] = implode(', ', $groups_name); //Group
  129. $temp[] = $o_course_user['official_code'];
  130. }
  131. }*/
  132. $complete_user_list = GroupManager :: fill_groups_list($current_group['id']);
  133. usort($complete_user_list, 'sort_users');
  134. $possible_users = array();
  135. foreach ($complete_user_list as $index => $user) {
  136. $possible_users[$user['user_id']] = api_get_person_name($user['firstname'], $user['lastname']).' ('.$user['username'].')';
  137. }
  138. // Group tutors
  139. $group_tutor_list = GroupManager :: get_subscribed_tutors($current_group['id']);
  140. $selected_users = array();
  141. $selected_tutors = array();
  142. foreach ($group_tutor_list as $index => $user) {
  143. //$possible_users[$user['user_id']] = api_get_person_name($user['firstname'], .$user['lastname']);
  144. $selected_tutors[] = $user['user_id'];
  145. }
  146. $group_tutors_element = $form->addElement('advmultiselect', 'group_tutors', get_lang('GroupTutors'), $possible_users, 'style="width: 280px;"');
  147. $group_tutors_element->setElementTemplate('
  148. {javascript}
  149. <table{class}>
  150. <!-- BEGIN label_2 --><tr><th>{label_2}</th><!-- END label_2 -->
  151. <!-- BEGIN label_3 --><th>&nbsp;</th><th>{label_3}</th></tr><!-- END label_3 -->
  152. <tr>
  153. <td valign="top">{unselected}</td>
  154. <td align="center">{add}<br /><br />{remove}</td>
  155. <td valign="top">{selected}</td>
  156. </tr>
  157. </table>
  158. ');
  159. $group_tutors_element->setButtonAttributes('add', array('class' => 'arrowr'));
  160. $group_tutors_element->setButtonAttributes('remove', array('class' => 'arrowl'));
  161. // Group members
  162. $group_member_list = GroupManager :: get_subscribed_users($current_group['id']);
  163. $selected_users = array ();
  164. foreach ($group_member_list as $index => $user) {
  165. //$possible_users[$user['user_id']] = api_get_person_name($user['firstname'], $user['lastname']);
  166. $selected_users[] = $user['user_id'];
  167. }
  168. // possible : number_groups_left > 0 and is group member
  169. $possible_users = array();
  170. foreach ($complete_user_list as $index => $user) {
  171. if( $user['number_groups_left'] >0 || in_array($user['user_id'],$selected_users) )
  172. $possible_users[$user['user_id']] = api_get_person_name($user['firstname'], $user['lastname']).' ('.$user['username'].')';
  173. }
  174. $group_members_element = $form->addElement('advmultiselect', 'group_members', get_lang('GroupMembers'), $possible_users, 'style="width: 280px;"');
  175. $group_members_element->setElementTemplate('
  176. {javascript}
  177. <table{class}>
  178. <!-- BEGIN label_2 --><tr><th>{label_2}</th><!-- END label_2 -->
  179. <!-- BEGIN label_3 --><th>&nbsp;</th><th>{label_3}</th></tr><!-- END label_3 -->
  180. <tr>
  181. <td valign="top">{unselected}</td>
  182. <td align="center">{add}<br /><br />{remove}</td>
  183. <td valign="top">{selected}</td>
  184. </tr>
  185. </table>');
  186. $group_members_element->setButtonAttributes('add', array('class' => 'arrowr'));
  187. $group_members_element->setButtonAttributes('remove', array('class' => 'arrowl'));
  188. $form->addFormRule('check_group_members');
  189. // Tutors: this has been replaced with the new tutors code
  190. //$tutors = GroupManager :: get_all_tutors();
  191. //$possible_tutors[0] = get_lang('GroupNoTutor');
  192. //foreach ($tutors as $index => $tutor)
  193. //{
  194. // $possible_tutors[$tutor['user_id']] = api_get_person_name($tutor['lastname'], $tutor['firstname']);
  195. //}
  196. //$group = array ();
  197. //$group[] = & $form->createElement('select', 'tutor_id', null, $possible_tutors);
  198. //$group[] = & $form->createElement('static', null, null, '&nbsp;&nbsp;<a href="../user/user.php">'.get_lang('AddTutors').'</a>');
  199. //$form->addGroup($group, 'tutor_group', get_lang('GroupTutor'), '', false);
  200. // Members per group
  201. $form->addElement('radio', 'max_member_no_limit', get_lang('GroupLimit'), get_lang('NoLimit'), MEMBER_PER_GROUP_NO_LIMIT);
  202. $group = array();
  203. $group[] = & $form->createElement('radio', 'max_member_no_limit', null, get_lang('MaximumOfParticipants'), 1);
  204. $group[] = & $form->createElement('text', 'max_member', null, array('size' => 2));
  205. $group[] = & $form->createElement('static', null, null, get_lang('GroupPlacesThis'));
  206. $form->addGroup($group, 'max_member_group', null, '', false);
  207. $form->addRule('max_member_group', get_lang('InvalidMaxNumberOfMembers'), 'callback', 'check_max_number_of_members');
  208. // Self registration
  209. $group = array();
  210. $group[] = $form->createElement('checkbox', 'self_registration_allowed', get_lang('GroupSelfRegistration'), get_lang('GroupAllowStudentRegistration'), 1);
  211. $group[] = $form->createElement('checkbox', 'self_unregistration_allowed', null, get_lang('GroupAllowStudentUnregistration'), 1);
  212. $form->addGroup($group, '', Display::return_icon('user.png', get_lang('GroupSelfRegistration') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupSelfRegistration'), '', false);
  213. // Documents settings
  214. $group = array();
  215. $group[] = $form->createElement('radio', 'doc_state', get_lang('GroupDocument'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  216. $group[] = $form->createElement('radio', 'doc_state', null, get_lang('Public'), TOOL_PUBLIC);
  217. $group[] = $form->createElement('radio', 'doc_state', null, get_lang('Private'), TOOL_PRIVATE);
  218. $form->addGroup($group, '', Display::return_icon('folder.png', get_lang('GroupDocument') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupDocument'), '', false);
  219. // Work settings
  220. $group = array();
  221. $group[] = $form->createElement('radio', 'work_state', get_lang('GroupWork'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  222. $group[] = $form->createElement('radio', 'work_state', null, get_lang('Public'), TOOL_PUBLIC);
  223. $group[] = $form->createElement('radio', 'work_state', null, get_lang('Private'), TOOL_PRIVATE);
  224. $form->addGroup($group, '', Display::return_icon('work.png', get_lang('GroupWork') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupWork'), '', false);
  225. // Calendar settings
  226. $group = array();
  227. $group[] = $form->createElement('radio', 'calendar_state', get_lang('GroupCalendar'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  228. $group[] = $form->createElement('radio', 'calendar_state', null, get_lang('Public'), TOOL_PUBLIC);
  229. $group[] = $form->createElement('radio', 'calendar_state', null, get_lang('Private'), TOOL_PRIVATE);
  230. $form->addGroup($group, '', Display::return_icon('agenda.png', get_lang('GroupCalendar') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupCalendar'), '', false);
  231. // Announcements settings
  232. $group = array();
  233. $group[] = $form->createElement('radio', 'announcements_state', get_lang('GroupAnnouncements'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  234. $group[] = $form->createElement('radio', 'announcements_state', null, get_lang('Public'), TOOL_PUBLIC);
  235. $group[] = $form->createElement('radio', 'announcements_state', null, get_lang('Private'), TOOL_PRIVATE);
  236. $form->addGroup($group, '', Display::return_icon('announce.png', get_lang('GroupAnnouncements') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupAnnouncements'), '', false);
  237. //Forum settings
  238. $group = array();
  239. $group[] = $form->createElement('radio', 'forum_state', get_lang('GroupForum'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  240. $group[] = $form->createElement('radio', 'forum_state', null, get_lang('Public'), TOOL_PUBLIC);
  241. $group[] = $form->createElement('radio', 'forum_state', null, get_lang('Private'), TOOL_PRIVATE);
  242. $form->addGroup($group, '', Display::return_icon('forum.png', get_lang('GroupForum') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupForum'), '', false);
  243. // Wiki settings
  244. $group = array();
  245. $group[] = $form->createElement('radio', 'wiki_state', get_lang('GroupWiki'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  246. $group[] = $form->createElement('radio', 'wiki_state', null, get_lang('Public'), TOOL_PUBLIC);
  247. $group[] = $form->createElement('radio', 'wiki_state', null, get_lang('Private'), TOOL_PRIVATE);
  248. $form->addGroup($group, '', Display::return_icon('wiki.png', get_lang('GroupWiki') , array(), ICON_SIZE_SMALL).' '.get_lang('GroupWiki'), '', false);
  249. // Chat settings
  250. $group = array();
  251. $group[] = $form->createElement('radio', 'chat_state', get_lang('Chat'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
  252. $group[] = $form->createElement('radio', 'chat_state', null, get_lang('Public'), TOOL_PUBLIC);
  253. $group[] = $form->createElement('radio', 'chat_state', null, get_lang('Private'), TOOL_PRIVATE);
  254. $form->addGroup($group, '', Display::return_icon('chat.png', get_lang('Chat') , array(), ICON_SIZE_SMALL).' '.get_lang('Chat'), '', false);
  255. // submit button
  256. $form->addElement('style_submit_button', 'submit', get_lang('PropModify'), 'class="save"');
  257. if ($form->validate()) {
  258. $values = $form->exportValues();
  259. if ($values['max_member_no_limit'] == MEMBER_PER_GROUP_NO_LIMIT) {
  260. $max_member = MEMBER_PER_GROUP_NO_LIMIT;
  261. } else {
  262. $max_member = $values['max_member'];
  263. }
  264. $self_registration_allowed = isset($values['self_registration_allowed']) ? 1 : 0;
  265. $self_unregistration_allowed = isset($values['self_unregistration_allowed']) ? 1 : 0;
  266. GroupManager :: set_group_properties($current_group['id'], strip_tags($values['name']), strip_tags($values['description']), $max_member, $values['doc_state'], $values['work_state'], $values['calendar_state'], $values['announcements_state'], $values['forum_state'], $values['wiki_state'], $values['chat_state'], $self_registration_allowed, $self_unregistration_allowed);
  267. // Storing the tutors (we first remove all the tutors and then add only those who were selected)
  268. GroupManager :: unsubscribe_all_tutors($current_group['id']);
  269. if (isset ($_POST['group_tutors']) && count($_POST['group_tutors']) > 0) {
  270. GroupManager :: subscribe_tutors($values['group_tutors'], $current_group['id']);
  271. }
  272. // Storing the users (we first remove all users and then add only those who were selected)
  273. GroupManager :: unsubscribe_all_users($current_group['id']);
  274. if (isset ($_POST['group_members']) && count($_POST['group_members']) > 0) {
  275. GroupManager :: subscribe_users($values['group_members'], $current_group['id']);
  276. }
  277. // Returning to the group area (note: this is inconsistent with the rest of chamilo)
  278. //var_dump(count($_POST['group_members']), $max_member, MEMBER_PER_GROUP_NO_LIMIT);
  279. $cat = GroupManager :: get_category_from_group($current_group['id']);
  280. if (isset($_POST['group_members']) && count($_POST['group_members']) > $max_member && $max_member != MEMBER_PER_GROUP_NO_LIMIT) {
  281. header('Location:group_edit.php?show_message='.get_lang('GroupTooMuchMembers'));
  282. } else {
  283. header('Location: '.$values['referer'].'?action=show_msg&msg='.get_lang('GroupSettingsModified').'&category='.$cat['id']);
  284. }
  285. }
  286. $defaults = $current_group;
  287. $defaults['group_members'] = $selected_users;
  288. $defaults['group_tutors'] = $selected_tutors;
  289. $action = isset($_GET['action']) ? $_GET['action'] : '';
  290. $defaults['action'] = $action;
  291. if ($defaults['maximum_number_of_students'] == MEMBER_PER_GROUP_NO_LIMIT) {
  292. $defaults['max_member_no_limit'] = MEMBER_PER_GROUP_NO_LIMIT;
  293. } else {
  294. $defaults['max_member_no_limit'] = 1;
  295. $defaults['max_member'] = $defaults['maximum_number_of_students'];
  296. }
  297. $referer = parse_url($_SERVER['HTTP_REFERER']);
  298. $referer = basename($referer['path']);
  299. if ($referer != 'group_space.php' && $referer != 'group.php') {
  300. $referer = 'group.php';
  301. }
  302. if (!empty($_GET['keyword']) && !empty($_GET['submit'])) {
  303. $keyword_name = Security::remove_XSS($_GET['keyword']);
  304. echo '<br/>'.get_lang('SearchResultsFor').' <span style="font-style: italic ;"> '.$keyword_name.' </span><br>';
  305. }
  306. Display :: display_header($nameTools, 'Group');
  307. ?>
  308. <div class="actions">
  309. <a href="group_space.php"><?php echo Display::return_icon('back.png', get_lang('ReturnTo').' '.get_lang('GroupSpace'),'',ICON_SIZE_MEDIUM); ?></a>
  310. </div>
  311. <?php
  312. if (isset($_GET['show_message'])) {
  313. echo Display::display_error_message($_GET['show_message']);
  314. }
  315. $defaults['referer'] = $referer;
  316. $form->setDefaults($defaults);
  317. $form->display();
  318. /* FOOTER */
  319. Display :: display_footer();