. /** * Cohort related management functions, this file needs to be included manually. * * @package moodlecore * @subpackage cohort * @copyright 2010 Petr Skoda (info@skodak.org) * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */ require_once($CFG->dirroot . '/user/selector/lib.php'); /** * Add new cohort. * @param object $data * @return void */ function cohort_add_cohort($data) { global $DB; $data->timecreated = time(); $data->timemodified = $data->timecreated; $DB->insert_record('cohort', $data); } /** * Update existing cohort. * @param object $data * @return void */ function cohort_update_cohort($data) { global $DB; $data->timemodified = time(); $DB->update_record('cohort', $data); } /** * Delete cohort. * @param object $cohort * @return void */ function cohort_delete_cohort($cohort) { global $DB; if ($cohort->component) { // TODO: add component delete callback } $DB->delete_records('cohort_members', array('cohortid'=>$cohort->id)); $DB->delete_records('cohort', array('id'=>$cohort->id)); } /** * Remove cohort member * @param int $cohortid * @param int $userid * @return void */ function cohort_add_member($cohortid, $userid) { global $DB; $record = new object(); $record->cohortid = $cohortid; $record->userid = $userid; $record->timeadded = time(); $DB->insert_record('cohort_members', $record); } /** * Add cohort member * @param int $cohortid * @param int $userid * @return void */ function cohort_remove_member($cohortid, $userid) { global $DB; $DB->delete_records('cohort_members', array('cohortid'=>$cohortid, 'userid'=>$userid)); } /** * Cohort assignment candidates */ class cohort_candidate_selector extends user_selector_base { protected $cohortid; public function __construct($name, $options) { $this->cohortid = $options['cohortid']; parent::__construct($name, $options); } /** * Candidate users * @param $search * @return array */ public function find_users($search) { global $DB; //by default wherecondition retrieves all users except the deleted, not confirmed and guest list($wherecondition, $params) = $this->search_sql($search, 'u'); $params['cohortid'] = $this->cohortid; $fields = 'SELECT ' . $this->required_fields_sql('u'); $countfields = 'SELECT COUNT(1)'; $sql = " FROM {user} u LEFT JOIN {cohort_members} cm ON (cm.userid = u.id AND cm.cohortid = :cohortid) WHERE cm.id IS NULL AND $wherecondition"; $order = ' ORDER BY u.lastname ASC, u.firstname ASC'; if (!$this->is_validating()) { $potentialmemberscount = $DB->count_records_sql($countfields . $sql, $params); if ($potentialmemberscount > 100) { return $this->too_many_results($search, $potentialmemberscount); } } $availableusers = $DB->get_records_sql($fields . $sql . $order, $params); if (empty($availableusers)) { return array(); } if ($search) { $groupname = get_string('potusersmatching', 'cohort', $search); } else { $groupname = get_string('potusers', 'cohort'); } return array($groupname => $availableusers); } protected function get_options() { $options = parent::get_options(); $options['cohortid'] = $this->cohortid; return $options; } } /** * Cohort assignment candidates */ class cohort_existing_selector extends user_selector_base { protected $cohortid; public function __construct($name, $options) { $this->cohortid = $options['cohortid']; parent::__construct($name, $options); } /** * Candidate users * @param $search * @return array */ public function find_users($search) { global $DB; //by default wherecondition retrieves all users except the deleted, not confirmed and guest list($wherecondition, $params) = $this->search_sql($search, 'u'); $params['cohortid'] = $this->cohortid; $fields = 'SELECT ' . $this->required_fields_sql('u'); $countfields = 'SELECT COUNT(1)'; $sql = " FROM {user} u JOIN {cohort_members} cm ON (cm.userid = u.id AND cm.cohortid = :cohortid) WHERE $wherecondition"; $order = ' ORDER BY u.lastname ASC, u.firstname ASC'; if (!$this->is_validating()) { $potentialmemberscount = $DB->count_records_sql($countfields . $sql, $params); if ($potentialmemberscount > 100) { return $this->too_many_results($search, $potentialmemberscount); } } $availableusers = $DB->get_records_sql($fields . $sql . $order, $params); if (empty($availableusers)) { return array(); } if ($search) { $groupname = get_string('currentusersmatching', 'cohort', $search); } else { $groupname = get_string('currentusers', 'cohort'); } return array($groupname => $availableusers); } protected function get_options() { $options = parent::get_options(); $options['cohortid'] = $this->cohortid; return $options; } }