c192dc29ec0a163bb6f358a0f755ef56a93f59e6
[moodle.git] / admin / webservice / lib.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  * Web services admin library
19  *
20  * @package   webservice
21  * @copyright 2009 Moodle Pty Ltd (http://moodle.com)
22  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
23  */
25 require_once($CFG->dirroot . '/user/selector/lib.php');
27 /*
28 * This class displays either all the Moodle users allowed to use a service,
29 * either all the other Moodle users.
30  */
31 class service_user_selector extends user_selector_base {
32     const MAX_USERS_PER_PAGE = 100;
34     protected $serviceid;
35     protected $displayallowedusers; //set to true if the selector displays the
36                                     //allowed users on this service
37                                     //, set to false if the selector displays the
38                                     // other users (false is the default default)
40     public function __construct($name, $options) {
41         parent::__construct($name, $options);
42         if (!empty($options['serviceid'])) {
43             $this->serviceid = $options['serviceid'];
44         }
45         else {
46             throw new moodle_exception('serviceidnotfound');
47         }
48         $this->displayallowedusers = !empty($options['displayallowedusers']);
49     }
51     /**
52      * Find allowed or not allowed users of a service (depend of $this->displayallowedusers)
53      * @global object $DB
54      * @param <type> $search
55      * @return array
56      */
57     public function find_users($search) {
58         global $DB;
59         //by default wherecondition retrieves all users except the deleted, not
60         //confirmed and guest
61         list($wherecondition, $params) = $this->search_sql($search, 'u');
62         $params['serviceid'] = $this->serviceid;
65         $fields      = 'SELECT ' . $this->required_fields_sql('u');
66         $countfields = 'SELECT COUNT(1)';
68         if ($this->displayallowedusers) {
69             ///the following SQL retrieve all users that are allowed to the serviceid
70             $sql = " FROM {user} u, {external_services_users} esu
71                  WHERE $wherecondition
72                        AND esu.userid = u.id
73                        AND esu.externalserviceid = :serviceid";
74         }
75         else {
76             ///the following SQL retrieve all users that are not allowed to the serviceid
77             $sql = " FROM {user} u WHERE $wherecondition
78                  AND NOT EXISTS (SELECT esu.userid FROM {external_services_users} esu
79                                                   WHERE esu.externalserviceid = :serviceid
80                                                         AND esu.userid = u.id)";
81         }
83         $order = ' ORDER BY u.lastname ASC, u.firstname ASC';
85         if (!$this->is_validating()) {
86             $potentialmemberscount = $DB->count_records_sql($countfields . $sql, $params);
87             if ($potentialmemberscount > service_user_selector::MAX_USERS_PER_PAGE) {
88                 return $this->too_many_results($search, $potentialmemberscount);
89             }
90         }
92         $availableusers = $DB->get_records_sql($fields . $sql . $order, $params);
94         if (empty($availableusers)) {
95             return array();
96         }
99         if ($search) {
100             $groupname = ($this->displayallowedusers) ?
101                 get_string('serviceusersmatching', 'webservice', $search)
102                 : get_string('potusersmatching', 'webservice', $search);
103         }
104         else {
105             $groupname = ($this->displayallowedusers) ?
106                 get_string('serviceusers', 'webservice')
107                 : get_string('potusers', 'webservice');
108         }
110         return array($groupname => $availableusers);
111     }
113     /**
114      * This options are automatically used by the AJAX search
115      * @global object $CFG
116      * @return object options pass to the constructor when AJAX search call a new selector
117      */
118     protected function get_options() {
119         global $CFG;
120         $options = parent::get_options();
121         $options['file'] = $CFG->admin.'/webservice/lib.php'; //need to be set, otherwise
122                                                         // the /user/selector/search.php
123                                                         //will fail to find this user_selector class
124         $options['serviceid'] = $this->serviceid;
125         $options['displayallowedusers'] = $this->displayallowedusers;
126         return $options;
127     }