ed3a1844621f042b6533744b8909ee57fbf45891
[moodle.git] / admin / roles / classes / potential_assignees_course_and_above.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Library code used by the roles administration interfaces.
19  *
20  * @package    core_role
21  * @copyright  1999 onwards Martin Dougiamas (http://dougiamas.com)
22  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 defined('MOODLE_INTERNAL') || die();
27 /**
28  * User selector subclass for the list of potential users on the assign roles page,
29  * when we are assigning in a context at or above the course level. In this case we
30  * show all the users in the system who do not already have the role.
31  */
32 class core_role_potential_assignees_course_and_above extends core_role_assign_user_selector_base {
33     public function find_users($search) {
34         global $DB;
36         list($wherecondition, $params) = $this->search_sql($search, '');
38         $fields      = 'SELECT ' . $this->required_fields_sql('');
39         $countfields = 'SELECT COUNT(1)';
41         $sql = " FROM {user}
42                 WHERE $wherecondition
43                       AND id NOT IN (
44                          SELECT r.userid
45                            FROM {role_assignments} r
46                           WHERE r.contextid = :contextid
47                                 AND r.roleid = :roleid)";
49         list($sort, $sortparams) = users_order_by_sql('', $search, $this->accesscontext);
50         $order = ' ORDER BY ' . $sort;
52         $params['contextid'] = $this->context->id;
53         $params['roleid'] = $this->roleid;
55         if (!$this->is_validating()) {
56             $potentialmemberscount = $DB->count_records_sql($countfields . $sql, $params);
57             if ($potentialmemberscount > $this->maxusersperpage) {
58                 return $this->too_many_results($search, $potentialmemberscount);
59             }
60         }
62         $availableusers = $DB->get_records_sql($fields . $sql . $order, array_merge($params, $sortparams));
64         if (empty($availableusers)) {
65             return array();
66         }
68         if ($search) {
69             $groupname = get_string('potusersmatching', 'core_role', $search);
70         } else {
71             $groupname = get_string('potusers', 'core_role');
72         }
74         return array($groupname => $availableusers);
75     }
76 }