group.php 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363
  1. <?php
  2. /* For licensing terms, see /license.txt */
  3. /**
  4. * Main page for the group module.
  5. * This script displays the general group settings,
  6. * and a list of groups with buttons to view, edit...
  7. *
  8. * @author Thomas Depraetere, Hugues Peeters, Christophe Gesche: initial versions
  9. * @author Bert Vanderkimpen, improved self-unsubscribe for cvs
  10. * @author Patrick Cool, show group comment under the group name
  11. * @author Roan Embrechts, initial self-unsubscribe code, code cleaning, virtual course support
  12. * @author Bart Mollet, code cleaning, use of Display-library, list of courseAdmin-tools, use of GroupManager
  13. * @author Isaac Flores, code cleaning and improvements
  14. * @package chamilo.group
  15. */
  16. /* INIT SECTION */
  17. // Name of the language file that needs to be included
  18. $language_file = 'group';
  19. require_once '../inc/global.inc.php';
  20. $this_section = SECTION_COURSES;
  21. $current_course_tool = TOOL_GROUP;
  22. // Notice for unauthorized people.
  23. api_protect_course_script(true);
  24. $htmlHeadXtra[] = '<script>
  25. $(document).ready( function() {
  26. for (i=0;i<$(".actions").length;i++) {
  27. if ($(".actions:eq("+i+")").html()=="<table border=\"0\"></table>" || $(".actions:eq("+i+")").html()=="" || $(".actions:eq("+i+")").html()==null) {
  28. $(".actions:eq("+i+")").hide();
  29. }
  30. }
  31. } );
  32. </script>';
  33. $nameTools = get_lang('GroupManagement');
  34. $course_id = api_get_course_int_id();
  35. // Create default category if it doesn't exist when group categories aren't allowed
  36. if (api_get_setting('allow_group_categories') == 'false') {
  37. $cat_table = Database::get_course_table(TABLE_GROUP_CATEGORY);
  38. $sql = "SELECT * FROM $cat_table WHERE c_id = $course_id AND id = '".GroupManager::DEFAULT_GROUP_CATEGORY."'";
  39. $res = Database::query($sql);
  40. $num = Database::num_rows($res);
  41. if ($num == 0) {
  42. $sql = "INSERT INTO ".$cat_table." ( c_id, id , title , description , forum_state, wiki_state, max_student, self_reg_allowed, self_unreg_allowed, groups_per_user, display_order)
  43. VALUES ($course_id, '2', '".lang2db($DefaultGroupCategory)."', '', '1', '1', '8', '0', '0', '0', '0');";
  44. Database::query ($sql);
  45. }
  46. }
  47. /* Header */
  48. if (!isset ($_GET['origin']) || $_GET['origin'] != 'learnpath') {
  49. // So we are not in learnpath tool
  50. event_access_tool(TOOL_GROUP);
  51. if (!$is_allowed_in_course) {
  52. api_not_allowed(true);
  53. }
  54. }
  55. Display::display_header(get_lang('Groups'));
  56. // Tool introduction
  57. Display::display_introduction_section(TOOL_GROUP);
  58. /*
  59. * Self-registration and unregistration
  60. */
  61. $my_group_id = isset($_GET['group_id']) ? intval($_GET['group_id']) : null;
  62. $my_msg = isset($_GET['msg']) ? Security::remove_XSS($_GET['msg']) : null;
  63. $my_group = isset($_REQUEST['group']) ? Security::remove_XSS($_REQUEST['group']) : null;
  64. $my_get_id1 = isset($_GET['id1']) ? Security::remove_XSS($_GET['id1']) : null;
  65. $my_get_id2 = isset($_GET['id2']) ? Security::remove_XSS($_GET['id2']) : null;
  66. $my_get_id = isset($_GET['id']) ? Security::remove_XSS($_GET['id']) : null;
  67. if (isset($_GET['action'])) {
  68. switch ($_GET['action']) {
  69. case 'self_reg' :
  70. if (GroupManager :: is_self_registration_allowed($_SESSION['_user']['user_id'], $my_group_id)) {
  71. GroupManager :: subscribe_users($_SESSION['_user']['user_id'], $my_group_id);
  72. Display :: display_confirmation_message(get_lang('GroupNowMember'));
  73. }
  74. break;
  75. case 'self_unreg' :
  76. if (GroupManager :: is_self_unregistration_allowed($_SESSION['_user']['user_id'], $my_group_id)) {
  77. GroupManager :: unsubscribe_users($_SESSION['_user']['user_id'], $my_group_id);
  78. Display :: display_confirmation_message(get_lang('StudentDeletesHimself'));
  79. }
  80. break;
  81. case 'show_msg' :
  82. Display :: display_confirmation_message($my_msg);
  83. break;
  84. case 'warning_message' :
  85. Display :: display_warning_message($my_msg);
  86. break;
  87. case 'success_message' :
  88. Display :: display_confirmation_message($my_msg);
  89. break;
  90. }
  91. }
  92. /*
  93. * Group-admin functions
  94. */
  95. if (api_is_allowed_to_edit(false, true)) {
  96. // Post-actions
  97. if (isset($_POST['action'])) {
  98. switch ($_POST['action']) {
  99. case 'delete_selected' :
  100. if (is_array($_POST['group'])) {
  101. GroupManager :: delete_groups($my_group);
  102. Display :: display_confirmation_message(get_lang('SelectedGroupsDeleted'));
  103. }
  104. break;
  105. case 'empty_selected' :
  106. if (is_array($_POST['group'])) {
  107. GroupManager :: unsubscribe_all_users($my_group);
  108. Display :: display_confirmation_message(get_lang('SelectedGroupsEmptied'));
  109. }
  110. break;
  111. case 'fill_selected' :
  112. if (is_array($_POST['group'])) {
  113. GroupManager :: fill_groups($my_group);
  114. Display :: display_confirmation_message(get_lang('SelectedGroupsFilled'));
  115. }
  116. break;
  117. }
  118. }
  119. // Get-actions
  120. if (isset($_GET['action'])) {
  121. switch ($_GET['action']) {
  122. case 'swap_cat_order':
  123. GroupManager :: swap_category_order($my_get_id1, $my_get_id2);
  124. Display :: display_confirmation_message(get_lang('CategoryOrderChanged'));
  125. break;
  126. case 'delete_one':
  127. GroupManager :: delete_groups($my_get_id);
  128. Display :: display_confirmation_message(get_lang('GroupDel'));
  129. break;
  130. case 'empty_one':
  131. GroupManager :: unsubscribe_all_users($my_get_id);
  132. Display :: display_confirmation_message(get_lang('GroupEmptied'));
  133. break;
  134. case 'fill_one':
  135. GroupManager :: fill_groups($my_get_id);
  136. Display :: display_confirmation_message(get_lang('GroupFilledGroups'));
  137. break;
  138. case 'delete_category':
  139. GroupManager :: delete_category($my_get_id);
  140. Display :: display_confirmation_message(get_lang('CategoryDeleted'));
  141. break;
  142. }
  143. }
  144. }
  145. echo '<div class="actions">';
  146. if (api_is_allowed_to_edit(false, true)) {
  147. echo '<a href="group_creation.php?'.api_get_cidreq().'">'.Display::return_icon('new_group.png', get_lang('NewGroupCreate'),'',ICON_SIZE_MEDIUM).'</a>';
  148. if (CourseManager::count_rows_course_table(Database::get_course_table(TABLE_GROUP),api_get_session_id(), api_get_course_int_id()) > 0) {
  149. echo '<a href="group_overview.php?'.api_get_cidreq().'">'.Display::return_icon('group_summary.png', get_lang('GroupOverview'),'',ICON_SIZE_MEDIUM).'</a>';
  150. }
  151. if (api_get_setting('allow_group_categories') == 'true') {
  152. echo '<a href="group_category.php?'.api_get_cidreq().'&action=add_category">'.Display::return_icon('new_folder.png', get_lang('AddCategory'),'',ICON_SIZE_MEDIUM).'</a>';
  153. } else {
  154. echo '<a href="group_category.php?'.api_get_cidreq().'&id=2">'.Display::return_icon('settings.png', get_lang('PropModify'),'',ICON_SIZE_MEDIUM).'</a>';
  155. }
  156. echo '<a href="group_overview.php?'.api_get_cidreq().'&action=export&type=xls">'.Display::return_icon('export_excel.png', get_lang('ExportAsXLS'),'',ICON_SIZE_MEDIUM).'</a>';
  157. echo '<a href="../user/user.php?'.api_get_cidreq().'">'.Display::return_icon('user.png', get_lang('GoTo').' '.get_lang('Users'),'',ICON_SIZE_MEDIUM).'</a>';
  158. }
  159. $group_cats = GroupManager :: get_categories();
  160. if (api_get_setting('allow_group_categories') == 'true' && count($group_cats) > 1) {
  161. echo ' <a href="?'.api_get_cidreq().'&show_all=1">'.Display::return_icon('group.png',get_lang('ShowAll'),'',ICON_SIZE_MEDIUM).'</a>';
  162. }
  163. echo '</div>';
  164. /*
  165. * List all categories
  166. */
  167. foreach ($group_cats as $index => $category) {
  168. $group_list = array ();
  169. $in_category = false;
  170. if (api_get_setting('allow_group_categories') == 'true') {
  171. if (isset ($_GET['show_all']) || (isset ($_GET['category']) && $_GET['category'] == $category['id'])) {
  172. echo '<img src="../img/folder_group_category.gif" alt=""/>';
  173. echo '<a href="group.php?'.api_get_cidreq().'&origin='.Security::remove_XSS($_GET['origin']).'">'.$category['title'].'</a>';
  174. $in_category = true;
  175. } else {
  176. echo '<img src="../img/folder_document.gif" alt=""/>';
  177. echo '<a href="group.php?'.api_get_cidreq().'&origin='.Security::remove_XSS($_GET['origin']).'&amp;category='.$category['id'].'">'.$category['title'].'</a>';
  178. }
  179. $group_list = GroupManager :: get_group_list($category['id']);
  180. echo ' ('.count($group_list).' '.get_lang('ExistingGroups').')';
  181. if (api_is_allowed_to_edit(false, true)) {
  182. echo '<a href="group_category.php?'.api_get_cidreq().'&id='.$category['id'].'" title="'.get_lang('Edit').'">'.Display::return_icon('settings.png', get_lang('EditGroup'),'',ICON_SIZE_SMALL).'</a>';
  183. echo '<a href="group.php?'.api_get_cidreq().'&action=delete_category&amp;id='.$category['id'].'" onclick="javascript:if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES))."'".')) return false;" title="'.get_lang('Delete').'">'.Display::return_icon('delete.png', get_lang('Delete'),'',ICON_SIZE_SMALL).'</a>';
  184. if ($index != 0) {
  185. echo ' <a href="group.php?'.api_get_cidreq().'&action=swap_cat_order&amp;id1='.$category['id'].'&amp;id2='.$group_cats[$index -1]['id'].'">'.Display::return_icon('up.png','&nbsp;','',ICON_SIZE_SMALL).'</a>';
  186. }
  187. if ($index != count($group_cats) - 1) {
  188. echo ' <a href="group.php?'.api_get_cidreq().'&action=swap_cat_order&amp;id1='.$category['id'].'&amp;id2='.$group_cats[$index +1]['id'].'">'.Display::return_icon('down.png','&nbsp;','',ICON_SIZE_SMALL).'</a>';
  189. }
  190. }
  191. echo '<p style="margin: 0px;margin-left: 50px;">'.$category['description'].'</p><p/>';
  192. } else {
  193. $group_list = GroupManager :: get_group_list();
  194. $in_category = true;
  195. }
  196. //if (count($group_list) > 0 && $in_category)
  197. if ($in_category) {
  198. $totalRegistered = 0;
  199. $group_data = array();
  200. foreach ($group_list as $index => $this_group) {
  201. // Validacion when belongs to a session
  202. $session_img = api_get_session_image($this_group['session_id'], $_user['status']);
  203. // All the tutors of this group
  204. $tutorsids_of_group = GroupManager::get_subscribed_tutors($this_group['id'], true);
  205. // Create a new table-row
  206. $row = array ();
  207. // Checkbox
  208. if (api_is_allowed_to_edit(false,true) && count($group_list) > 1) {
  209. $row[] = $this_group['id'];
  210. }
  211. // Group name
  212. if ((api_is_allowed_to_edit(false, true) ||
  213. in_array($_user['user_id'], $tutorsids_of_group) ||
  214. $this_group['is_member'] ||
  215. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_FORUM) ||
  216. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_DOCUMENTS) ||
  217. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_CALENDAR) ||
  218. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_ANNOUNCEMENT) ||
  219. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_WORK) ||
  220. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GroupManager::GROUP_TOOL_WIKI))
  221. && !(api_is_course_coach() && intval($this_group['session_id']) != intval($_SESSION['id_session']))) {
  222. $orig = isset($origin) ? $origin : null;
  223. $group_name = '<a href="group_space.php?cidReq='.api_get_course_id().'&amp;origin='.$orig.'&amp;gidReq='.$this_group['id'].'">'.Security::remove_XSS($this_group['name']).'</a>';
  224. if (!empty($_SESSION['_user']['user_id']) && !empty($this_group['id_tutor']) && $_SESSION['_user']['user_id'] == $this_group['id_tutor']) {
  225. $group_name .= ' ('.get_lang('OneMyGroups').')';
  226. } elseif ($this_group['is_member']) {
  227. $group_name .= ' ('.get_lang('MyGroup').')';
  228. }
  229. if (api_is_allowed_to_edit() && !empty($this_group['session_name'])) {
  230. $group_name .= ' ('.$this_group['session_name'].')';
  231. }
  232. $group_name .= $session_img;
  233. $row[] = $group_name.'<br />'.stripslashes(trim($this_group['description']));
  234. } else {
  235. $row[] = $this_group['name'].'<br />'.stripslashes(trim($this_group['description']));
  236. }
  237. // Tutor name
  238. $tutor_info = '';
  239. if (count($tutorsids_of_group) > 0) {
  240. foreach ($tutorsids_of_group as $tutor_id) {
  241. $tutor = api_get_user_info($tutor_id);
  242. $username = api_htmlentities(sprintf(get_lang('LoginX'), $tutor['username']), ENT_QUOTES);
  243. if (api_get_setting('show_email_addresses') == 'true') {
  244. $tutor_info .= Display::tag('span', Display::encrypted_mailto_link($tutor['mail'], api_get_person_name($tutor['firstName'], $tutor['lastName'])), array('title'=>$username)).', ';
  245. } else {
  246. if (api_is_allowed_to_edit()) {
  247. $tutor_info .= Display::tag('span', Display::encrypted_mailto_link($tutor['mail'], api_get_person_name($tutor['firstName'], $tutor['lastName'])), array('title'=>$username)).', ';
  248. } else {
  249. $tutor_info .= Display::tag('span', api_get_person_name($tutor['firstName'], $tutor['lastName']), array('title'=>$username)).', ';
  250. }
  251. }
  252. }
  253. }
  254. $tutor_info = api_substr($tutor_info, 0, api_strlen($tutor_info) - 2);
  255. $row[] = $tutor_info;
  256. // Max number of members in group
  257. $max_members = ($this_group['maximum_number_of_members'] == GroupManager::MEMBER_PER_GROUP_NO_LIMIT ? ' ' : ' / '.$this_group['maximum_number_of_members']);
  258. // Number of members in group
  259. $row[] = $this_group['number_of_members'].$max_members;
  260. // Self-registration / unregistration
  261. if (!api_is_allowed_to_edit(false, true)) {
  262. if (GroupManager :: is_self_registration_allowed($_user['user_id'], $this_group['id'])) {
  263. $row[] = '<a class = "btn" href="group.php?'.api_get_cidreq().'&category='.$category['id'].'&amp;action=self_reg&amp;group_id='.$this_group['id'].'" onclick="javascript:if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES, $charset))."'".')) return false;">'.get_lang('GroupSelfRegInf').'</a>';
  264. } elseif (GroupManager :: is_self_unregistration_allowed($_user['user_id'], $this_group['id'])) {
  265. $row[] = '<a class = "btn" href="group.php?'.api_get_cidreq().'&category='.$category['id'].'&amp;action=self_unreg&amp;group_id='.$this_group['id'].'" onclick="javascript:if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES, $charset))."'".')) return false;">'.get_lang('GroupSelfUnRegInf').'</a>';
  266. } else {
  267. $row[] = '-';
  268. }
  269. }
  270. // Edit-links
  271. if (api_is_allowed_to_edit(false, true) && !(api_is_course_coach() && intval($this_group['session_id']) != intval($_SESSION['id_session']))) {
  272. $edit_actions = '<a href="group_edit.php?'.api_get_cidreq(true, false).'&gidReq='.$this_group['id'].'" title="'.get_lang('Edit').'">'.Display::return_icon('edit.png', get_lang('EditGroup'),'',ICON_SIZE_SMALL).'</a>&nbsp;';
  273. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq(true, false).'&category='.$category['id'].'&amp;action=empty_one&amp;id='.$this_group['id'].'" onclick="javascript: if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES))."'".')) return false;" title="'.get_lang('EmptyGroup').'">'.Display::return_icon('clean.png',get_lang('EmptyGroup'),'',ICON_SIZE_SMALL).'</a>&nbsp;';
  274. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq(true, false).'&category='.$category['id'].'&amp;action=fill_one&amp;id='.$this_group['id'].'" onclick="javascript: if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES))."'".')) return false;" title="'.get_lang('FillGroup').'">'.Display::return_icon('fill.png',get_lang('FillGroup'),'',ICON_SIZE_SMALL).'</a>&nbsp;';
  275. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq(true, false).'&category='.$category['id'].'&amp;action=delete_one&amp;id='.$this_group['id'].'" onclick="javascript: if(!confirm('."'".addslashes(api_htmlentities(get_lang('ConfirmYourChoice'), ENT_QUOTES))."'".')) return false;" title="'.get_lang('Delete').'">'.Display::return_icon('delete.png', get_lang('Delete'),'',ICON_SIZE_SMALL).'</a>&nbsp;';
  276. $row[] = $edit_actions;
  277. }
  278. if (!empty($this_group['nbMember'])) {
  279. $totalRegistered = $totalRegistered + $this_group['nbMember'];
  280. }
  281. $group_data[] = $row;
  282. } // while loop
  283. if (isset ($_GET['show_all'])) {
  284. $paging_options = array('per_page' => count($group_data));
  285. } else {
  286. $paging_options = array ();
  287. }
  288. $table = new SortableTableFromArrayConfig($group_data, 1);
  289. $my_cat = isset($_GET['category']) ? Security::remove_XSS($_GET['category']) : null;
  290. $table->set_additional_parameters(array('category' => $my_cat));
  291. $column = 0;
  292. if (api_is_allowed_to_edit(false, true) and count($group_list) > 1) {
  293. $table->set_header($column++, '', false);
  294. }
  295. $table->set_header($column++, get_lang('Groups'));
  296. $table->set_header($column++, get_lang('GroupTutor'));
  297. $table->set_header($column++, get_lang('Registered'), false);
  298. if (!api_is_allowed_to_edit(false, true)) { // If self-registration allowed
  299. $table->set_header($column++, get_lang('GroupSelfRegistration'), false);
  300. }
  301. //$table->set_header($column++, get_lang('MaximumOfParticipants'));
  302. if (api_is_allowed_to_edit(false, true)) { // Only for course administrator
  303. $table->set_header($column++, get_lang('Modify'), false);
  304. $form_actions = array();
  305. $form_actions['fill_selected'] = get_lang('FillGroup');
  306. $form_actions['empty_selected'] = get_lang('EmptyGroup');
  307. $form_actions['delete_selected'] = get_lang('Delete');
  308. if (count($group_list) > 1) {
  309. $table->set_form_actions($form_actions, 'group');
  310. }
  311. }
  312. $table->display();
  313. }
  314. }
  315. /* FOOTER */
  316. if (!isset ($_GET['origin']) || $_GET['origin'] != 'learnpath') {
  317. Display::display_footer();
  318. }
  319. $_SESSION['_gid'] = 0;