group_edit.php 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473
  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. $current_course_tool = TOOL_GROUP;
  18. // Notice for unauthorized people.
  19. api_protect_course_script(true);
  20. $group_id = api_get_group_id();
  21. $current_group = GroupManager :: get_group_properties($group_id);
  22. $nameTools = get_lang('EditGroup');
  23. $interbreadcrumb[] = array('url' => 'group.php', 'name' => get_lang('Groups'));
  24. $interbreadcrumb[] = array('url' => 'group_space.php?'.api_get_cidReq(), 'name' => $current_group['name']);
  25. $is_group_member = GroupManager :: is_tutor_of_group(api_get_user_id(), $group_id);
  26. if (!api_is_allowed_to_edit(false, true) && !$is_group_member) {
  27. api_not_allowed(true);
  28. }
  29. /* FUNCTIONS */
  30. /**
  31. * List all users registered to the course
  32. */
  33. function search_members_keyword($firstname, $lastname, $username, $official_code, $keyword)
  34. {
  35. if (api_strripos($firstname, $keyword) !== false || api_strripos($lastname, $keyword) !== false || api_strripos(
  36. $username,
  37. $keyword
  38. ) !== false || api_strripos($official_code, $keyword) !== false
  39. ) {
  40. return true;
  41. } else {
  42. return false;
  43. }
  44. }
  45. /**
  46. * function to sort users after getting the list in the db. Necessary because there are 2 or 3 queries. Called by usort()
  47. */
  48. function sort_users($user_a, $user_b)
  49. {
  50. if (api_sort_by_first_name()) {
  51. $cmp = api_strcmp($user_a['firstname'], $user_b['firstname']);
  52. if ($cmp !== 0) {
  53. return $cmp;
  54. } else {
  55. $cmp = api_strcmp($user_a['lastname'], $user_b['lastname']);
  56. if ($cmp !== 0) {
  57. return $cmp;
  58. } else {
  59. return api_strcmp($user_a['username'], $user_b['username']);
  60. }
  61. }
  62. } else {
  63. $cmp = api_strcmp($user_a['lastname'], $user_b['lastname']);
  64. if ($cmp !== 0) {
  65. return $cmp;
  66. } else {
  67. $cmp = api_strcmp($user_a['firstname'], $user_b['firstname']);
  68. if ($cmp !== 0) {
  69. return $cmp;
  70. } else {
  71. return api_strcmp($user_a['username'], $user_b['username']);
  72. }
  73. }
  74. }
  75. }
  76. /**
  77. * Function to check the given max number of members per group
  78. */
  79. function check_max_number_of_members($value)
  80. {
  81. $max_member_no_limit = $value['max_member_no_limit'];
  82. if ($max_member_no_limit == GroupManager::MEMBER_PER_GROUP_NO_LIMIT) {
  83. return true;
  84. }
  85. $max_member = $value['max_member'];
  86. return is_numeric($max_member);
  87. }
  88. /**
  89. * Function to check if the number of selected group members is valid
  90. */
  91. function check_group_members($value)
  92. {
  93. if ($value['max_member_no_limit'] == GroupManager::MEMBER_PER_GROUP_NO_LIMIT) {
  94. return true;
  95. }
  96. if (isset($value['max_member']) && isset($value['group_members']) && $value['max_member'] < count(
  97. $value['group_members']
  98. )
  99. ) {
  100. return array('group_members' => get_lang('GroupTooMuchMembers'));
  101. }
  102. return true;
  103. }
  104. /* MAIN CODE */
  105. $htmlHeadXtra[] = '<script>
  106. $(document).ready( function() {
  107. $("#max_member").on("focus", function() {
  108. $("#max_member_selected").attr("checked", true);
  109. });
  110. });
  111. </script>';
  112. // Build form
  113. $form = new FormValidator('group_edit', 'post', api_get_self().'?'.api_get_cidreq());
  114. $form->addElement('header', $nameTools);
  115. $form->addElement('hidden', 'action');
  116. $form->addElement('hidden', 'referer');
  117. // Group name
  118. $form->add_textfield('name', get_lang('GroupName'));
  119. // Description
  120. $form->addElement('textarea', 'description', get_lang('Description'), array('class' => 'span6', 'rows' => 6));
  121. $complete_user_list = GroupManager :: fill_groups_list($current_group['id']);
  122. usort($complete_user_list, 'sort_users');
  123. $possible_users = array();
  124. foreach ($complete_user_list as $index => $user) {
  125. $possible_users[$user['user_id']] = api_get_person_name(
  126. $user['firstname'],
  127. $user['lastname']
  128. ).' ('.$user['username'].')';
  129. }
  130. // Group tutors
  131. $group_tutor_list = GroupManager :: get_subscribed_tutors($current_group['id']);
  132. $selected_users = array();
  133. $selected_tutors = array();
  134. foreach ($group_tutor_list as $index => $user) {
  135. $selected_tutors[] = $user['user_id'];
  136. }
  137. $group_tutors_element = $form->addElement('advmultiselect', 'group_tutors', get_lang('GroupTutors'), $possible_users);
  138. $group_tutors_element->setButtonAttributes('add');
  139. $group_tutors_element->setButtonAttributes('remove');
  140. // Group members
  141. $group_member_list = GroupManager :: get_subscribed_users($current_group['id']);
  142. $selected_users = array();
  143. foreach ($group_member_list as $index => $user) {
  144. $selected_users[] = $user['user_id'];
  145. }
  146. // possible : number_groups_left > 0 and is group member
  147. $possible_users = array();
  148. foreach ($complete_user_list as $index => $user) {
  149. if ($user['number_groups_left'] > 0 || in_array($user['user_id'], $selected_users)) {
  150. $possible_users[$user['user_id']] = api_get_person_name(
  151. $user['firstname'],
  152. $user['lastname']
  153. ).' ('.$user['username'].')';
  154. }
  155. }
  156. $group_members_element = $form->addElement(
  157. 'advmultiselect',
  158. 'group_members',
  159. get_lang('GroupMembers'),
  160. $possible_users
  161. );
  162. $group_members_element->setButtonAttributes('add');
  163. $group_members_element->setButtonAttributes('remove');
  164. $form->addFormRule('check_group_members');
  165. // Members per group
  166. $form->addElement(
  167. 'radio',
  168. 'max_member_no_limit',
  169. get_lang('GroupLimit'),
  170. get_lang('NoLimit'),
  171. GroupManager::MEMBER_PER_GROUP_NO_LIMIT
  172. );
  173. $group = array();
  174. $group[] = $form->createElement(
  175. 'radio',
  176. 'max_member_no_limit',
  177. null,
  178. get_lang('MaximumOfParticipants'),
  179. 1,
  180. array('id' => 'max_member_selected')
  181. );
  182. $group[] = $form->createElement('text', 'max_member', null, array('class' => 'span1', 'id' => 'max_member'));
  183. $group[] = $form->createElement('static', null, null, get_lang('GroupPlacesThis'));
  184. $form->addGroup($group, 'max_member_group', null, '', false);
  185. $form->addRule('max_member_group', get_lang('InvalidMaxNumberOfMembers'), 'callback', 'check_max_number_of_members');
  186. // Self registration
  187. $group = array();
  188. $group[] = $form->createElement(
  189. 'checkbox',
  190. 'self_registration_allowed',
  191. get_lang('GroupSelfRegistration'),
  192. get_lang('GroupAllowStudentRegistration'),
  193. 1
  194. );
  195. $group[] = $form->createElement(
  196. 'checkbox',
  197. 'self_unregistration_allowed',
  198. null,
  199. get_lang('GroupAllowStudentUnregistration'),
  200. 1
  201. );
  202. $form->addGroup(
  203. $group,
  204. '',
  205. Display::return_icon('user.png', get_lang('GroupSelfRegistration'), array(), ICON_SIZE_SMALL).' '.get_lang(
  206. 'GroupSelfRegistration'
  207. ),
  208. '',
  209. false
  210. );
  211. // Documents settings
  212. $group = array();
  213. $group[] = $form->createElement(
  214. 'radio',
  215. 'doc_state',
  216. get_lang('GroupDocument'),
  217. get_lang('NotAvailable'),
  218. GroupManager::TOOL_NOT_AVAILABLE
  219. );
  220. $group[] = $form->createElement('radio', 'doc_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  221. $group[] = $form->createElement('radio', 'doc_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  222. $form->addGroup(
  223. $group,
  224. '',
  225. Display::return_icon('folder.png', get_lang('GroupDocument'), array(), ICON_SIZE_SMALL).' '.get_lang(
  226. 'GroupDocument'
  227. ),
  228. '',
  229. false
  230. );
  231. // Work settings
  232. $group = array();
  233. $group[] = $form->createElement(
  234. 'radio',
  235. 'work_state',
  236. get_lang('GroupWork'),
  237. get_lang('NotAvailable'),
  238. GroupManager::TOOL_NOT_AVAILABLE
  239. );
  240. $group[] = $form->createElement('radio', 'work_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  241. $group[] = $form->createElement('radio', 'work_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  242. $form->addGroup(
  243. $group,
  244. '',
  245. Display::return_icon('work.png', get_lang('GroupWork'), array(), ICON_SIZE_SMALL).' '.get_lang('GroupWork'),
  246. '',
  247. false
  248. );
  249. // Calendar settings
  250. $group = array();
  251. $group[] = $form->createElement(
  252. 'radio',
  253. 'calendar_state',
  254. get_lang('GroupCalendar'),
  255. get_lang('NotAvailable'),
  256. GroupManager::TOOL_NOT_AVAILABLE
  257. );
  258. $group[] = $form->createElement('radio', 'calendar_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  259. $group[] = $form->createElement('radio', 'calendar_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  260. $form->addGroup(
  261. $group,
  262. '',
  263. Display::return_icon('agenda.png', get_lang('GroupCalendar'), array(), ICON_SIZE_SMALL).' '.get_lang(
  264. 'GroupCalendar'
  265. ),
  266. '',
  267. false
  268. );
  269. // Announcements settings
  270. $group = array();
  271. $group[] = $form->createElement(
  272. 'radio',
  273. 'announcements_state',
  274. get_lang('GroupAnnouncements'),
  275. get_lang('NotAvailable'),
  276. GroupManager::TOOL_NOT_AVAILABLE
  277. );
  278. $group[] = $form->createElement('radio', 'announcements_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  279. $group[] = $form->createElement('radio', 'announcements_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  280. $form->addGroup(
  281. $group,
  282. '',
  283. Display::return_icon('announce.png', get_lang('GroupAnnouncements'), array(), ICON_SIZE_SMALL).' '.get_lang(
  284. 'GroupAnnouncements'
  285. ),
  286. '',
  287. false
  288. );
  289. //Forum settings
  290. $group = array();
  291. $group[] = $form->createElement(
  292. 'radio',
  293. 'forum_state',
  294. get_lang('GroupForum'),
  295. get_lang('NotAvailable'),
  296. GroupManager::TOOL_NOT_AVAILABLE
  297. );
  298. $group[] = $form->createElement('radio', 'forum_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  299. $group[] = $form->createElement('radio', 'forum_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  300. $form->addGroup(
  301. $group,
  302. '',
  303. Display::return_icon('forum.png', get_lang('GroupForum'), array(), ICON_SIZE_SMALL).' '.get_lang('GroupForum'),
  304. '',
  305. false
  306. );
  307. // Wiki settings
  308. $group = array();
  309. $group[] = $form->createElement(
  310. 'radio',
  311. 'wiki_state',
  312. get_lang('GroupWiki'),
  313. get_lang('NotAvailable'),
  314. GroupManager::TOOL_NOT_AVAILABLE
  315. );
  316. $group[] = $form->createElement('radio', 'wiki_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  317. $group[] = $form->createElement('radio', 'wiki_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  318. $form->addGroup(
  319. $group,
  320. '',
  321. Display::return_icon('wiki.png', get_lang('GroupWiki'), array(), ICON_SIZE_SMALL).' '.get_lang('GroupWiki'),
  322. '',
  323. false
  324. );
  325. // Chat settings
  326. $group = array();
  327. $group[] = $form->createElement(
  328. 'radio',
  329. 'chat_state',
  330. get_lang('Chat'),
  331. get_lang('NotAvailable'),
  332. GroupManager::TOOL_NOT_AVAILABLE
  333. );
  334. $group[] = $form->createElement('radio', 'chat_state', null, get_lang('Public'), GroupManager::TOOL_PUBLIC);
  335. $group[] = $form->createElement('radio', 'chat_state', null, get_lang('Private'), GroupManager::TOOL_PRIVATE);
  336. $form->addGroup(
  337. $group,
  338. '',
  339. Display::return_icon('chat.png', get_lang('Chat'), array(), ICON_SIZE_SMALL).' '.get_lang('Chat'),
  340. '',
  341. false
  342. );
  343. // submit button
  344. $form->addElement('style_submit_button', 'submit', get_lang('PropModify'), 'class="save"');
  345. if ($form->validate()) {
  346. $values = $form->exportValues();
  347. if ($values['max_member_no_limit'] == GroupManager::MEMBER_PER_GROUP_NO_LIMIT) {
  348. $max_member = GroupManager::MEMBER_PER_GROUP_NO_LIMIT;
  349. } else {
  350. $max_member = $values['max_member'];
  351. }
  352. $self_registration_allowed = isset($values['self_registration_allowed']) ? 1 : 0;
  353. $self_unregistration_allowed = isset($values['self_unregistration_allowed']) ? 1 : 0;
  354. GroupManager :: set_group_properties(
  355. $current_group['id'],
  356. strip_tags($values['name']),
  357. strip_tags($values['description']),
  358. $max_member,
  359. $values['doc_state'],
  360. $values['work_state'],
  361. $values['calendar_state'],
  362. $values['announcements_state'],
  363. $values['forum_state'],
  364. $values['wiki_state'],
  365. $values['chat_state'],
  366. $self_registration_allowed,
  367. $self_unregistration_allowed
  368. );
  369. // Storing the tutors (we first remove all the tutors and then add only those who were selected)
  370. GroupManager :: unsubscribe_all_tutors($current_group['id']);
  371. if (isset ($_POST['group_tutors']) && count($_POST['group_tutors']) > 0) {
  372. GroupManager :: subscribe_tutors($values['group_tutors'], $current_group['id']);
  373. }
  374. // Storing the users (we first remove all users and then add only those who were selected)
  375. GroupManager :: unsubscribe_all_users($current_group['id']);
  376. if (isset ($_POST['group_members']) && count($_POST['group_members']) > 0) {
  377. GroupManager :: subscribe_users($values['group_members'], $current_group['id']);
  378. }
  379. // Returning to the group area (note: this is inconsistent with the rest of chamilo)
  380. $cat = GroupManager :: get_category_from_group($current_group['id']);
  381. if (isset($_POST['group_members']) && count(
  382. $_POST['group_members']
  383. ) > $max_member && $max_member != GroupManager::MEMBER_PER_GROUP_NO_LIMIT
  384. ) {
  385. header(
  386. 'Location: group.php?'.api_get_cidreq(true, false).'&action=warning_message&msg='.get_lang(
  387. 'GroupTooMuchMembers'
  388. )
  389. );
  390. } else {
  391. header(
  392. 'Location: group.php?'.api_get_cidreq(true, false).'&action=success_message&msg='.get_lang(
  393. 'GroupSettingsModified'
  394. ).'&category='.$cat['id']
  395. );
  396. }
  397. exit;
  398. }
  399. $defaults = $current_group;
  400. $defaults['group_members'] = $selected_users;
  401. $defaults['group_tutors'] = $selected_tutors;
  402. $action = isset($_GET['action']) ? $_GET['action'] : '';
  403. $defaults['action'] = $action;
  404. if ($defaults['maximum_number_of_students'] == GroupManager::MEMBER_PER_GROUP_NO_LIMIT) {
  405. $defaults['max_member_no_limit'] = GroupManager::MEMBER_PER_GROUP_NO_LIMIT;
  406. } else {
  407. $defaults['max_member_no_limit'] = 1;
  408. $defaults['max_member'] = $defaults['maximum_number_of_students'];
  409. }
  410. if (!empty($_GET['keyword']) && !empty($_GET['submit'])) {
  411. $keyword_name = Security::remove_XSS($_GET['keyword']);
  412. echo '<br/>'.get_lang('SearchResultsFor').' <span style="font-style: italic ;"> '.$keyword_name.' </span><br>';
  413. }
  414. Display :: display_header($nameTools, 'Group');
  415. //@todo fix this
  416. if (isset($_GET['show_message_warning'])) {
  417. echo Display::display_warning_message($_GET['show_message_warning']);
  418. }
  419. if (isset($_GET['show_message_sucess'])) {
  420. echo Display::display_normal_message($_GET['show_message_sucess']);
  421. }
  422. $form->setDefaults($defaults);
  423. $form->display();
  424. Display :: display_footer();