123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293 |
- <?php
- /*
- ==============================================================================
- Dokeos - elearning and course management software
-
- Copyright (c) 2004 Dokeos S.A.
- Copyright (c) 2003 Ghent University (UGent)
- Copyright (c) 2001 Universite catholique de Louvain (UCL)
- Copyright (c) various contributors
- Copyright (c) Bart Mollet, Hogeschool Gent
-
- For a full list of contributors, see "credits.txt".
- The full license can be read in "license.txt".
-
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License
- as published by the Free Software Foundation; either version 2
- of the License, or (at your option) any later version.
-
- See the GNU General Public License for more details.
-
- Contact: Dokeos, 181 rue Royale, B-1000 Brussels, Belgium, info@dokeos.com
- ==============================================================================
- */
- /**
- ==============================================================================
- * This script displays an area where teachers can edit the group properties and member list.
- * Groups are also often called "teams" in the Dokeos code.
- *
- * @author various contributors
- * @author Roan Embrechts (VUB), partial code cleanup, initial virtual course support
- @package dokeos.group
- * @todo course admin functionality to create groups based on who is in which course (or class).
- ==============================================================================
- */
- /*
- ==============================================================================
- INIT SECTION
- ==============================================================================
- */
- $langFile = "group";
- include ('../inc/global.inc.php');
- $this_section = SECTION_COURSES;
- /*
- -----------------------------------------------------------
- Libraries & settings
- -----------------------------------------------------------
- */
- require_once (api_get_path(LIBRARY_PATH).'course.lib.php');
- require_once (api_get_path(LIBRARY_PATH).'groupmanager.lib.php');
- require_once (api_get_path(LIBRARY_PATH).'formvalidator/FormValidator.class.php');
- /*
- -----------------------------------------------------------
- Constants & variables
- -----------------------------------------------------------
- */
- $current_group = GroupManager :: get_group_properties($_SESSION['_gid']);
- /*
- -----------------------------------------------------------
- Header
- -----------------------------------------------------------
- */
- $nameTools = get_lang('EditGroup');
- $interbreadcrumb[] = array ("url" => "group.php", "name" => get_lang('GroupManagement'));
- if (!api_is_allowed_to_edit())
- {
- api_not_allowed();
- }
- /*
- ==============================================================================
- FUNCTIONS
- ==============================================================================
- */
- /**
- * Function to check the given max number of members per group
- */
- function check_max_number_of_members($value)
- {
- $max_member_no_limit = $value['max_member_no_limit'];
- if ($max_member_no_limit == MEMBER_PER_GROUP_NO_LIMIT)
- {
- return true;
- }
- $max_member = $value['max_member'];
- return is_numeric($max_member);
- }
- /**
- * Function to check if the number of selected group members is valid
- */
- function check_group_members($value)
- {
- if ($value['max_member_no_limit'] == MEMBER_PER_GROUP_NO_LIMIT)
- {
- return true;
- }
- if ($value['max_member'] < count($value['group_members']))
- {
- return array ('group_members' => get_lang('GroupTooMuchMembers'));
- }
- return true;
- }
- /*
- ==============================================================================
- MAIN CODE
- ==============================================================================
- */
- // Build form
- $form = new FormValidator('group_edit');
- $form->addElement('hidden', 'action');
- $form->addElement('hidden', 'referer');
- // Group name
- $form->add_textfield('name', get_lang('GroupName'));
- // Description
- $form->addElement('textarea', 'description', get_lang('GroupDescription'), array ('cols' => 50, 'rows' => 6));
- // Tutors: this has been replaced with the new tutors code
- //$tutors = GroupManager :: get_all_tutors();
- //$possible_tutors[0] = get_lang('GroupNoTutor');
- //foreach ($tutors as $index => $tutor)
- //{
- // $possible_tutors[$tutor['user_id']] = $tutor['lastname'].' '.$tutor['firstname'];
- //}
- //$group = array ();
- //$group[] = & $form->createElement('select', 'tutor_id', null, $possible_tutors);
- //$group[] = & $form->createElement('static', null, null, ' <a href="../user/user.php">'.get_lang('AddTutors').'</a>');
- //$form->addGroup($group, 'tutor_group', get_lang('GroupTutor'), '', false);
- // Members per group
- $form->addElement('radio', 'max_member_no_limit', get_lang('GroupLimit'), get_lang('NoLimit'), MEMBER_PER_GROUP_NO_LIMIT);
- $group = array ();
- $group[] = & $form->createElement('radio', 'max_member_no_limit', null, get_lang('Max'), 1);
- $group[] = & $form->createElement('text', 'max_member', null, array ('size' => 2));
- $group[] = & $form->createElement('static', null, null, get_lang('GroupPlacesThis'));
- $form->addGroup($group, 'max_member_group', null, '', false);
- $form->addRule('max_member_group', get_lang('InvalidMaxNumberOfMembers'), 'callback', 'check_max_number_of_members');
- // Self registration
- $form->addElement('checkbox', 'self_registration_allowed', get_lang('GroupSelfRegistration'), get_lang('GroupAllowStudentRegistration'), 1);
- $form->addElement('checkbox', 'self_unregistration_allowed', null, get_lang('GroupAllowStudentUnregistration'), 1);
- // Documents settings
- $form->addElement('radio', 'doc_state', get_lang('GroupDocument'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
- $form->addElement('radio', 'doc_state', null, get_lang('Public'), TOOL_PUBLIC);
- $form->addElement('radio', 'doc_state', null, get_lang('Private'), TOOL_PRIVATE);
- // Work settings
- $form->addElement('radio', 'work_state', get_lang('GroupWork'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
- $form->addElement('radio', 'work_state', null, get_lang('Public'), TOOL_PUBLIC);
- $form->addElement('radio', 'work_state', null, get_lang('Private'), TOOL_PRIVATE);
- // Calendar settings
- $form->addElement('radio', 'calendar_state', get_lang('GroupCalendar'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
- $form->addElement('radio', 'calendar_state', null, get_lang('Public'), TOOL_PUBLIC);
- $form->addElement('radio', 'calendar_state', null, get_lang('Private'), TOOL_PRIVATE);
- // Announcements settings
- $form->addElement('radio', 'announcements_state', get_lang('GroupAnnouncements'), get_lang('NotAvailable'), TOOL_NOT_AVAILABLE);
- $form->addElement('radio', 'announcements_state', null, get_lang('Public'), TOOL_PUBLIC);
- $form->addElement('radio', 'announcements_state', null, get_lang('Private'), TOOL_PRIVATE);
- // getting all the users
- $complete_user_list = CourseManager :: get_user_list_from_course_code($_course['id']);
- $possible_users = array ();
- foreach ($complete_user_list as $index => $user)
- {
- $possible_users[$user['user_id']] = $user['lastname'].' '.$user['firstname'];
- }
- // Group tutors
- $group_tutor_list = GroupManager :: get_subscribed_tutors($current_group['id']);
- $selected_users = array ();
- foreach ($group_tutor_list as $index => $user)
- {
- //$possible_users[$user['user_id']] = $user['lastname'].' '.$user['firstname'];
- $selected_tutors[] = $user['user_id'];
- }
- $group_tutors_element = $form->addElement('advmultiselect', 'group_tutors', get_lang('GroupTutors'), $possible_users);
- $group_tutors_element->setElementTemplate('
- {javascript}
- <table{class}>
- <!-- BEGIN label_2 --><tr><th>{label_2}</th><!-- END label_2 -->
- <!-- BEGIN label_3 --><th> </th><th>{label_3}</th></tr><!-- END label_3 -->
- <tr>
- <td valign="top">{unselected}</td>
- <td align="center">{add}<br /><br />{remove}</td>
- <td valign="top">{selected}</td>
- </tr>
- </table>
- ');
- // Group members
- $group_member_list = GroupManager :: get_subscribed_users($current_group['id']);
- $selected_users = array ();
- foreach ($group_member_list as $index => $user)
- {
- //$possible_users[$user['user_id']] = $user['lastname'].' '.$user['firstname'];
- $selected_users[] = $user['user_id'];
- }
- $group_members_element = $form->addElement('advmultiselect', 'group_members', get_lang('GroupMembers'), $possible_users);
- $group_members_element->setElementTemplate('
- {javascript}
- <table{class}>
- <!-- BEGIN label_2 --><tr><th>{label_2}</th><!-- END label_2 -->
- <!-- BEGIN label_3 --><th> </th><th>{label_3}</th></tr><!-- END label_3 -->
- <tr>
- <td valign="top">{unselected}</td>
- <td align="center">{add}<br /><br />{remove}</td>
- <td valign="top">{selected}</td>
- </tr>
- </table>
- ');
- $form->addFormRule('check_group_members');
- // submit button
- $form->addElement('submit', 'submit', get_lang('Ok'));
- if ($form->validate())
- {
- $values = $form->exportValues();
- if ($values['max_member_no_limit'] == MEMBER_PER_GROUP_NO_LIMIT)
- {
- $max_member = MEMBER_PER_GROUP_NO_LIMIT;
- }
- else
- {
- $max_member = $values['max_member'];
- }
- $self_registration_allowed = isset ($values['self_registration_allowed']) ? 1 : 0;
- $self_unregistration_allowed = isset ($values['self_unregistration_allowed']) ? 1 : 0;
- 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'], $self_registration_allowed, $self_unregistration_allowed);
-
- // storing the tutors (we first remove all the tutors and then add only those who were selected)
- GroupManager :: unsubscribe_all_tutors($current_group['id']);
- if (isset ($_POST['group_tutors']) && count($_POST['group_tutors']) > 0)
- {
- GroupManager :: subscribe_tutors($values['group_tutors'], $current_group['id']);
- }
-
- // storing the users (we first remove all users and then add only those who were selected)
- GroupManager :: unsubscribe_all_users($current_group['id']);
- if (isset ($_POST['group_members']) && count($_POST['group_members']) > 0)
- {
- GroupManager :: subscribe_users($values['group_members'], $current_group['id']);
- }
-
- // returning to the group area (note: this is inconsistent with the rest of dokeos)
- $cat = GroupManager :: get_category_from_group($current_group['id']);
- header('Location: '.$values['referer'].'?action=show_msg&msg='.get_lang('GroupSettingsModified').'&category='.$cat['id']);
- }
- $defaults = $current_group;
- $defaults['group_members'] = $selected_users;
- $defaults['group_tutors'] = $selected_tutors;
- $defaults['action'] = $action;
- if ($defaults['maximum_number_of_students'] == MEMBER_PER_GROUP_NO_LIMIT)
- {
- $defaults['max_member_no_limit'] = MEMBER_PER_GROUP_NO_LIMIT;
- }
- else
- {
- $defaults['max_member_no_limit'] = 1;
- $defaults['max_member'] = $defaults['maximum_number_of_students'];
- }
- $referer = parse_url($_SERVER['HTTP_REFERER']);
- $referer = basename($referer['path']);
- if ($referer != 'group_space.php' && $referer != 'group.php')
- {
- $referer = 'group.php';
- }
- Display :: display_header($nameTools, "Group");
- api_display_tool_title($nameTools);
- ?>
- <a href="group_space.php"><?php echo get_lang('GroupSpace') ?></a>
- <br/>
- <br/>
- <?php
- $defaults['referer'] = $referer;
- $form->setDefaults($defaults);
- $form->display();
- /*
- ==============================================================================
- FOOTER
- ==============================================================================
- */
- Display :: display_footer();
- ?>
|