group.php 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351
  1. <?php // $Id: group.php 22201 2009-07-17 19:57:03Z cfasanando $
  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. require_once api_get_path(LIBRARY_PATH).'sortabletable.class.php';
  21. $this_section = SECTION_COURSES;
  22. // Notice for unauthorized people.
  23. api_protect_course_script(true);
  24. $htmlHeadXtra[] = '<script src="'.api_get_path(WEB_LIBRARY_PATH).'javascript/jquery.js" type="text/javascript" language="javascript"></script>'; //jQuery
  25. $htmlHeadXtra[] = '<script type="text/javascript">
  26. $(document).ready( function() {
  27. for (i=0;i<$(".actions").length;i++) {
  28. if ($(".actions:eq("+i+")").html()=="<table border=\"0\"></table>" || $(".actions:eq("+i+")").html()=="" || $(".actions:eq("+i+")").html()==null) {
  29. $(".actions:eq("+i+")").hide();
  30. }
  31. }
  32. } );
  33. </script>';
  34. $nameTools = get_lang('GroupManagement');
  35. /* Libraries */
  36. require_once api_get_path(LIBRARY_PATH).'course.lib.php';
  37. require_once api_get_path(LIBRARY_PATH).'groupmanager.lib.php';
  38. // Create default category if it doesn't exist when group categories aren't allowed
  39. if (api_get_setting('allow_group_categories') == 'false') {
  40. $cat_table = Database::get_course_table(TABLE_GROUP_CATEGORY);
  41. $sql = "SELECT * FROM $cat_table WHERE id = '".DEFAULT_GROUP_CATEGORY."'";
  42. $res = Database::query($sql);
  43. $num = Database::num_rows($res);
  44. if ($num == 0) {
  45. Database::query("INSERT INTO ".$cat_table." ( id , title , description , forum_state , wiki_state, max_student , self_reg_allowed , self_unreg_allowed , groups_per_user , display_order ) VALUES ('2', '".lang2db($DefaultGroupCategory)."', '', '1', '1', '8', '0', '0', '0', '0');");
  46. }
  47. }
  48. /* Header */
  49. if (!isset ($_GET['origin']) || $_GET['origin'] != 'learnpath') {
  50. // So we are not in learnpath tool
  51. event_access_tool(TOOL_GROUP);
  52. if (!$is_allowed_in_course) {
  53. api_not_allowed(true);
  54. }
  55. }
  56. Display::display_header(get_lang('Groups'));
  57. // Tool introduction
  58. Display::display_introduction_section(TOOL_GROUP);
  59. /*
  60. * Self-registration and unregistration
  61. */
  62. $my_group_id = Security::remove_XSS($_GET['group_id']);
  63. $my_msg = Security::remove_XSS($_GET['msg']);
  64. $my_group = $_POST['group'];
  65. $my_get_id1 = Security::remove_XSS($_GET['id1']);
  66. $my_get_id2 = Security::remove_XSS($_GET['id2']);
  67. $my_get_id = Security::remove_XSS($_GET['id']);
  68. if (isset($_GET['action'])) {
  69. switch ($_GET['action']) {
  70. case 'self_reg' :
  71. if (GroupManager :: is_self_registration_allowed($_SESSION['_user']['user_id'], $my_group_id)) {
  72. GroupManager :: subscribe_users($_SESSION['_user']['user_id'], $my_group_id);
  73. Display :: display_confirmation_message(get_lang('GroupNowMember'));
  74. }
  75. break;
  76. case 'self_unreg' :
  77. if (GroupManager :: is_self_unregistration_allowed($_SESSION['_user']['user_id'], $my_group_id)) {
  78. GroupManager :: unsubscribe_users($_SESSION['_user']['user_id'], $my_group_id);
  79. Display :: display_confirmation_message(get_lang('StudentDeletesHimself'));
  80. }
  81. break;
  82. case 'show_msg' :
  83. Display :: display_confirmation_message($my_msg);
  84. break;
  85. }
  86. }
  87. /*
  88. * Group-admin functions
  89. */
  90. if (api_is_allowed_to_edit(false, true)) {
  91. // Post-actions
  92. if (isset($_POST['action'])) {
  93. switch ($_POST['action']) {
  94. case 'delete_selected' :
  95. if (is_array($_POST['group'])) {
  96. GroupManager :: delete_groups($my_group);
  97. Display :: display_confirmation_message(get_lang('SelectedGroupsDeleted'));
  98. }
  99. break;
  100. case 'empty_selected' :
  101. if (is_array($_POST['group'])) {
  102. GroupManager :: unsubscribe_all_users($my_group);
  103. Display :: display_confirmation_message(get_lang('SelectedGroupsEmptied'));
  104. }
  105. break;
  106. case 'fill_selected' :
  107. if (is_array($_POST['group'])) {
  108. GroupManager :: fill_groups($my_group);
  109. Display :: display_confirmation_message(get_lang('SelectedGroupsFilled'));
  110. }
  111. break;
  112. }
  113. }
  114. // Get-actions
  115. if (isset($_GET['action'])) {
  116. switch ($_GET['action']) {
  117. case 'swap_cat_order':
  118. GroupManager :: swap_category_order($my_get_id1, $my_get_id2);
  119. Display :: display_confirmation_message(get_lang('CategoryOrderChanged'));
  120. break;
  121. case 'delete_one':
  122. GroupManager :: delete_groups($my_get_id);
  123. Display :: display_confirmation_message(get_lang('GroupDel'));
  124. break;
  125. case 'empty_one':
  126. GroupManager :: unsubscribe_all_users($my_get_id);
  127. Display :: display_confirmation_message(get_lang('GroupEmptied'));
  128. break;
  129. case 'fill_one':
  130. GroupManager :: fill_groups($my_get_id);
  131. Display :: display_confirmation_message(get_lang('GroupFilledGroups'));
  132. break;
  133. case 'delete_category':
  134. GroupManager :: delete_category($my_get_id);
  135. Display :: display_confirmation_message(get_lang('CategoryDeleted'));
  136. break;
  137. }
  138. }
  139. }
  140. echo '<div class="actions">';
  141. if (api_is_allowed_to_edit(false, true)) {
  142. echo Display::return_icon('groupadd.gif', get_lang('NewGroupCreate')) . '<a href="group_creation.php?'.api_get_cidreq().'">'.get_lang('NewGroupCreate').'</a>&nbsp;';
  143. if (Database::count_rows(Database::get_course_table(TABLE_GROUP)) > 0) {
  144. //echo '<a href="group_overview.php?'.api_get_cidreq().'">'.Display::return_icon('group_view.gif').'&nbsp;'.get_lang('GroupOverview').'</a>&nbsp;';
  145. echo Display::return_icon('group.gif', get_lang('GroupOverview')) .'<a href="group_overview.php?'.api_get_cidreq().'">'.get_lang('GroupOverview').'</a>&nbsp;';
  146. }
  147. if (api_get_setting('allow_group_categories') == 'true') {
  148. echo Display::return_icon('folder_new.gif', get_lang('AddCategory')) . '<a href="group_category.php?'.api_get_cidreq().'&action=add_category">'.get_lang('AddCategory').'</a>&nbsp;';
  149. } else {
  150. //echo '<a href="group_category.php?'.api_get_cidreq().'&id=2">'.Display::return_icon('edit_group.gif').'&nbsp;'.get_lang('PropModify').'</a>&nbsp;';
  151. echo Display::return_icon('settings.gif', get_lang('PropModify')) . '<a href="group_category.php?'.api_get_cidreq().'&id=2">'.get_lang('PropModify').'</a>&nbsp;';
  152. }
  153. //echo Display::return_icon('csv.gif', get_lang('ExportAsCSV')).'<a href="group_overview.php?'.api_get_cidreq().'&action=export&type=csv">'.get_lang('ExportAsCSV').'</a> ';
  154. echo Display::return_icon('excel.gif', get_lang('ExportAsXLS')).' <a href="group_overview.php?'.api_get_cidreq().'&action=export&type=xls">'.get_lang('ExportAsXLS').'</a>';
  155. //echo '<a href="group_creation.php?'.api_get_cidreq().'">'.Display::return_icon('group_add_big.gif').'&nbsp;'.get_lang('NewGroupCreate').'</a>&nbsp;';
  156. }
  157. $group_cats = GroupManager :: get_categories();
  158. if (api_get_setting('allow_group_categories') == 'true' && count($group_cats) > 1) {
  159. //echo '<p><a href="?'.api_get_cidreq().'&show_all=1">'.get_lang('ShowAll').'</a></p>';
  160. echo Display::return_icon('group.gif').' <a href="?'.api_get_cidreq().'&show_all=1">'.get_lang('ShowAll').'</a>';
  161. }
  162. echo '</div>';
  163. /*
  164. * List all categories
  165. */
  166. foreach ($group_cats as $index => $category) {
  167. $group_list = array ();
  168. $in_category = false;
  169. if (api_get_setting('allow_group_categories') == 'true') {
  170. if (isset ($_GET['show_all']) || (isset ($_GET['category']) && $_GET['category'] == $category['id'])) {
  171. echo '<img src="../img/shared_folder.gif" alt=""/>';
  172. echo '<a href="group.php?'.api_get_cidreq().'&origin='.Security::remove_XSS($_GET['origin']).'">'.$category['title'].'</a>';
  173. $in_category = true;
  174. } else {
  175. echo '<img src="../img/folder_document.gif" alt=""/>';
  176. echo '<a href="group.php?'.api_get_cidreq().'&origin='.Security::remove_XSS($_GET['origin']).'&amp;category='.$category['id'].'">'.$category['title'].'</a>';
  177. }
  178. $group_list = GroupManager :: get_group_list($category['id']);
  179. echo ' ('.count($group_list).' '.get_lang('ExistingGroups').')';
  180. if (api_is_allowed_to_edit(false, true)) {
  181. echo '<a href="group_category.php?'.api_get_cidreq().'&id='.$category['id'].'" title="'.get_lang('Edit').'"><img src="../img/edit.gif" alt="'.get_lang('Edit').'"/></a> ';
  182. 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').'"><img src="../img/delete.gif" alt="'.get_lang('Delete').'"/></a> ';
  183. if ($index != 0) {
  184. echo ' <a href="group.php?'.api_get_cidreq().'&action=swap_cat_order&amp;id1='.$category['id'].'&amp;id2='.$group_cats[$index -1]['id'].'"><img src="../img/up.gif" alt=""/></a>';
  185. }
  186. if ($index != count($group_cats) - 1) {
  187. echo ' <a href="group.php?'.api_get_cidreq().'&action=swap_cat_order&amp;id1='.$category['id'].'&amp;id2='.$group_cats[$index +1]['id'].'"><img src="../img/down.gif" alt=""/></a>';
  188. }
  189. }
  190. echo '<p style="margin: 0px;margin-left: 50px;">'.$category['description'].'</p><p/>';
  191. } else {
  192. $group_list = GroupManager :: get_group_list();
  193. $in_category = true;
  194. }
  195. //if (count($group_list) > 0 && $in_category)
  196. if ($in_category) {
  197. $totalRegistered = 0;
  198. // Determine wether current user is tutor for this course
  199. $user_is_tutor = GroupManager :: is_tutor($_user['user_id']);
  200. $group_data = array();
  201. foreach ($group_list as $index => $this_group) {
  202. // Validacion when belongs to a session
  203. $session_img = api_get_session_image($this_group['session_id'], $_user['status']);
  204. // All the tutors of this group
  205. $tutorsids_of_group=GroupManager::get_subscribed_tutors($this_group['id'], true);
  206. // Create a new table-row
  207. $row = array ();
  208. // Checkbox
  209. if (api_is_allowed_to_edit(false,true) && count($group_list) > 1) {
  210. $row[] = $this_group['id'];
  211. }
  212. // Group name
  213. if ((api_is_allowed_to_edit(false, true) ||
  214. in_array($_user['user_id'], $tutorsids_of_group) ||
  215. $this_group['is_member'] ||
  216. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_FORUM) ||
  217. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_DOCUMENTS) ||
  218. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_CALENDAR) ||
  219. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_ANNOUNCEMENT) ||
  220. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_WORK) ||
  221. GroupManager::user_has_access($_user['user_id'], $this_group['id'], GROUP_TOOL_WIKI))
  222. && !(api_is_course_coach() && intval($this_group['session_id']) != intval($_SESSION['id_session']))) {
  223. $orig = isset($origin) ? $origin : null;
  224. $group_name = '<a href="group_space.php?'.api_get_cidreq().'&amp;origin='.$orig.'&amp;gidReq='.$this_group['id'].'">'.stripslashes($this_group['name']).'</a>';
  225. if (!empty($_SESSION['_user']['user_id']) && !empty($this_group['id_tutor']) && $_SESSION['_user']['user_id'] == $this_group['id_tutor']) {
  226. $group_name .= ' ('.get_lang('OneMyGroups').')';
  227. } elseif ($this_group['is_member']) {
  228. $group_name .= ' ('.get_lang('MyGroup').')';
  229. }
  230. if (api_is_allowed_to_edit() && !empty($this_group['session_name'])) {
  231. $group_name .= ' ('.$this_group['session_name'].')';
  232. }
  233. $group_name .= $session_img;
  234. $row[] = $group_name.'<br />'.stripslashes(trim($this_group['description']));
  235. } else {
  236. $row[] = $this_group['name'].'<br />'.stripslashes(trim($this_group['description']));
  237. }
  238. // Self-registration / unregistration
  239. if (!api_is_allowed_to_edit(false, true)) {
  240. if (GroupManager :: is_self_registration_allowed($_user['user_id'], $this_group['id'])) {
  241. $row[] = '<a 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>';
  242. } elseif (GroupManager :: is_self_unregistration_allowed($_user['user_id'], $this_group['id'])) {
  243. $row[] = '<a 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>';
  244. } else {
  245. $row[] = '-';
  246. }
  247. }
  248. // Number of members in group
  249. $row[] = $this_group['number_of_members'];
  250. // Max number of members in group
  251. $row[] = ($this_group['maximum_number_of_members'] == MEMBER_PER_GROUP_NO_LIMIT ? '-' : $this_group['maximum_number_of_members']);
  252. // Tutor name
  253. $tutor_info = '';
  254. if (count($tutorsids_of_group) > 0) {
  255. foreach ($tutorsids_of_group as $tutor_id) {
  256. $tutor = api_get_user_info($tutor_id);
  257. if (api_get_setting('show_email_addresses') == 'true') {
  258. $tutor_info .= Display::encrypted_mailto_link($tutor['mail'], api_get_person_name($tutor['firstName'], $tutor['lastName'])).', ';
  259. } else {
  260. if (api_is_allowed_to_edit()) {
  261. $tutor_info .= Display::encrypted_mailto_link($tutor['mail'], api_get_person_name($tutor['firstName'], $tutor['lastName'])).', ';
  262. } else {
  263. $tutor_info .= api_get_person_name($tutor['firstName'], $tutor['lastName']).', ';
  264. }
  265. }
  266. }
  267. }
  268. $tutor_info = api_substr($tutor_info, 0, api_strlen($tutor_info) - 2);
  269. $row[] = $tutor_info;
  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().'&gidReq='.$this_group['id'].'" title="'.get_lang('Edit').'"><img src="../img/edit.gif" alt="'.get_lang('Edit').'"/></a>&nbsp;';
  273. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq().'&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').'"><img src="../img/delete.gif" alt="'.get_lang('Delete').'"/></a>&nbsp;';
  274. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq().'&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').'"><img src="../img/clean_group.gif" alt="'.get_lang('EmptyGroup').'"/></a>&nbsp;';
  275. $edit_actions .= '<a href="'.api_get_self().'?'.api_get_cidreq().'&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').'"><img src="../img/fill_group.gif" alt="'.get_lang('FillGroup').'"/></a>';
  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('ExistingGroups'));
  296. if (!api_is_allowed_to_edit(false, true)) { // If self-registration allowed
  297. $table->set_header($column++, get_lang('GroupSelfRegistration'));
  298. }
  299. $table->set_header($column++, get_lang('Registered'));
  300. $table->set_header($column++, get_lang('MaximumOfParticipants'));
  301. $table->set_header($column++, get_lang('GroupTutor'));
  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['delete_selected'] = get_lang('Delete');
  306. $form_actions['fill_selected'] = get_lang('FillGroup');
  307. $form_actions['empty_selected'] = get_lang('EmptyGroup');
  308. if (count($group_list) > 1) {
  309. $table->set_form_actions($form_actions, 'group');
  310. }
  311. }
  312. $table->display();
  313. }
  314. /*
  315. elseif ($in_category) {
  316. echo get_lang('NoGroupsAvailable');
  317. }
  318. */
  319. }
  320. /* FOOTER */
  321. if (!isset ($_GET['origin']) || $_GET['origin'] != 'learnpath') {
  322. Display::display_footer();
  323. }