@@ -37,6 +37,8 @@ discard block |
||
37 | 37 | * |
38 | 38 | * @param int Error code |
39 | 39 | * @param string Error message |
40 | + * @param integer $code |
|
41 | + * @param string $message |
|
40 | 42 | */ |
41 | 43 | public function __construct($code, $message) { |
42 | 44 | $this->code = $code; |
@@ -47,6 +49,7 @@ discard block |
||
47 | 49 | * Sets the error handler |
48 | 50 | * |
49 | 51 | * @param WSErrorHandler Error handler |
52 | + * @param WSSoapErrorHandler $handler |
|
50 | 53 | */ |
51 | 54 | public static function setErrorHandler($handler) { |
52 | 55 | if($handler instanceof WSErrorHandler) { |
@@ -81,6 +84,7 @@ discard block |
||
81 | 84 | * Handle method |
82 | 85 | * |
83 | 86 | * @param WSError Error |
87 | + * @return void |
|
84 | 88 | */ |
85 | 89 | public function handle($error); |
86 | 90 | } |
@@ -107,7 +111,7 @@ discard block |
||
107 | 111 | * Verifies the API key |
108 | 112 | * |
109 | 113 | * @param string Secret key |
110 | - * @return mixed WSError in case of failure, null in case of success |
|
114 | + * @return WSError|null WSError in case of failure, null in case of success |
|
111 | 115 | */ |
112 | 116 | protected function verifyKey($secret_key) { |
113 | 117 | $ip = trim($_SERVER['REMOTE_ADDR']); |
@@ -49,7 +49,7 @@ discard block |
||
49 | 49 | * @param WSErrorHandler Error handler |
50 | 50 | */ |
51 | 51 | public static function setErrorHandler($handler) { |
52 | - if($handler instanceof WSErrorHandler) { |
|
52 | + if ($handler instanceof WSErrorHandler) { |
|
53 | 53 | self::$_handler = $handler; |
54 | 54 | } |
55 | 55 | } |
@@ -114,12 +114,12 @@ discard block |
||
114 | 114 | // if we are behind a reverse proxy, assume it will send the |
115 | 115 | // HTTP_X_FORWARDED_FOR header and use this IP instead |
116 | 116 | if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) { |
117 | - list($ip1,$ip2) = preg_split('/,/',$_SERVER['HTTP_X_FORWARDED_FOR']); |
|
117 | + list($ip1, $ip2) = preg_split('/,/', $_SERVER['HTTP_X_FORWARDED_FOR']); |
|
118 | 118 | $ip = trim($ip1); |
119 | 119 | } |
120 | 120 | $security_key = $ip.$this->_configuration['security_key']; |
121 | 121 | |
122 | - if(!api_is_valid_secret_key($secret_key, $security_key)) { |
|
122 | + if (!api_is_valid_secret_key($secret_key, $security_key)) { |
|
123 | 123 | return new WSError(1, "API key is invalid"); |
124 | 124 | } else { |
125 | 125 | return null; |
@@ -136,15 +136,15 @@ discard block |
||
136 | 136 | * @return mixed System user id if the user was found, WSError otherwise |
137 | 137 | */ |
138 | 138 | protected function getUserId($user_id_field_name, $user_id_value) { |
139 | - if($user_id_field_name == "chamilo_user_id") { |
|
140 | - if(UserManager::is_user_id_valid(intval($user_id_value))) { |
|
139 | + if ($user_id_field_name == "chamilo_user_id") { |
|
140 | + if (UserManager::is_user_id_valid(intval($user_id_value))) { |
|
141 | 141 | return intval($user_id_value); |
142 | 142 | } else { |
143 | 143 | return new WSError(100, "User not found"); |
144 | 144 | } |
145 | 145 | } else { |
146 | 146 | $user_id = UserManager::get_user_id_from_original_id($user_id_value, $user_id_field_name); |
147 | - if($user_id == 0) { |
|
147 | + if ($user_id == 0) { |
|
148 | 148 | return new WSError(100, "User not found"); |
149 | 149 | } else { |
150 | 150 | return $user_id; |
@@ -197,7 +197,7 @@ discard block |
||
197 | 197 | protected function getSessionId($session_id_field_name, $session_id_value) |
198 | 198 | { |
199 | 199 | if ($session_id_field_name == "chamilo_session_id") { |
200 | - $session = SessionManager::fetch((int)$session_id_value); |
|
200 | + $session = SessionManager::fetch((int) $session_id_value); |
|
201 | 201 | if (!empty($session)) { |
202 | 202 | return intval($session_id_value); |
203 | 203 | } else { |
@@ -11,237 +11,237 @@ |
||
11 | 11 | */ |
12 | 12 | class WSError |
13 | 13 | { |
14 | - /** |
|
15 | - * Error handler. This needs to be a class that implements the interface WSErrorHandler |
|
16 | - * |
|
17 | - * @var WSErrorHandler |
|
18 | - */ |
|
19 | - protected static $_handler; |
|
20 | - |
|
21 | - /** |
|
22 | - * Error code |
|
23 | - * |
|
24 | - * @var int |
|
25 | - */ |
|
26 | - public $code; |
|
27 | - |
|
28 | - /** |
|
29 | - * Error message |
|
30 | - * |
|
31 | - * @var string |
|
32 | - */ |
|
33 | - public $message; |
|
34 | - |
|
35 | - /** |
|
36 | - * Constructor |
|
37 | - * |
|
38 | - * @param int Error code |
|
39 | - * @param string Error message |
|
40 | - */ |
|
41 | - public function __construct($code, $message) { |
|
42 | - $this->code = $code; |
|
43 | - $this->message = $message; |
|
44 | - } |
|
45 | - |
|
46 | - /** |
|
47 | - * Sets the error handler |
|
48 | - * |
|
49 | - * @param WSErrorHandler Error handler |
|
50 | - */ |
|
51 | - public static function setErrorHandler($handler) { |
|
52 | - if($handler instanceof WSErrorHandler) { |
|
53 | - self::$_handler = $handler; |
|
54 | - } |
|
55 | - } |
|
56 | - |
|
57 | - /** |
|
58 | - * Returns the error handler |
|
59 | - * |
|
60 | - * @return WSErrorHandler Error handler |
|
61 | - */ |
|
62 | - public static function getErrorHandler() { |
|
63 | - return self::$_handler; |
|
64 | - } |
|
65 | - |
|
66 | - /** |
|
67 | - * Transforms the error into an array |
|
68 | - * |
|
69 | - * @return array Associative array with code and message |
|
70 | - */ |
|
71 | - public function toArray() { |
|
72 | - return array('code' => $this->code, 'message' => $this->message); |
|
73 | - } |
|
14 | + /** |
|
15 | + * Error handler. This needs to be a class that implements the interface WSErrorHandler |
|
16 | + * |
|
17 | + * @var WSErrorHandler |
|
18 | + */ |
|
19 | + protected static $_handler; |
|
20 | + |
|
21 | + /** |
|
22 | + * Error code |
|
23 | + * |
|
24 | + * @var int |
|
25 | + */ |
|
26 | + public $code; |
|
27 | + |
|
28 | + /** |
|
29 | + * Error message |
|
30 | + * |
|
31 | + * @var string |
|
32 | + */ |
|
33 | + public $message; |
|
34 | + |
|
35 | + /** |
|
36 | + * Constructor |
|
37 | + * |
|
38 | + * @param int Error code |
|
39 | + * @param string Error message |
|
40 | + */ |
|
41 | + public function __construct($code, $message) { |
|
42 | + $this->code = $code; |
|
43 | + $this->message = $message; |
|
44 | + } |
|
45 | + |
|
46 | + /** |
|
47 | + * Sets the error handler |
|
48 | + * |
|
49 | + * @param WSErrorHandler Error handler |
|
50 | + */ |
|
51 | + public static function setErrorHandler($handler) { |
|
52 | + if($handler instanceof WSErrorHandler) { |
|
53 | + self::$_handler = $handler; |
|
54 | + } |
|
55 | + } |
|
56 | + |
|
57 | + /** |
|
58 | + * Returns the error handler |
|
59 | + * |
|
60 | + * @return WSErrorHandler Error handler |
|
61 | + */ |
|
62 | + public static function getErrorHandler() { |
|
63 | + return self::$_handler; |
|
64 | + } |
|
65 | + |
|
66 | + /** |
|
67 | + * Transforms the error into an array |
|
68 | + * |
|
69 | + * @return array Associative array with code and message |
|
70 | + */ |
|
71 | + public function toArray() { |
|
72 | + return array('code' => $this->code, 'message' => $this->message); |
|
73 | + } |
|
74 | 74 | } |
75 | 75 | |
76 | 76 | /** |
77 | 77 | * Interface that must be implemented by any error handler |
78 | 78 | */ |
79 | 79 | interface WSErrorHandler { |
80 | - /** |
|
81 | - * Handle method |
|
82 | - * |
|
83 | - * @param WSError Error |
|
84 | - */ |
|
85 | - public function handle($error); |
|
80 | + /** |
|
81 | + * Handle method |
|
82 | + * |
|
83 | + * @param WSError Error |
|
84 | + */ |
|
85 | + public function handle($error); |
|
86 | 86 | } |
87 | 87 | |
88 | 88 | /** |
89 | 89 | * Main class of the webservice. Webservice classes extend this class |
90 | 90 | */ |
91 | 91 | class WS { |
92 | - /** |
|
93 | - * Chamilo configuration |
|
94 | - * |
|
95 | - * @var array |
|
96 | - */ |
|
97 | - protected $_configuration; |
|
98 | - |
|
99 | - /** |
|
100 | - * Constructor |
|
101 | - */ |
|
102 | - public function __construct() { |
|
103 | - $this->_configuration = $GLOBALS['_configuration']; |
|
104 | - } |
|
105 | - |
|
106 | - /** |
|
107 | - * Verifies the API key |
|
108 | - * |
|
109 | - * @param string Secret key |
|
110 | - * @return mixed WSError in case of failure, null in case of success |
|
111 | - */ |
|
112 | - protected function verifyKey($secret_key) { |
|
113 | - $ip = trim($_SERVER['REMOTE_ADDR']); |
|
114 | - // if we are behind a reverse proxy, assume it will send the |
|
115 | - // HTTP_X_FORWARDED_FOR header and use this IP instead |
|
116 | - if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) { |
|
117 | - list($ip1,$ip2) = preg_split('/,/',$_SERVER['HTTP_X_FORWARDED_FOR']); |
|
118 | - $ip = trim($ip1); |
|
119 | - } |
|
120 | - $security_key = $ip.$this->_configuration['security_key']; |
|
121 | - |
|
122 | - if(!api_is_valid_secret_key($secret_key, $security_key)) { |
|
123 | - return new WSError(1, "API key is invalid"); |
|
124 | - } else { |
|
125 | - return null; |
|
126 | - } |
|
127 | - } |
|
128 | - |
|
129 | - /** |
|
130 | - * Gets the real user id based on the user id field name and value. |
|
131 | - * Note that if the user id field name is "chamilo_user_id", it will use the user id |
|
132 | - * in the system database |
|
133 | - * |
|
134 | - * @param string User id field name |
|
135 | - * @param string User id value |
|
136 | - * @return mixed System user id if the user was found, WSError otherwise |
|
137 | - */ |
|
138 | - protected function getUserId($user_id_field_name, $user_id_value) { |
|
139 | - if($user_id_field_name == "chamilo_user_id") { |
|
140 | - if(UserManager::is_user_id_valid(intval($user_id_value))) { |
|
141 | - return intval($user_id_value); |
|
142 | - } else { |
|
143 | - return new WSError(100, "User not found"); |
|
144 | - } |
|
145 | - } else { |
|
146 | - $user_id = UserManager::get_user_id_from_original_id($user_id_value, $user_id_field_name); |
|
147 | - if($user_id == 0) { |
|
148 | - return new WSError(100, "User not found"); |
|
149 | - } else { |
|
150 | - return $user_id; |
|
151 | - } |
|
152 | - } |
|
153 | - } |
|
154 | - |
|
155 | - /** |
|
156 | - * Gets the real course id based on the course id field name and value. |
|
157 | - * Note that if the course id field name is "chamilo_course_id", it will use the course id |
|
158 | - * in the system database |
|
159 | - * |
|
160 | - * @param string Course id field name |
|
161 | - * @param string Course id value |
|
162 | - * @return mixed System course id if the course was found, WSError otherwise |
|
163 | - */ |
|
164 | - protected function getCourseId($course_id_field_name, $course_id_value) |
|
165 | - { |
|
166 | - if ($course_id_field_name == "chamilo_course_id") { |
|
167 | - if (CourseManager::get_course_code_from_course_id( |
|
168 | - intval($course_id_value) |
|
169 | - ) != null |
|
170 | - ) { |
|
171 | - return intval($course_id_value); |
|
172 | - } else { |
|
173 | - return new WSError(200, "Course not found"); |
|
174 | - } |
|
175 | - } else { |
|
176 | - $courseId = CourseManager::get_course_code_from_original_id( |
|
177 | - $course_id_value, |
|
178 | - $course_id_field_name |
|
179 | - ); |
|
180 | - if (!empty($courseId)) { |
|
181 | - return $courseId; |
|
182 | - } else { |
|
183 | - return new WSError(200, "Course not found"); |
|
184 | - } |
|
185 | - } |
|
186 | - } |
|
187 | - |
|
188 | - /** |
|
189 | - * Gets the real session id based on the session id field name and value. |
|
190 | - * Note that if the session id field name is "chamilo_session_id", it will use the session id |
|
191 | - * in the system database |
|
192 | - * |
|
193 | - * @param string Session id field name |
|
194 | - * @param string Session id value |
|
195 | - * @return mixed System session id if the session was found, WSError otherwise |
|
196 | - */ |
|
197 | - protected function getSessionId($session_id_field_name, $session_id_value) |
|
198 | - { |
|
199 | - if ($session_id_field_name == "chamilo_session_id") { |
|
200 | - $session = SessionManager::fetch((int)$session_id_value); |
|
201 | - if (!empty($session)) { |
|
202 | - return intval($session_id_value); |
|
203 | - } else { |
|
204 | - return new WSError(300, "Session not found"); |
|
205 | - } |
|
206 | - } else { |
|
207 | - $session_id = SessionManager::getSessionIdFromOriginalId( |
|
208 | - $session_id_value, |
|
209 | - $session_id_field_name |
|
210 | - ); |
|
211 | - if ($session_id == 0) { |
|
212 | - return new WSError(300, "Session not found"); |
|
213 | - } else { |
|
214 | - return $session_id; |
|
215 | - } |
|
216 | - } |
|
217 | - } |
|
218 | - |
|
219 | - /** |
|
220 | - * Handles an error by calling the WSError error handler |
|
221 | - * |
|
222 | - * @param WSError Error |
|
223 | - */ |
|
224 | - protected function handleError($error) { |
|
225 | - $handler = WSError::getErrorHandler(); |
|
226 | - $handler->handle($error); |
|
227 | - } |
|
228 | - |
|
229 | - /** |
|
230 | - * Gets a successful result |
|
231 | - * |
|
232 | - * @return array Array with a code of 0 and a message 'Operation was successful' |
|
233 | - */ |
|
234 | - protected function getSuccessfulResult() { |
|
235 | - return array('code' => 0, 'message' => 'Operation was successful'); |
|
236 | - } |
|
237 | - |
|
238 | - /** |
|
239 | - * Test function. Returns the string success |
|
240 | - * |
|
241 | - * @return string Success |
|
242 | - */ |
|
243 | - public function test() { |
|
244 | - return "success"; |
|
245 | - } |
|
92 | + /** |
|
93 | + * Chamilo configuration |
|
94 | + * |
|
95 | + * @var array |
|
96 | + */ |
|
97 | + protected $_configuration; |
|
98 | + |
|
99 | + /** |
|
100 | + * Constructor |
|
101 | + */ |
|
102 | + public function __construct() { |
|
103 | + $this->_configuration = $GLOBALS['_configuration']; |
|
104 | + } |
|
105 | + |
|
106 | + /** |
|
107 | + * Verifies the API key |
|
108 | + * |
|
109 | + * @param string Secret key |
|
110 | + * @return mixed WSError in case of failure, null in case of success |
|
111 | + */ |
|
112 | + protected function verifyKey($secret_key) { |
|
113 | + $ip = trim($_SERVER['REMOTE_ADDR']); |
|
114 | + // if we are behind a reverse proxy, assume it will send the |
|
115 | + // HTTP_X_FORWARDED_FOR header and use this IP instead |
|
116 | + if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) { |
|
117 | + list($ip1,$ip2) = preg_split('/,/',$_SERVER['HTTP_X_FORWARDED_FOR']); |
|
118 | + $ip = trim($ip1); |
|
119 | + } |
|
120 | + $security_key = $ip.$this->_configuration['security_key']; |
|
121 | + |
|
122 | + if(!api_is_valid_secret_key($secret_key, $security_key)) { |
|
123 | + return new WSError(1, "API key is invalid"); |
|
124 | + } else { |
|
125 | + return null; |
|
126 | + } |
|
127 | + } |
|
128 | + |
|
129 | + /** |
|
130 | + * Gets the real user id based on the user id field name and value. |
|
131 | + * Note that if the user id field name is "chamilo_user_id", it will use the user id |
|
132 | + * in the system database |
|
133 | + * |
|
134 | + * @param string User id field name |
|
135 | + * @param string User id value |
|
136 | + * @return mixed System user id if the user was found, WSError otherwise |
|
137 | + */ |
|
138 | + protected function getUserId($user_id_field_name, $user_id_value) { |
|
139 | + if($user_id_field_name == "chamilo_user_id") { |
|
140 | + if(UserManager::is_user_id_valid(intval($user_id_value))) { |
|
141 | + return intval($user_id_value); |
|
142 | + } else { |
|
143 | + return new WSError(100, "User not found"); |
|
144 | + } |
|
145 | + } else { |
|
146 | + $user_id = UserManager::get_user_id_from_original_id($user_id_value, $user_id_field_name); |
|
147 | + if($user_id == 0) { |
|
148 | + return new WSError(100, "User not found"); |
|
149 | + } else { |
|
150 | + return $user_id; |
|
151 | + } |
|
152 | + } |
|
153 | + } |
|
154 | + |
|
155 | + /** |
|
156 | + * Gets the real course id based on the course id field name and value. |
|
157 | + * Note that if the course id field name is "chamilo_course_id", it will use the course id |
|
158 | + * in the system database |
|
159 | + * |
|
160 | + * @param string Course id field name |
|
161 | + * @param string Course id value |
|
162 | + * @return mixed System course id if the course was found, WSError otherwise |
|
163 | + */ |
|
164 | + protected function getCourseId($course_id_field_name, $course_id_value) |
|
165 | + { |
|
166 | + if ($course_id_field_name == "chamilo_course_id") { |
|
167 | + if (CourseManager::get_course_code_from_course_id( |
|
168 | + intval($course_id_value) |
|
169 | + ) != null |
|
170 | + ) { |
|
171 | + return intval($course_id_value); |
|
172 | + } else { |
|
173 | + return new WSError(200, "Course not found"); |
|
174 | + } |
|
175 | + } else { |
|
176 | + $courseId = CourseManager::get_course_code_from_original_id( |
|
177 | + $course_id_value, |
|
178 | + $course_id_field_name |
|
179 | + ); |
|
180 | + if (!empty($courseId)) { |
|
181 | + return $courseId; |
|
182 | + } else { |
|
183 | + return new WSError(200, "Course not found"); |
|
184 | + } |
|
185 | + } |
|
186 | + } |
|
187 | + |
|
188 | + /** |
|
189 | + * Gets the real session id based on the session id field name and value. |
|
190 | + * Note that if the session id field name is "chamilo_session_id", it will use the session id |
|
191 | + * in the system database |
|
192 | + * |
|
193 | + * @param string Session id field name |
|
194 | + * @param string Session id value |
|
195 | + * @return mixed System session id if the session was found, WSError otherwise |
|
196 | + */ |
|
197 | + protected function getSessionId($session_id_field_name, $session_id_value) |
|
198 | + { |
|
199 | + if ($session_id_field_name == "chamilo_session_id") { |
|
200 | + $session = SessionManager::fetch((int)$session_id_value); |
|
201 | + if (!empty($session)) { |
|
202 | + return intval($session_id_value); |
|
203 | + } else { |
|
204 | + return new WSError(300, "Session not found"); |
|
205 | + } |
|
206 | + } else { |
|
207 | + $session_id = SessionManager::getSessionIdFromOriginalId( |
|
208 | + $session_id_value, |
|
209 | + $session_id_field_name |
|
210 | + ); |
|
211 | + if ($session_id == 0) { |
|
212 | + return new WSError(300, "Session not found"); |
|
213 | + } else { |
|
214 | + return $session_id; |
|
215 | + } |
|
216 | + } |
|
217 | + } |
|
218 | + |
|
219 | + /** |
|
220 | + * Handles an error by calling the WSError error handler |
|
221 | + * |
|
222 | + * @param WSError Error |
|
223 | + */ |
|
224 | + protected function handleError($error) { |
|
225 | + $handler = WSError::getErrorHandler(); |
|
226 | + $handler->handle($error); |
|
227 | + } |
|
228 | + |
|
229 | + /** |
|
230 | + * Gets a successful result |
|
231 | + * |
|
232 | + * @return array Array with a code of 0 and a message 'Operation was successful' |
|
233 | + */ |
|
234 | + protected function getSuccessfulResult() { |
|
235 | + return array('code' => 0, 'message' => 'Operation was successful'); |
|
236 | + } |
|
237 | + |
|
238 | + /** |
|
239 | + * Test function. Returns the string success |
|
240 | + * |
|
241 | + * @return string Success |
|
242 | + */ |
|
243 | + public function test() { |
|
244 | + return "success"; |
|
245 | + } |
|
246 | 246 | } |
247 | 247 |
@@ -453,6 +453,7 @@ |
||
453 | 453 | * @param string Session id field name |
454 | 454 | * @param string Session id value |
455 | 455 | * @param int State (1 to subscribe, 0 to unsubscribe) |
456 | + * @param integer $state |
|
456 | 457 | * @return mixed True on success, WSError otherwise |
457 | 458 | */ |
458 | 459 | protected function changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, $state) { |
@@ -14,177 +14,177 @@ discard block |
||
14 | 14 | class WSSession extends WS |
15 | 15 | { |
16 | 16 | |
17 | - /** |
|
18 | - * Creates a session (helper method) |
|
19 | - * |
|
20 | - * @param string Name of the session |
|
21 | - * @param string Start date, use the 'YYYY-MM-DD' format |
|
22 | - * @param string End date, use the 'YYYY-MM-DD' format |
|
23 | - * @param int Access delays of the coach (days before) |
|
24 | - * @param int Access delays of the coach (days after) |
|
25 | - * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
26 | - * @param int Visibility |
|
27 | - * @param string User id field name for the coach |
|
28 | - * @param string User id value for the coach |
|
29 | - * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
30 | - * @param string Original session id value |
|
31 | - * @param array Array of extra fields |
|
32 | - * @return mixed Generated id in case of success, WSError otherwise |
|
33 | - */ |
|
34 | - protected function createSessionHelper( |
|
35 | - $name, |
|
36 | - $start_date, |
|
37 | - $end_date, |
|
38 | - $nb_days_access_before, |
|
39 | - $nb_days_access_after, |
|
40 | - $nolimit, |
|
41 | - $visibility, |
|
42 | - $user_id_field_name, |
|
43 | - $user_id_value, |
|
44 | - $session_id_field_name, |
|
45 | - $session_id_value, |
|
46 | - $extras |
|
47 | - ) { |
|
48 | - // Verify that coach exists and get its id |
|
49 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
50 | - if ($user_id instanceof WSError) { |
|
51 | - return $user_id; |
|
52 | - } |
|
17 | + /** |
|
18 | + * Creates a session (helper method) |
|
19 | + * |
|
20 | + * @param string Name of the session |
|
21 | + * @param string Start date, use the 'YYYY-MM-DD' format |
|
22 | + * @param string End date, use the 'YYYY-MM-DD' format |
|
23 | + * @param int Access delays of the coach (days before) |
|
24 | + * @param int Access delays of the coach (days after) |
|
25 | + * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
26 | + * @param int Visibility |
|
27 | + * @param string User id field name for the coach |
|
28 | + * @param string User id value for the coach |
|
29 | + * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
30 | + * @param string Original session id value |
|
31 | + * @param array Array of extra fields |
|
32 | + * @return mixed Generated id in case of success, WSError otherwise |
|
33 | + */ |
|
34 | + protected function createSessionHelper( |
|
35 | + $name, |
|
36 | + $start_date, |
|
37 | + $end_date, |
|
38 | + $nb_days_access_before, |
|
39 | + $nb_days_access_after, |
|
40 | + $nolimit, |
|
41 | + $visibility, |
|
42 | + $user_id_field_name, |
|
43 | + $user_id_value, |
|
44 | + $session_id_field_name, |
|
45 | + $session_id_value, |
|
46 | + $extras |
|
47 | + ) { |
|
48 | + // Verify that coach exists and get its id |
|
49 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
50 | + if ($user_id instanceof WSError) { |
|
51 | + return $user_id; |
|
52 | + } |
|
53 | 53 | |
54 | - $coachStartDate = null; |
|
55 | - if (!empty($nb_days_access_before)) { |
|
56 | - $day = intval($nb_days_access_before); |
|
57 | - $coachStartDate = date('Y-m-d ', strtotime($start_date. ' + '.$day.' days')); |
|
58 | - } |
|
54 | + $coachStartDate = null; |
|
55 | + if (!empty($nb_days_access_before)) { |
|
56 | + $day = intval($nb_days_access_before); |
|
57 | + $coachStartDate = date('Y-m-d ', strtotime($start_date. ' + '.$day.' days')); |
|
58 | + } |
|
59 | 59 | |
60 | - $coachEndDate = null; |
|
61 | - if (!empty($nb_days_access_after)) { |
|
62 | - $day = intval($nb_days_access_after); |
|
63 | - $coachEndDate = date('Y-m-d ', strtotime($end_date. ' + '.$day.' days')); |
|
64 | - } |
|
60 | + $coachEndDate = null; |
|
61 | + if (!empty($nb_days_access_after)) { |
|
62 | + $day = intval($nb_days_access_after); |
|
63 | + $coachEndDate = date('Y-m-d ', strtotime($end_date. ' + '.$day.' days')); |
|
64 | + } |
|
65 | 65 | |
66 | - // Try to create the session |
|
67 | - $session_id = SessionManager::create_session( |
|
68 | - $name, |
|
69 | - $start_date, |
|
70 | - $end_date, |
|
71 | - $start_date, |
|
72 | - $end_date, |
|
73 | - $coachStartDate, |
|
74 | - $coachEndDate, |
|
75 | - $user_id, |
|
76 | - 0, |
|
77 | - $visibility |
|
78 | - ); |
|
79 | - if(!is_int($session_id)) { |
|
80 | - return new WSError(301, 'Could not create the session'); |
|
81 | - } else { |
|
82 | - // Add the Original session id to the extra fields |
|
83 | - $extras_associative = array(); |
|
84 | - if($session_id_field_name != "chamilo_session_id") { |
|
85 | - $extras_associative[$session_id_field_name] = $session_id_value; |
|
86 | - } |
|
87 | - foreach($extras as $extra) { |
|
88 | - $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
89 | - } |
|
90 | - // Create the extra fields |
|
91 | - foreach($extras_associative as $fname => $fvalue) { |
|
92 | - SessionManager::create_session_extra_field($fname, 1, $fname); |
|
93 | - SessionManager::update_session_extra_field_value( |
|
94 | - $session_id, |
|
95 | - $fname, |
|
96 | - $fvalue |
|
97 | - ); |
|
98 | - } |
|
99 | - return $session_id; |
|
100 | - } |
|
101 | - } |
|
66 | + // Try to create the session |
|
67 | + $session_id = SessionManager::create_session( |
|
68 | + $name, |
|
69 | + $start_date, |
|
70 | + $end_date, |
|
71 | + $start_date, |
|
72 | + $end_date, |
|
73 | + $coachStartDate, |
|
74 | + $coachEndDate, |
|
75 | + $user_id, |
|
76 | + 0, |
|
77 | + $visibility |
|
78 | + ); |
|
79 | + if(!is_int($session_id)) { |
|
80 | + return new WSError(301, 'Could not create the session'); |
|
81 | + } else { |
|
82 | + // Add the Original session id to the extra fields |
|
83 | + $extras_associative = array(); |
|
84 | + if($session_id_field_name != "chamilo_session_id") { |
|
85 | + $extras_associative[$session_id_field_name] = $session_id_value; |
|
86 | + } |
|
87 | + foreach($extras as $extra) { |
|
88 | + $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
89 | + } |
|
90 | + // Create the extra fields |
|
91 | + foreach($extras_associative as $fname => $fvalue) { |
|
92 | + SessionManager::create_session_extra_field($fname, 1, $fname); |
|
93 | + SessionManager::update_session_extra_field_value( |
|
94 | + $session_id, |
|
95 | + $fname, |
|
96 | + $fvalue |
|
97 | + ); |
|
98 | + } |
|
99 | + return $session_id; |
|
100 | + } |
|
101 | + } |
|
102 | 102 | |
103 | - /** |
|
104 | - * Creates a session |
|
105 | - * |
|
106 | - * @param string API secret key |
|
107 | - * @param string Name of the session |
|
108 | - * @param string Start date, use the 'YYYY-MM-DD' format |
|
109 | - * @param string End date, use the 'YYYY-MM-DD' format |
|
110 | - * @param int Access delays of the coach (days before) |
|
111 | - * @param int Access delays of the coach (days after) |
|
112 | - * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
113 | - * @param int Visibility |
|
114 | - * @param string User id field name for the coach |
|
115 | - * @param string User id value for the coach |
|
116 | - * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
117 | - * @param string Original session id value |
|
118 | - * @param array Array of extra fields |
|
119 | - * @return int Session id generated |
|
120 | - */ |
|
121 | - public function CreateSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
|
122 | - $verifKey = $this->verifyKey($secret_key); |
|
123 | - if($verifKey instanceof WSError) { |
|
124 | - $this->handleError($verifKey); |
|
125 | - } else { |
|
126 | - $session_id = $this->createSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
|
127 | - if($session_id instanceof WSError) { |
|
128 | - $this->handleError($session_id); |
|
129 | - } else { |
|
130 | - return $session_id; |
|
131 | - } |
|
132 | - } |
|
133 | - } |
|
103 | + /** |
|
104 | + * Creates a session |
|
105 | + * |
|
106 | + * @param string API secret key |
|
107 | + * @param string Name of the session |
|
108 | + * @param string Start date, use the 'YYYY-MM-DD' format |
|
109 | + * @param string End date, use the 'YYYY-MM-DD' format |
|
110 | + * @param int Access delays of the coach (days before) |
|
111 | + * @param int Access delays of the coach (days after) |
|
112 | + * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
113 | + * @param int Visibility |
|
114 | + * @param string User id field name for the coach |
|
115 | + * @param string User id value for the coach |
|
116 | + * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
117 | + * @param string Original session id value |
|
118 | + * @param array Array of extra fields |
|
119 | + * @return int Session id generated |
|
120 | + */ |
|
121 | + public function CreateSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
|
122 | + $verifKey = $this->verifyKey($secret_key); |
|
123 | + if($verifKey instanceof WSError) { |
|
124 | + $this->handleError($verifKey); |
|
125 | + } else { |
|
126 | + $session_id = $this->createSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
|
127 | + if($session_id instanceof WSError) { |
|
128 | + $this->handleError($session_id); |
|
129 | + } else { |
|
130 | + return $session_id; |
|
131 | + } |
|
132 | + } |
|
133 | + } |
|
134 | 134 | |
135 | - /** |
|
136 | - * Deletes a session (helper method) |
|
137 | - * |
|
138 | - * @param string Session id field name |
|
139 | - * @param string Session id value |
|
140 | - * @return mixed True in case of success, WSError otherwise |
|
141 | - */ |
|
142 | - protected function deleteSessionHelper($session_id_field_name, $session_id_value) { |
|
143 | - $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
144 | - if($session_id instanceof WSError) { |
|
145 | - return $session_id; |
|
146 | - } else { |
|
147 | - SessionManager::delete($session_id, true); |
|
148 | - return true; |
|
149 | - } |
|
150 | - } |
|
135 | + /** |
|
136 | + * Deletes a session (helper method) |
|
137 | + * |
|
138 | + * @param string Session id field name |
|
139 | + * @param string Session id value |
|
140 | + * @return mixed True in case of success, WSError otherwise |
|
141 | + */ |
|
142 | + protected function deleteSessionHelper($session_id_field_name, $session_id_value) { |
|
143 | + $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
144 | + if($session_id instanceof WSError) { |
|
145 | + return $session_id; |
|
146 | + } else { |
|
147 | + SessionManager::delete($session_id, true); |
|
148 | + return true; |
|
149 | + } |
|
150 | + } |
|
151 | 151 | |
152 | - /** |
|
153 | - * Deletes a session |
|
154 | - * |
|
155 | - * @param string API secret key |
|
156 | - * @param string Session id field name |
|
157 | - * @param string Session id value |
|
158 | - */ |
|
159 | - public function DeleteSession($secret_key, $session_id_field_name, $session_id_value) { |
|
160 | - $verifKey = $this->verifyKey($secret_key); |
|
161 | - if($verifKey instanceof WSError) { |
|
162 | - $this->handleError($verifKey); |
|
163 | - } else { |
|
164 | - $result = $this->deleteSessionHelper($session_id_field_name, $session_id_value); |
|
165 | - if($result instanceof WSError) { |
|
166 | - $this->handleError($result); |
|
167 | - } |
|
168 | - } |
|
169 | - } |
|
152 | + /** |
|
153 | + * Deletes a session |
|
154 | + * |
|
155 | + * @param string API secret key |
|
156 | + * @param string Session id field name |
|
157 | + * @param string Session id value |
|
158 | + */ |
|
159 | + public function DeleteSession($secret_key, $session_id_field_name, $session_id_value) { |
|
160 | + $verifKey = $this->verifyKey($secret_key); |
|
161 | + if($verifKey instanceof WSError) { |
|
162 | + $this->handleError($verifKey); |
|
163 | + } else { |
|
164 | + $result = $this->deleteSessionHelper($session_id_field_name, $session_id_value); |
|
165 | + if($result instanceof WSError) { |
|
166 | + $this->handleError($result); |
|
167 | + } |
|
168 | + } |
|
169 | + } |
|
170 | 170 | |
171 | - /** |
|
172 | - * Edits a session (helper method) |
|
173 | - * |
|
174 | - * @param string Name of the session |
|
175 | - * @param string Start date, use the 'YYYY-MM-DD' format |
|
176 | - * @param string End date, use the 'YYYY-MM-DD' format |
|
177 | - * @param int Access delays of the coach (days before) |
|
178 | - * @param int Access delays of the coach (days after) |
|
179 | - * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
180 | - * @param int Visibility |
|
181 | - * @param string User id field name for the coach |
|
182 | - * @param string User id value for the coach |
|
183 | - * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
184 | - * @param string Original session id value |
|
185 | - * @param array Array of extra fields |
|
186 | - * @return mixed True on success, WSError otherwise |
|
187 | - */ |
|
171 | + /** |
|
172 | + * Edits a session (helper method) |
|
173 | + * |
|
174 | + * @param string Name of the session |
|
175 | + * @param string Start date, use the 'YYYY-MM-DD' format |
|
176 | + * @param string End date, use the 'YYYY-MM-DD' format |
|
177 | + * @param int Access delays of the coach (days before) |
|
178 | + * @param int Access delays of the coach (days after) |
|
179 | + * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
180 | + * @param int Visibility |
|
181 | + * @param string User id field name for the coach |
|
182 | + * @param string User id value for the coach |
|
183 | + * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
184 | + * @param string Original session id value |
|
185 | + * @param array Array of extra fields |
|
186 | + * @return mixed True on success, WSError otherwise |
|
187 | + */ |
|
188 | 188 | protected function editSessionHelper( |
189 | 189 | $name, |
190 | 190 | $start_date, |
@@ -199,15 +199,15 @@ discard block |
||
199 | 199 | $session_id_value, |
200 | 200 | $extras |
201 | 201 | ) { |
202 | - $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
203 | - if($session_id instanceof WSError) { |
|
204 | - return $session_id; |
|
205 | - } else { |
|
206 | - // Verify that coach exists and get its id |
|
207 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
208 | - if ($user_id instanceof WSError) { |
|
209 | - return $user_id; |
|
210 | - } |
|
202 | + $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
203 | + if($session_id instanceof WSError) { |
|
204 | + return $session_id; |
|
205 | + } else { |
|
206 | + // Verify that coach exists and get its id |
|
207 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
208 | + if ($user_id instanceof WSError) { |
|
209 | + return $user_id; |
|
210 | + } |
|
211 | 211 | |
212 | 212 | $coachStartDate = null; |
213 | 213 | if (!empty($nb_days_access_before)) { |
@@ -234,127 +234,127 @@ discard block |
||
234 | 234 | 0, |
235 | 235 | (int)$visibility |
236 | 236 | ); |
237 | - if(!is_int($result_id)) { |
|
238 | - return new WSError(302, 'Could not edit the session'); |
|
239 | - } else { |
|
240 | - if(!empty($extras)) { |
|
241 | - $extras_associative = array(); |
|
242 | - foreach($extras as $extra) { |
|
243 | - $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
244 | - } |
|
245 | - // Create the extra fields |
|
246 | - foreach($extras_associative as $fname => $fvalue) { |
|
247 | - SessionManager::create_session_extra_field($fname, 1, $fname); |
|
248 | - SessionManager::update_session_extra_field_value($session_id, $fname, $fvalue); |
|
249 | - } |
|
250 | - } |
|
251 | - return true; |
|
252 | - } |
|
253 | - } |
|
254 | - } |
|
237 | + if(!is_int($result_id)) { |
|
238 | + return new WSError(302, 'Could not edit the session'); |
|
239 | + } else { |
|
240 | + if(!empty($extras)) { |
|
241 | + $extras_associative = array(); |
|
242 | + foreach($extras as $extra) { |
|
243 | + $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
244 | + } |
|
245 | + // Create the extra fields |
|
246 | + foreach($extras_associative as $fname => $fvalue) { |
|
247 | + SessionManager::create_session_extra_field($fname, 1, $fname); |
|
248 | + SessionManager::update_session_extra_field_value($session_id, $fname, $fvalue); |
|
249 | + } |
|
250 | + } |
|
251 | + return true; |
|
252 | + } |
|
253 | + } |
|
254 | + } |
|
255 | 255 | |
256 | - /** |
|
257 | - * Edits a session |
|
258 | - * |
|
259 | - * @param string API secret key |
|
260 | - * @param string Name of the session |
|
261 | - * @param string Start date, use the 'YYYY-MM-DD' format |
|
262 | - * @param string End date, use the 'YYYY-MM-DD' format |
|
263 | - * @param int Access delays of the coach (days before) |
|
264 | - * @param int Access delays of the coach (days after) |
|
265 | - * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
266 | - * @param int Visibility |
|
267 | - * @param string User id field name for the coach |
|
268 | - * @param string User id value for the coach |
|
269 | - * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
270 | - * @param string Original session id value |
|
271 | - * @param array Array of extra fields |
|
272 | - */ |
|
273 | - public function EditSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
|
274 | - $verifKey = $this->verifyKey($secret_key); |
|
275 | - if($verifKey instanceof WSError) { |
|
276 | - $this->handleError($verifKey); |
|
277 | - } else { |
|
278 | - $result = $this->editSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
|
279 | - if($session_id_value instanceof WSError) { |
|
280 | - $this->handleError($result); |
|
281 | - } |
|
282 | - } |
|
283 | - } |
|
256 | + /** |
|
257 | + * Edits a session |
|
258 | + * |
|
259 | + * @param string API secret key |
|
260 | + * @param string Name of the session |
|
261 | + * @param string Start date, use the 'YYYY-MM-DD' format |
|
262 | + * @param string End date, use the 'YYYY-MM-DD' format |
|
263 | + * @param int Access delays of the coach (days before) |
|
264 | + * @param int Access delays of the coach (days after) |
|
265 | + * @param int Nolimit (0 = no limit of time, 1 = limit of time) |
|
266 | + * @param int Visibility |
|
267 | + * @param string User id field name for the coach |
|
268 | + * @param string User id value for the coach |
|
269 | + * @param string Original session id field name (use "chamilo_session_id" to use internal id) |
|
270 | + * @param string Original session id value |
|
271 | + * @param array Array of extra fields |
|
272 | + */ |
|
273 | + public function EditSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
|
274 | + $verifKey = $this->verifyKey($secret_key); |
|
275 | + if($verifKey instanceof WSError) { |
|
276 | + $this->handleError($verifKey); |
|
277 | + } else { |
|
278 | + $result = $this->editSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
|
279 | + if($session_id_value instanceof WSError) { |
|
280 | + $this->handleError($result); |
|
281 | + } |
|
282 | + } |
|
283 | + } |
|
284 | 284 | |
285 | - /** |
|
286 | - * Change user subscription (helper method) |
|
287 | - * |
|
288 | - * @param string User id field name |
|
289 | - * @param string User id value |
|
290 | - * @param string Session id field name |
|
291 | - * @param string Session id value |
|
292 | - * @param int State (1 to subscribe, 0 to unsubscribe) |
|
293 | - * @return mixed True on success, WSError otherwise |
|
294 | - */ |
|
295 | - protected function changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $state) { |
|
296 | - $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
297 | - if($session_id instanceof WSError) { |
|
298 | - return $session_id; |
|
299 | - } else { |
|
300 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
301 | - if($user_id instanceof WSError) { |
|
302 | - return $user_id; |
|
303 | - } else { |
|
304 | - if($state == 1) { |
|
305 | - SessionManager::suscribe_users_to_session($session_id, array($user_id)); |
|
306 | - } else { |
|
307 | - $result = SessionManager::unsubscribe_user_from_session($session_id, $user_id); |
|
308 | - if (!$result) { |
|
309 | - return new WSError(303, 'There was an error unsubscribing this user from the session'); |
|
310 | - } |
|
311 | - } |
|
312 | - return true; |
|
313 | - } |
|
314 | - } |
|
315 | - } |
|
285 | + /** |
|
286 | + * Change user subscription (helper method) |
|
287 | + * |
|
288 | + * @param string User id field name |
|
289 | + * @param string User id value |
|
290 | + * @param string Session id field name |
|
291 | + * @param string Session id value |
|
292 | + * @param int State (1 to subscribe, 0 to unsubscribe) |
|
293 | + * @return mixed True on success, WSError otherwise |
|
294 | + */ |
|
295 | + protected function changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $state) { |
|
296 | + $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
297 | + if($session_id instanceof WSError) { |
|
298 | + return $session_id; |
|
299 | + } else { |
|
300 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
301 | + if($user_id instanceof WSError) { |
|
302 | + return $user_id; |
|
303 | + } else { |
|
304 | + if($state == 1) { |
|
305 | + SessionManager::suscribe_users_to_session($session_id, array($user_id)); |
|
306 | + } else { |
|
307 | + $result = SessionManager::unsubscribe_user_from_session($session_id, $user_id); |
|
308 | + if (!$result) { |
|
309 | + return new WSError(303, 'There was an error unsubscribing this user from the session'); |
|
310 | + } |
|
311 | + } |
|
312 | + return true; |
|
313 | + } |
|
314 | + } |
|
315 | + } |
|
316 | 316 | |
317 | - /** |
|
318 | - * Subscribe user to a session |
|
319 | - * |
|
320 | - * @param string API secret key |
|
321 | - * @param string User id field name |
|
322 | - * @param string User id value |
|
323 | - * @param string Session id field name |
|
324 | - * @param string Session id value |
|
325 | - */ |
|
326 | - public function SubscribeUserToSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
|
327 | - $verifKey = $this->verifyKey($secret_key); |
|
328 | - if($verifKey instanceof WSError) { |
|
329 | - $this->handleError($verifKey); |
|
330 | - } else { |
|
331 | - $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 1); |
|
332 | - if($result instanceof WSError) { |
|
333 | - $this->handleError($result); |
|
334 | - } |
|
335 | - } |
|
336 | - } |
|
317 | + /** |
|
318 | + * Subscribe user to a session |
|
319 | + * |
|
320 | + * @param string API secret key |
|
321 | + * @param string User id field name |
|
322 | + * @param string User id value |
|
323 | + * @param string Session id field name |
|
324 | + * @param string Session id value |
|
325 | + */ |
|
326 | + public function SubscribeUserToSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
|
327 | + $verifKey = $this->verifyKey($secret_key); |
|
328 | + if($verifKey instanceof WSError) { |
|
329 | + $this->handleError($verifKey); |
|
330 | + } else { |
|
331 | + $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 1); |
|
332 | + if($result instanceof WSError) { |
|
333 | + $this->handleError($result); |
|
334 | + } |
|
335 | + } |
|
336 | + } |
|
337 | 337 | |
338 | - /** |
|
339 | - * Subscribe user to a session |
|
340 | - * |
|
341 | - * @param string API secret key |
|
342 | - * @param string User id field name |
|
343 | - * @param string User id value |
|
344 | - * @param string Session id field name |
|
345 | - * @param string Session id value |
|
346 | - */ |
|
347 | - public function UnsubscribeUserFromSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
|
348 | - $verifKey = $this->verifyKey($secret_key); |
|
349 | - if($verifKey instanceof WSError) { |
|
350 | - $this->handleError($verifKey); |
|
351 | - } else { |
|
352 | - $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 0); |
|
353 | - if($result instanceof WSError) { |
|
354 | - $this->handleError($result); |
|
355 | - } |
|
356 | - } |
|
357 | - } |
|
338 | + /** |
|
339 | + * Subscribe user to a session |
|
340 | + * |
|
341 | + * @param string API secret key |
|
342 | + * @param string User id field name |
|
343 | + * @param string User id value |
|
344 | + * @param string Session id field name |
|
345 | + * @param string Session id value |
|
346 | + */ |
|
347 | + public function UnsubscribeUserFromSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
|
348 | + $verifKey = $this->verifyKey($secret_key); |
|
349 | + if($verifKey instanceof WSError) { |
|
350 | + $this->handleError($verifKey); |
|
351 | + } else { |
|
352 | + $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 0); |
|
353 | + if($result instanceof WSError) { |
|
354 | + $this->handleError($result); |
|
355 | + } |
|
356 | + } |
|
357 | + } |
|
358 | 358 | |
359 | 359 | /** |
360 | 360 | * Change Teacher subscription (helper method) |
@@ -446,79 +446,79 @@ discard block |
||
446 | 446 | } |
447 | 447 | |
448 | 448 | /** |
449 | - * Change course subscription |
|
450 | - * |
|
451 | - * @param string Course id field name |
|
452 | - * @param string Course id value |
|
453 | - * @param string Session id field name |
|
454 | - * @param string Session id value |
|
455 | - * @param int State (1 to subscribe, 0 to unsubscribe) |
|
456 | - * @return mixed True on success, WSError otherwise |
|
457 | - */ |
|
458 | - protected function changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, $state) { |
|
459 | - $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
460 | - if($session_id instanceof WSError) { |
|
461 | - return $session_id; |
|
462 | - } else { |
|
463 | - $course_id = $this->getCourseId($course_id_field_name, $course_id_value); |
|
464 | - if($course_id instanceof WSError) { |
|
465 | - return $course_id; |
|
466 | - } else { |
|
467 | - if($state == 1) { |
|
468 | - SessionManager::add_courses_to_session($session_id, array($course_id)); |
|
469 | - return true; |
|
470 | - } else { |
|
471 | - $result = SessionManager::unsubscribe_course_from_session($session_id, $course_id); |
|
472 | - if ($result) { |
|
473 | - return true; |
|
474 | - } else { |
|
475 | - return new WSError(304, 'Error unsubscribing course from session'); |
|
476 | - } |
|
477 | - } |
|
478 | - } |
|
479 | - } |
|
449 | + * Change course subscription |
|
450 | + * |
|
451 | + * @param string Course id field name |
|
452 | + * @param string Course id value |
|
453 | + * @param string Session id field name |
|
454 | + * @param string Session id value |
|
455 | + * @param int State (1 to subscribe, 0 to unsubscribe) |
|
456 | + * @return mixed True on success, WSError otherwise |
|
457 | + */ |
|
458 | + protected function changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, $state) { |
|
459 | + $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
|
460 | + if($session_id instanceof WSError) { |
|
461 | + return $session_id; |
|
462 | + } else { |
|
463 | + $course_id = $this->getCourseId($course_id_field_name, $course_id_value); |
|
464 | + if($course_id instanceof WSError) { |
|
465 | + return $course_id; |
|
466 | + } else { |
|
467 | + if($state == 1) { |
|
468 | + SessionManager::add_courses_to_session($session_id, array($course_id)); |
|
469 | + return true; |
|
470 | + } else { |
|
471 | + $result = SessionManager::unsubscribe_course_from_session($session_id, $course_id); |
|
472 | + if ($result) { |
|
473 | + return true; |
|
474 | + } else { |
|
475 | + return new WSError(304, 'Error unsubscribing course from session'); |
|
476 | + } |
|
477 | + } |
|
478 | + } |
|
479 | + } |
|
480 | 480 | } |
481 | 481 | |
482 | - /** |
|
483 | - * Subscribe course to session |
|
484 | - * |
|
485 | - * @param string API secret key |
|
486 | - * @param string Course id field name |
|
487 | - * @param string Course id value |
|
488 | - * @param string Session id field name |
|
489 | - * @param string Session id value |
|
490 | - */ |
|
491 | - public function SubscribeCourseToSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
|
492 | - $verifKey = $this->verifyKey($secret_key); |
|
493 | - if($verifKey instanceof WSError) { |
|
494 | - $this->handleError($verifKey); |
|
495 | - } else { |
|
496 | - $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 1); |
|
497 | - if($result instanceof WSError) { |
|
498 | - $this->handleError($result); |
|
499 | - } |
|
500 | - } |
|
501 | - } |
|
482 | + /** |
|
483 | + * Subscribe course to session |
|
484 | + * |
|
485 | + * @param string API secret key |
|
486 | + * @param string Course id field name |
|
487 | + * @param string Course id value |
|
488 | + * @param string Session id field name |
|
489 | + * @param string Session id value |
|
490 | + */ |
|
491 | + public function SubscribeCourseToSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
|
492 | + $verifKey = $this->verifyKey($secret_key); |
|
493 | + if($verifKey instanceof WSError) { |
|
494 | + $this->handleError($verifKey); |
|
495 | + } else { |
|
496 | + $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 1); |
|
497 | + if($result instanceof WSError) { |
|
498 | + $this->handleError($result); |
|
499 | + } |
|
500 | + } |
|
501 | + } |
|
502 | 502 | |
503 | - /** |
|
504 | - * Unsubscribe course from session |
|
505 | - * |
|
506 | - * @param string API secret key |
|
507 | - * @param string Course id field name |
|
508 | - * @param string Course id value |
|
509 | - * @param string Session id field name |
|
510 | - * @param string Session id value |
|
511 | - */ |
|
512 | - public function UnsubscribeCourseFromSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
|
513 | - $verifKey = $this->verifyKey($secret_key); |
|
514 | - if($verifKey instanceof WSError) { |
|
515 | - $this->handleError($verifKey); |
|
516 | - } else { |
|
517 | - $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 0); |
|
518 | - if($result instanceof WSError) { |
|
519 | - $this->handleError($result); |
|
520 | - } |
|
521 | - } |
|
522 | - } |
|
503 | + /** |
|
504 | + * Unsubscribe course from session |
|
505 | + * |
|
506 | + * @param string API secret key |
|
507 | + * @param string Course id field name |
|
508 | + * @param string Course id value |
|
509 | + * @param string Session id field name |
|
510 | + * @param string Session id value |
|
511 | + */ |
|
512 | + public function UnsubscribeCourseFromSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
|
513 | + $verifKey = $this->verifyKey($secret_key); |
|
514 | + if($verifKey instanceof WSError) { |
|
515 | + $this->handleError($verifKey); |
|
516 | + } else { |
|
517 | + $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 0); |
|
518 | + if($result instanceof WSError) { |
|
519 | + $this->handleError($result); |
|
520 | + } |
|
521 | + } |
|
522 | + } |
|
523 | 523 | |
524 | 524 | } |
@@ -54,13 +54,13 @@ discard block |
||
54 | 54 | $coachStartDate = null; |
55 | 55 | if (!empty($nb_days_access_before)) { |
56 | 56 | $day = intval($nb_days_access_before); |
57 | - $coachStartDate = date('Y-m-d ', strtotime($start_date. ' + '.$day.' days')); |
|
57 | + $coachStartDate = date('Y-m-d ', strtotime($start_date.' + '.$day.' days')); |
|
58 | 58 | } |
59 | 59 | |
60 | 60 | $coachEndDate = null; |
61 | 61 | if (!empty($nb_days_access_after)) { |
62 | 62 | $day = intval($nb_days_access_after); |
63 | - $coachEndDate = date('Y-m-d ', strtotime($end_date. ' + '.$day.' days')); |
|
63 | + $coachEndDate = date('Y-m-d ', strtotime($end_date.' + '.$day.' days')); |
|
64 | 64 | } |
65 | 65 | |
66 | 66 | // Try to create the session |
@@ -76,19 +76,19 @@ discard block |
||
76 | 76 | 0, |
77 | 77 | $visibility |
78 | 78 | ); |
79 | - if(!is_int($session_id)) { |
|
79 | + if (!is_int($session_id)) { |
|
80 | 80 | return new WSError(301, 'Could not create the session'); |
81 | 81 | } else { |
82 | 82 | // Add the Original session id to the extra fields |
83 | 83 | $extras_associative = array(); |
84 | - if($session_id_field_name != "chamilo_session_id") { |
|
84 | + if ($session_id_field_name != "chamilo_session_id") { |
|
85 | 85 | $extras_associative[$session_id_field_name] = $session_id_value; |
86 | 86 | } |
87 | - foreach($extras as $extra) { |
|
87 | + foreach ($extras as $extra) { |
|
88 | 88 | $extras_associative[$extra['field_name']] = $extra['field_value']; |
89 | 89 | } |
90 | 90 | // Create the extra fields |
91 | - foreach($extras_associative as $fname => $fvalue) { |
|
91 | + foreach ($extras_associative as $fname => $fvalue) { |
|
92 | 92 | SessionManager::create_session_extra_field($fname, 1, $fname); |
93 | 93 | SessionManager::update_session_extra_field_value( |
94 | 94 | $session_id, |
@@ -120,11 +120,11 @@ discard block |
||
120 | 120 | */ |
121 | 121 | public function CreateSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
122 | 122 | $verifKey = $this->verifyKey($secret_key); |
123 | - if($verifKey instanceof WSError) { |
|
123 | + if ($verifKey instanceof WSError) { |
|
124 | 124 | $this->handleError($verifKey); |
125 | 125 | } else { |
126 | 126 | $session_id = $this->createSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
127 | - if($session_id instanceof WSError) { |
|
127 | + if ($session_id instanceof WSError) { |
|
128 | 128 | $this->handleError($session_id); |
129 | 129 | } else { |
130 | 130 | return $session_id; |
@@ -141,7 +141,7 @@ discard block |
||
141 | 141 | */ |
142 | 142 | protected function deleteSessionHelper($session_id_field_name, $session_id_value) { |
143 | 143 | $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
144 | - if($session_id instanceof WSError) { |
|
144 | + if ($session_id instanceof WSError) { |
|
145 | 145 | return $session_id; |
146 | 146 | } else { |
147 | 147 | SessionManager::delete($session_id, true); |
@@ -158,11 +158,11 @@ discard block |
||
158 | 158 | */ |
159 | 159 | public function DeleteSession($secret_key, $session_id_field_name, $session_id_value) { |
160 | 160 | $verifKey = $this->verifyKey($secret_key); |
161 | - if($verifKey instanceof WSError) { |
|
161 | + if ($verifKey instanceof WSError) { |
|
162 | 162 | $this->handleError($verifKey); |
163 | 163 | } else { |
164 | 164 | $result = $this->deleteSessionHelper($session_id_field_name, $session_id_value); |
165 | - if($result instanceof WSError) { |
|
165 | + if ($result instanceof WSError) { |
|
166 | 166 | $this->handleError($result); |
167 | 167 | } |
168 | 168 | } |
@@ -200,7 +200,7 @@ discard block |
||
200 | 200 | $extras |
201 | 201 | ) { |
202 | 202 | $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
203 | - if($session_id instanceof WSError) { |
|
203 | + if ($session_id instanceof WSError) { |
|
204 | 204 | return $session_id; |
205 | 205 | } else { |
206 | 206 | // Verify that coach exists and get its id |
@@ -212,13 +212,13 @@ discard block |
||
212 | 212 | $coachStartDate = null; |
213 | 213 | if (!empty($nb_days_access_before)) { |
214 | 214 | $day = intval($nb_days_access_before); |
215 | - $coachStartDate = date('Y-m-d ', strtotime($start_date. ' + '.$day.' days')); |
|
215 | + $coachStartDate = date('Y-m-d ', strtotime($start_date.' + '.$day.' days')); |
|
216 | 216 | } |
217 | 217 | |
218 | 218 | $coachEndDate = null; |
219 | 219 | if (!empty($nb_days_access_after)) { |
220 | 220 | $day = intval($nb_days_access_after); |
221 | - $coachEndDate = date('Y-m-d ', strtotime($end_date. ' + '.$day.' days')); |
|
221 | + $coachEndDate = date('Y-m-d ', strtotime($end_date.' + '.$day.' days')); |
|
222 | 222 | } |
223 | 223 | |
224 | 224 | $result_id = SessionManager::edit_session( |
@@ -232,18 +232,18 @@ discard block |
||
232 | 232 | $coachEndDate, |
233 | 233 | $user_id, |
234 | 234 | 0, |
235 | - (int)$visibility |
|
235 | + (int) $visibility |
|
236 | 236 | ); |
237 | - if(!is_int($result_id)) { |
|
237 | + if (!is_int($result_id)) { |
|
238 | 238 | return new WSError(302, 'Could not edit the session'); |
239 | 239 | } else { |
240 | - if(!empty($extras)) { |
|
240 | + if (!empty($extras)) { |
|
241 | 241 | $extras_associative = array(); |
242 | - foreach($extras as $extra) { |
|
242 | + foreach ($extras as $extra) { |
|
243 | 243 | $extras_associative[$extra['field_name']] = $extra['field_value']; |
244 | 244 | } |
245 | 245 | // Create the extra fields |
246 | - foreach($extras_associative as $fname => $fvalue) { |
|
246 | + foreach ($extras_associative as $fname => $fvalue) { |
|
247 | 247 | SessionManager::create_session_extra_field($fname, 1, $fname); |
248 | 248 | SessionManager::update_session_extra_field_value($session_id, $fname, $fvalue); |
249 | 249 | } |
@@ -272,11 +272,11 @@ discard block |
||
272 | 272 | */ |
273 | 273 | public function EditSession($secret_key, $name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras) { |
274 | 274 | $verifKey = $this->verifyKey($secret_key); |
275 | - if($verifKey instanceof WSError) { |
|
275 | + if ($verifKey instanceof WSError) { |
|
276 | 276 | $this->handleError($verifKey); |
277 | 277 | } else { |
278 | 278 | $result = $this->editSessionHelper($name, $start_date, $end_date, $nb_days_access_before, $nb_days_access_after, $nolimit, $visibility, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $extras); |
279 | - if($session_id_value instanceof WSError) { |
|
279 | + if ($session_id_value instanceof WSError) { |
|
280 | 280 | $this->handleError($result); |
281 | 281 | } |
282 | 282 | } |
@@ -294,14 +294,14 @@ discard block |
||
294 | 294 | */ |
295 | 295 | protected function changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, $state) { |
296 | 296 | $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
297 | - if($session_id instanceof WSError) { |
|
297 | + if ($session_id instanceof WSError) { |
|
298 | 298 | return $session_id; |
299 | 299 | } else { |
300 | 300 | $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
301 | - if($user_id instanceof WSError) { |
|
301 | + if ($user_id instanceof WSError) { |
|
302 | 302 | return $user_id; |
303 | 303 | } else { |
304 | - if($state == 1) { |
|
304 | + if ($state == 1) { |
|
305 | 305 | SessionManager::suscribe_users_to_session($session_id, array($user_id)); |
306 | 306 | } else { |
307 | 307 | $result = SessionManager::unsubscribe_user_from_session($session_id, $user_id); |
@@ -325,11 +325,11 @@ discard block |
||
325 | 325 | */ |
326 | 326 | public function SubscribeUserToSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
327 | 327 | $verifKey = $this->verifyKey($secret_key); |
328 | - if($verifKey instanceof WSError) { |
|
328 | + if ($verifKey instanceof WSError) { |
|
329 | 329 | $this->handleError($verifKey); |
330 | 330 | } else { |
331 | 331 | $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 1); |
332 | - if($result instanceof WSError) { |
|
332 | + if ($result instanceof WSError) { |
|
333 | 333 | $this->handleError($result); |
334 | 334 | } |
335 | 335 | } |
@@ -346,11 +346,11 @@ discard block |
||
346 | 346 | */ |
347 | 347 | public function UnsubscribeUserFromSession($secret_key, $user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value) { |
348 | 348 | $verifKey = $this->verifyKey($secret_key); |
349 | - if($verifKey instanceof WSError) { |
|
349 | + if ($verifKey instanceof WSError) { |
|
350 | 350 | $this->handleError($verifKey); |
351 | 351 | } else { |
352 | 352 | $result = $this->changeUserSubscription($user_id_field_name, $user_id_value, $session_id_field_name, $session_id_value, 0); |
353 | - if($result instanceof WSError) { |
|
353 | + if ($result instanceof WSError) { |
|
354 | 354 | $this->handleError($result); |
355 | 355 | } |
356 | 356 | } |
@@ -385,7 +385,7 @@ discard block |
||
385 | 385 | if ($state == 1) { |
386 | 386 | SessionManager::set_coach_to_course_session($user_id, $session_id, $course_id); |
387 | 387 | } else { |
388 | - $user_id = array (0 => $user_id); |
|
388 | + $user_id = array(0 => $user_id); |
|
389 | 389 | $result = SessionManager::removeUsersFromCourseSession($user_id, $session_id, $course_id); |
390 | 390 | if (!$result) { |
391 | 391 | return new WSError(303, 'There was an error unsubscribing this Teacher from the session'); |
@@ -457,14 +457,14 @@ discard block |
||
457 | 457 | */ |
458 | 458 | protected function changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, $state) { |
459 | 459 | $session_id = $this->getSessionId($session_id_field_name, $session_id_value); |
460 | - if($session_id instanceof WSError) { |
|
460 | + if ($session_id instanceof WSError) { |
|
461 | 461 | return $session_id; |
462 | 462 | } else { |
463 | 463 | $course_id = $this->getCourseId($course_id_field_name, $course_id_value); |
464 | - if($course_id instanceof WSError) { |
|
464 | + if ($course_id instanceof WSError) { |
|
465 | 465 | return $course_id; |
466 | 466 | } else { |
467 | - if($state == 1) { |
|
467 | + if ($state == 1) { |
|
468 | 468 | SessionManager::add_courses_to_session($session_id, array($course_id)); |
469 | 469 | return true; |
470 | 470 | } else { |
@@ -490,11 +490,11 @@ discard block |
||
490 | 490 | */ |
491 | 491 | public function SubscribeCourseToSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
492 | 492 | $verifKey = $this->verifyKey($secret_key); |
493 | - if($verifKey instanceof WSError) { |
|
493 | + if ($verifKey instanceof WSError) { |
|
494 | 494 | $this->handleError($verifKey); |
495 | 495 | } else { |
496 | 496 | $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 1); |
497 | - if($result instanceof WSError) { |
|
497 | + if ($result instanceof WSError) { |
|
498 | 498 | $this->handleError($result); |
499 | 499 | } |
500 | 500 | } |
@@ -511,11 +511,11 @@ discard block |
||
511 | 511 | */ |
512 | 512 | public function UnsubscribeCourseFromSession($secret_key, $course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value) { |
513 | 513 | $verifKey = $this->verifyKey($secret_key); |
514 | - if($verifKey instanceof WSError) { |
|
514 | + if ($verifKey instanceof WSError) { |
|
515 | 515 | $this->handleError($verifKey); |
516 | 516 | } else { |
517 | 517 | $result = $this->changeCourseSubscription($course_id_field_name, $course_id_value, $session_id_field_name, $session_id_value, 0); |
518 | - if($result instanceof WSError) { |
|
518 | + if ($result instanceof WSError) { |
|
519 | 519 | $this->handleError($result); |
520 | 520 | } |
521 | 521 | } |
@@ -36,6 +36,7 @@ discard block |
||
36 | 36 | * |
37 | 37 | * @param array Users |
38 | 38 | * @param int Set to 1 to enable and to 0 to disable |
39 | + * @param integer $state |
|
39 | 40 | * @return array Array of results |
40 | 41 | */ |
41 | 42 | protected function changeUsersActiveState($users, $state) { |
@@ -217,6 +218,11 @@ discard block |
||
217 | 218 | * @param string Phone. |
218 | 219 | * @param string Expiration date |
219 | 220 | * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). |
221 | + * @param integer|null $visibility |
|
222 | + * @param string|null $email |
|
223 | + * @param string|null $language |
|
224 | + * @param string|null $phone |
|
225 | + * @param string|null $expiration_date |
|
220 | 226 | * @return mixed New user id generated by the system, WSError otherwise |
221 | 227 | */ |
222 | 228 | protected function createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras = array()) { |
@@ -11,232 +11,232 @@ discard block |
||
11 | 11 | */ |
12 | 12 | class WSUser extends WS { |
13 | 13 | |
14 | - /** |
|
15 | - * Enables or disables a user |
|
16 | - * |
|
17 | - * @param string User id field name |
|
18 | - * @param string User id value |
|
19 | - * @param int Set to 1 to enable and to 0 to disable |
|
20 | - */ |
|
21 | - protected function changeUserActiveState($user_id_field_name, $user_id_value, $state) { |
|
22 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
23 | - if($user_id instanceof WSError) { |
|
24 | - return $user_id; |
|
25 | - } else { |
|
26 | - if($state == 0) { |
|
27 | - UserManager::disable($user_id); |
|
28 | - } else if($state == 1) { |
|
29 | - UserManager::enable($user_id); |
|
30 | - } |
|
31 | - } |
|
32 | - } |
|
14 | + /** |
|
15 | + * Enables or disables a user |
|
16 | + * |
|
17 | + * @param string User id field name |
|
18 | + * @param string User id value |
|
19 | + * @param int Set to 1 to enable and to 0 to disable |
|
20 | + */ |
|
21 | + protected function changeUserActiveState($user_id_field_name, $user_id_value, $state) { |
|
22 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
23 | + if($user_id instanceof WSError) { |
|
24 | + return $user_id; |
|
25 | + } else { |
|
26 | + if($state == 0) { |
|
27 | + UserManager::disable($user_id); |
|
28 | + } else if($state == 1) { |
|
29 | + UserManager::enable($user_id); |
|
30 | + } |
|
31 | + } |
|
32 | + } |
|
33 | 33 | |
34 | - /** |
|
35 | - * Enables or disables multiple users |
|
36 | - * |
|
37 | - * @param array Users |
|
38 | - * @param int Set to 1 to enable and to 0 to disable |
|
39 | - * @return array Array of results |
|
40 | - */ |
|
41 | - protected function changeUsersActiveState($users, $state) { |
|
42 | - $results = array(); |
|
43 | - foreach($users as $user) { |
|
44 | - $result_tmp = array(); |
|
45 | - $result_op = $this->changeUserActiveState($user['user_id_field_name'], $user['user_id_value'], $state); |
|
46 | - $result_tmp['user_id_value'] = $user['user_id_value']; |
|
47 | - if($result_op instanceof WSError) { |
|
48 | - // Return the error in the results |
|
49 | - $result_tmp['result'] = $result_op->toArray(); |
|
50 | - } else { |
|
51 | - $result_tmp['result'] = $this->getSuccessfulResult(); |
|
52 | - } |
|
53 | - $results[] = $result_tmp; |
|
54 | - } |
|
55 | - return $results; |
|
56 | - } |
|
34 | + /** |
|
35 | + * Enables or disables multiple users |
|
36 | + * |
|
37 | + * @param array Users |
|
38 | + * @param int Set to 1 to enable and to 0 to disable |
|
39 | + * @return array Array of results |
|
40 | + */ |
|
41 | + protected function changeUsersActiveState($users, $state) { |
|
42 | + $results = array(); |
|
43 | + foreach($users as $user) { |
|
44 | + $result_tmp = array(); |
|
45 | + $result_op = $this->changeUserActiveState($user['user_id_field_name'], $user['user_id_value'], $state); |
|
46 | + $result_tmp['user_id_value'] = $user['user_id_value']; |
|
47 | + if($result_op instanceof WSError) { |
|
48 | + // Return the error in the results |
|
49 | + $result_tmp['result'] = $result_op->toArray(); |
|
50 | + } else { |
|
51 | + $result_tmp['result'] = $this->getSuccessfulResult(); |
|
52 | + } |
|
53 | + $results[] = $result_tmp; |
|
54 | + } |
|
55 | + return $results; |
|
56 | + } |
|
57 | 57 | |
58 | - /** |
|
59 | - * Disables a user |
|
60 | - * |
|
61 | - * @param string API secret key |
|
62 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
63 | - * @param string User id value |
|
64 | - */ |
|
65 | - public function DisableUser($secret_key, $user_id_field_name, $user_id_value) { |
|
66 | - $verifKey = $this->verifyKey($secret_key); |
|
67 | - if($verifKey instanceof WSError) { |
|
68 | - // Let the implementation handle it |
|
69 | - $this->handleError($verifKey); |
|
70 | - } else { |
|
71 | - $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 0); |
|
72 | - if($result instanceof WSError) { |
|
73 | - $this->handleError($result); |
|
74 | - } |
|
75 | - } |
|
76 | - } |
|
58 | + /** |
|
59 | + * Disables a user |
|
60 | + * |
|
61 | + * @param string API secret key |
|
62 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
63 | + * @param string User id value |
|
64 | + */ |
|
65 | + public function DisableUser($secret_key, $user_id_field_name, $user_id_value) { |
|
66 | + $verifKey = $this->verifyKey($secret_key); |
|
67 | + if($verifKey instanceof WSError) { |
|
68 | + // Let the implementation handle it |
|
69 | + $this->handleError($verifKey); |
|
70 | + } else { |
|
71 | + $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 0); |
|
72 | + if($result instanceof WSError) { |
|
73 | + $this->handleError($result); |
|
74 | + } |
|
75 | + } |
|
76 | + } |
|
77 | 77 | |
78 | - /** |
|
79 | - * Disables multiple users |
|
80 | - * |
|
81 | - * @param string API secret key |
|
82 | - * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
83 | - * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
84 | - * than 0, an error occured |
|
85 | - */ |
|
86 | - public function DisableUsers($secret_key, $users) { |
|
87 | - $verifKey = $this->verifyKey($secret_key); |
|
88 | - if($verifKey instanceof WSError) { |
|
89 | - // Let the implementation handle it |
|
90 | - $this->handleError($verifKey); |
|
91 | - } else { |
|
92 | - return $this->changeUsersActiveState($users, 0); |
|
93 | - } |
|
94 | - } |
|
78 | + /** |
|
79 | + * Disables multiple users |
|
80 | + * |
|
81 | + * @param string API secret key |
|
82 | + * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
83 | + * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
84 | + * than 0, an error occured |
|
85 | + */ |
|
86 | + public function DisableUsers($secret_key, $users) { |
|
87 | + $verifKey = $this->verifyKey($secret_key); |
|
88 | + if($verifKey instanceof WSError) { |
|
89 | + // Let the implementation handle it |
|
90 | + $this->handleError($verifKey); |
|
91 | + } else { |
|
92 | + return $this->changeUsersActiveState($users, 0); |
|
93 | + } |
|
94 | + } |
|
95 | 95 | |
96 | - /** |
|
97 | - * Enables a user |
|
98 | - * |
|
99 | - * @param string API secret key |
|
100 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
101 | - * @param string User id value |
|
102 | - */ |
|
103 | - public function EnableUser($secret_key, $user_id_field_name, $user_id_value) { |
|
104 | - $verifKey = $this->verifyKey($secret_key); |
|
105 | - if($verifKey instanceof WSError) { |
|
106 | - $this->handleError($verifKey); |
|
107 | - } else { |
|
108 | - $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 1); |
|
109 | - if($result instanceof WSError) { |
|
110 | - $this->handleError($result); |
|
111 | - } |
|
112 | - } |
|
113 | - } |
|
96 | + /** |
|
97 | + * Enables a user |
|
98 | + * |
|
99 | + * @param string API secret key |
|
100 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
101 | + * @param string User id value |
|
102 | + */ |
|
103 | + public function EnableUser($secret_key, $user_id_field_name, $user_id_value) { |
|
104 | + $verifKey = $this->verifyKey($secret_key); |
|
105 | + if($verifKey instanceof WSError) { |
|
106 | + $this->handleError($verifKey); |
|
107 | + } else { |
|
108 | + $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 1); |
|
109 | + if($result instanceof WSError) { |
|
110 | + $this->handleError($result); |
|
111 | + } |
|
112 | + } |
|
113 | + } |
|
114 | 114 | |
115 | - /** |
|
116 | - * Enables multiple users |
|
117 | - * |
|
118 | - * @param string API secret key |
|
119 | - * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
120 | - * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
121 | - * than 0, an error occured |
|
122 | - */ |
|
123 | - public function EnableUsers($secret_key, $users) { |
|
124 | - $verifKey = $this->verifyKey($secret_key); |
|
125 | - if($verifKey instanceof WSError) { |
|
126 | - // Let the implementation handle it |
|
127 | - $this->handleError($verifKey); |
|
128 | - } else { |
|
129 | - return $this->changeUsersActiveState($users, 1); |
|
130 | - } |
|
131 | - } |
|
115 | + /** |
|
116 | + * Enables multiple users |
|
117 | + * |
|
118 | + * @param string API secret key |
|
119 | + * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
120 | + * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
121 | + * than 0, an error occured |
|
122 | + */ |
|
123 | + public function EnableUsers($secret_key, $users) { |
|
124 | + $verifKey = $this->verifyKey($secret_key); |
|
125 | + if($verifKey instanceof WSError) { |
|
126 | + // Let the implementation handle it |
|
127 | + $this->handleError($verifKey); |
|
128 | + } else { |
|
129 | + return $this->changeUsersActiveState($users, 1); |
|
130 | + } |
|
131 | + } |
|
132 | 132 | |
133 | - /** |
|
134 | - * Deletes a user (helper method) |
|
135 | - * |
|
136 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
137 | - * @param string User id value |
|
138 | - * @return mixed True if user was successfully deleted, WSError otherwise |
|
139 | - */ |
|
140 | - protected function deleteUserHelper($user_id_field_name, $user_id_value) { |
|
141 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
142 | - if($user_id instanceof WSError) { |
|
143 | - return $user_id; |
|
144 | - } else { |
|
145 | - if(!UserManager::delete_user($user_id)) { |
|
146 | - return new WSError(101, "There was a problem while deleting this user"); |
|
147 | - } else { |
|
148 | - return true; |
|
149 | - } |
|
150 | - } |
|
151 | - } |
|
133 | + /** |
|
134 | + * Deletes a user (helper method) |
|
135 | + * |
|
136 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
137 | + * @param string User id value |
|
138 | + * @return mixed True if user was successfully deleted, WSError otherwise |
|
139 | + */ |
|
140 | + protected function deleteUserHelper($user_id_field_name, $user_id_value) { |
|
141 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
142 | + if($user_id instanceof WSError) { |
|
143 | + return $user_id; |
|
144 | + } else { |
|
145 | + if(!UserManager::delete_user($user_id)) { |
|
146 | + return new WSError(101, "There was a problem while deleting this user"); |
|
147 | + } else { |
|
148 | + return true; |
|
149 | + } |
|
150 | + } |
|
151 | + } |
|
152 | 152 | |
153 | - /** |
|
154 | - * Deletes a user |
|
155 | - * |
|
156 | - * @param string API secret key |
|
157 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
158 | - * @param string User id value |
|
159 | - */ |
|
160 | - public function DeleteUser($secret_key, $user_id_field_name, $user_id_value) { |
|
161 | - $verifKey = $this->verifyKey($secret_key); |
|
162 | - if($verifKey instanceof WSError) { |
|
163 | - $this->handleError($verifKey); |
|
164 | - } else { |
|
165 | - $result = $this->deleteUserHelper($user_id_field_name, $user_id_value); |
|
166 | - if($result instanceof WSError) { |
|
167 | - $this->handleError($result); |
|
168 | - } |
|
169 | - } |
|
170 | - } |
|
153 | + /** |
|
154 | + * Deletes a user |
|
155 | + * |
|
156 | + * @param string API secret key |
|
157 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
158 | + * @param string User id value |
|
159 | + */ |
|
160 | + public function DeleteUser($secret_key, $user_id_field_name, $user_id_value) { |
|
161 | + $verifKey = $this->verifyKey($secret_key); |
|
162 | + if($verifKey instanceof WSError) { |
|
163 | + $this->handleError($verifKey); |
|
164 | + } else { |
|
165 | + $result = $this->deleteUserHelper($user_id_field_name, $user_id_value); |
|
166 | + if($result instanceof WSError) { |
|
167 | + $this->handleError($result); |
|
168 | + } |
|
169 | + } |
|
170 | + } |
|
171 | 171 | |
172 | - /** |
|
173 | - * Deletes multiple users |
|
174 | - * |
|
175 | - * @param string API secret key |
|
176 | - * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
177 | - * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
178 | - * than 0, an error occured |
|
179 | - */ |
|
180 | - public function DeleteUsers($secret_key, $users) { |
|
181 | - $verifKey = $this->verifyKey($secret_key); |
|
182 | - if($verifKey instanceof WSError) { |
|
183 | - $this->handleError($verifKey); |
|
184 | - } else { |
|
185 | - $results = array(); |
|
186 | - foreach($users as $user) { |
|
187 | - $result_tmp = array(); |
|
188 | - $result_op = $this->deleteUserHelper($user['user_id_field_name'], $user['user_id_value']); |
|
189 | - $result_tmp['user_id_value'] = $user['user_id_value']; |
|
190 | - if($result_op instanceof WSError) { |
|
191 | - // Return the error in the results |
|
192 | - $result_tmp['result'] = $result_op->toArray(); |
|
193 | - } else { |
|
194 | - $result_tmp['result'] = $this->getSuccessfulResult(); |
|
195 | - } |
|
196 | - $results[] = $result_tmp; |
|
197 | - } |
|
198 | - return $results; |
|
199 | - } |
|
200 | - } |
|
172 | + /** |
|
173 | + * Deletes multiple users |
|
174 | + * |
|
175 | + * @param string API secret key |
|
176 | + * @param array Array of users with elements of the form array('user_id_field_name' => 'name_of_field', 'user_id_value' => 'value') |
|
177 | + * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
178 | + * than 0, an error occured |
|
179 | + */ |
|
180 | + public function DeleteUsers($secret_key, $users) { |
|
181 | + $verifKey = $this->verifyKey($secret_key); |
|
182 | + if($verifKey instanceof WSError) { |
|
183 | + $this->handleError($verifKey); |
|
184 | + } else { |
|
185 | + $results = array(); |
|
186 | + foreach($users as $user) { |
|
187 | + $result_tmp = array(); |
|
188 | + $result_op = $this->deleteUserHelper($user['user_id_field_name'], $user['user_id_value']); |
|
189 | + $result_tmp['user_id_value'] = $user['user_id_value']; |
|
190 | + if($result_op instanceof WSError) { |
|
191 | + // Return the error in the results |
|
192 | + $result_tmp['result'] = $result_op->toArray(); |
|
193 | + } else { |
|
194 | + $result_tmp['result'] = $this->getSuccessfulResult(); |
|
195 | + } |
|
196 | + $results[] = $result_tmp; |
|
197 | + } |
|
198 | + return $results; |
|
199 | + } |
|
200 | + } |
|
201 | 201 | |
202 | - /** |
|
203 | - * Creates a user (helper method) |
|
204 | - * |
|
205 | - * @param string User first name |
|
206 | - * @param string User last name |
|
207 | - * @param int User status |
|
208 | - * @param string Login name |
|
209 | - * @param string Password (encrypted or not) |
|
210 | - * @param string Encrypt method. Leave blank if you are passing the password in clear text, set to the encrypt method used to encrypt the password otherwise. Remember |
|
211 | - * to include the salt in the extra fields if you are encrypting the password |
|
212 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
213 | - * @param string User id value. Leave blank if you are using the internal user_id |
|
214 | - * @param int Visibility. |
|
215 | - * @param string User email. |
|
216 | - * @param string Language. |
|
217 | - * @param string Phone. |
|
218 | - * @param string Expiration date |
|
219 | - * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). |
|
220 | - * @return mixed New user id generated by the system, WSError otherwise |
|
221 | - */ |
|
222 | - protected function createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras = array()) { |
|
202 | + /** |
|
203 | + * Creates a user (helper method) |
|
204 | + * |
|
205 | + * @param string User first name |
|
206 | + * @param string User last name |
|
207 | + * @param int User status |
|
208 | + * @param string Login name |
|
209 | + * @param string Password (encrypted or not) |
|
210 | + * @param string Encrypt method. Leave blank if you are passing the password in clear text, set to the encrypt method used to encrypt the password otherwise. Remember |
|
211 | + * to include the salt in the extra fields if you are encrypting the password |
|
212 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
213 | + * @param string User id value. Leave blank if you are using the internal user_id |
|
214 | + * @param int Visibility. |
|
215 | + * @param string User email. |
|
216 | + * @param string Language. |
|
217 | + * @param string Phone. |
|
218 | + * @param string Expiration date |
|
219 | + * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). |
|
220 | + * @return mixed New user id generated by the system, WSError otherwise |
|
221 | + */ |
|
222 | + protected function createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras = array()) { |
|
223 | 223 | |
224 | - // Add the original user id field name and value to the extra fields if needed |
|
225 | - $extras_associative = array(); |
|
226 | - if($user_id_field_name != "chamilo_user_id") { |
|
227 | - $extras_associative[$user_id_field_name] = $user_id_value; |
|
228 | - } |
|
224 | + // Add the original user id field name and value to the extra fields if needed |
|
225 | + $extras_associative = array(); |
|
226 | + if($user_id_field_name != "chamilo_user_id") { |
|
227 | + $extras_associative[$user_id_field_name] = $user_id_value; |
|
228 | + } |
|
229 | 229 | if (!empty($extras)) { |
230 | 230 | foreach($extras as $extra) { |
231 | 231 | $extras_associative[$extra['field_name']] = $extra['field_value']; |
232 | 232 | } |
233 | 233 | } |
234 | - $result = UserManager::create_user($firstname, $lastname, $status, $email, $login, $password, '', $language, $phone, '', PLATFORM_AUTH_SOURCE, $expiration_date, $visibility, 0, $extras_associative, $encrypt_method); |
|
235 | - if (!$result) { |
|
234 | + $result = UserManager::create_user($firstname, $lastname, $status, $email, $login, $password, '', $language, $phone, '', PLATFORM_AUTH_SOURCE, $expiration_date, $visibility, 0, $extras_associative, $encrypt_method); |
|
235 | + if (!$result) { |
|
236 | 236 | |
237 | - return new WSError(104, 'There was an error creating the user'); |
|
237 | + return new WSError(104, 'There was an error creating the user'); |
|
238 | 238 | |
239 | - /*$failure = $api_failureList[0]; |
|
239 | + /*$failure = $api_failureList[0]; |
|
240 | 240 | if($failure == 'login-pass already taken') { |
241 | 241 | return new WSError(102, 'This username is already taken'); |
242 | 242 | } else if($failure == 'encrypt_method invalid') { |
@@ -244,227 +244,227 @@ discard block |
||
244 | 244 | } else { |
245 | 245 | return new WSError(104, 'There was an error creating the user'); |
246 | 246 | }*/ |
247 | - } else { |
|
248 | - return $result; |
|
249 | - } |
|
250 | - } |
|
247 | + } else { |
|
248 | + return $result; |
|
249 | + } |
|
250 | + } |
|
251 | 251 | |
252 | - /** |
|
253 | - * Creates a user |
|
254 | - * |
|
255 | - * @param string API secret key |
|
256 | - * @param string User first name |
|
257 | - * @param string User last name |
|
258 | - * @param int User status |
|
259 | - * @param string Login name |
|
260 | - * @param string Password (encrypted or not) |
|
261 | - * @param string Encrypt method. Leave blank if you are passing the password in clear text, set to the encrypt method used to encrypt the password otherwise. Remember |
|
262 | - * to include the salt in the extra fields if you are encrypting the password |
|
263 | - * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
264 | - * @param string User id value. Leave blank if you are using the internal user_id |
|
265 | - * @param int Visibility. Set by default to 1 |
|
266 | - * @param string User email. Set by default to an empty string |
|
267 | - * @param string Language. Set by default to english |
|
268 | - * @param string Phone. Set by default to an empty string |
|
269 | - * @param string Expiration date. Set to null by default |
|
270 | - * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Set to an empty array by default |
|
271 | - * @return int New user id generated by the system |
|
272 | - */ |
|
273 | - public function CreateUser($secret_key, $firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility = 1, $email = '', $language = 'english', $phone = '', $expiration_date = '0000-00-00 00:00:00', $extras = array()) { |
|
274 | - // First, verify the secret key |
|
275 | - $verifKey = $this->verifyKey($secret_key); |
|
276 | - if($verifKey instanceof WSError) { |
|
277 | - $this->handleError($verifKey); |
|
278 | - } else { |
|
279 | - $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
|
280 | - if($result instanceof WSError) { |
|
281 | - $this->handleError($result); |
|
282 | - } else { |
|
283 | - return $result; |
|
284 | - } |
|
285 | - } |
|
286 | - } |
|
252 | + /** |
|
253 | + * Creates a user |
|
254 | + * |
|
255 | + * @param string API secret key |
|
256 | + * @param string User first name |
|
257 | + * @param string User last name |
|
258 | + * @param int User status |
|
259 | + * @param string Login name |
|
260 | + * @param string Password (encrypted or not) |
|
261 | + * @param string Encrypt method. Leave blank if you are passing the password in clear text, set to the encrypt method used to encrypt the password otherwise. Remember |
|
262 | + * to include the salt in the extra fields if you are encrypting the password |
|
263 | + * @param string User id field name. Use "chamilo_user_id" as the field name if you want to use the internal user_id |
|
264 | + * @param string User id value. Leave blank if you are using the internal user_id |
|
265 | + * @param int Visibility. Set by default to 1 |
|
266 | + * @param string User email. Set by default to an empty string |
|
267 | + * @param string Language. Set by default to english |
|
268 | + * @param string Phone. Set by default to an empty string |
|
269 | + * @param string Expiration date. Set to null by default |
|
270 | + * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Set to an empty array by default |
|
271 | + * @return int New user id generated by the system |
|
272 | + */ |
|
273 | + public function CreateUser($secret_key, $firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility = 1, $email = '', $language = 'english', $phone = '', $expiration_date = '0000-00-00 00:00:00', $extras = array()) { |
|
274 | + // First, verify the secret key |
|
275 | + $verifKey = $this->verifyKey($secret_key); |
|
276 | + if($verifKey instanceof WSError) { |
|
277 | + $this->handleError($verifKey); |
|
278 | + } else { |
|
279 | + $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
|
280 | + if($result instanceof WSError) { |
|
281 | + $this->handleError($result); |
|
282 | + } else { |
|
283 | + return $result; |
|
284 | + } |
|
285 | + } |
|
286 | + } |
|
287 | 287 | |
288 | - /** |
|
289 | - * Creates multiple users |
|
290 | - * |
|
291 | - * @param string API secret key |
|
292 | - * @param array Users array. Each member of this array must follow the structure imposed by the CreateUser method |
|
293 | - * @return array Array with elements of the form array('user_id_value' => 'original value sent', 'user_id_generated' => 'value_generated', 'result' => array('code' => 0, 'message' => 'Operation was successful')) |
|
294 | - */ |
|
295 | - public function CreateUsers($secret_key, $users) { |
|
296 | - $verifKey = $this->verifyKey($secret_key); |
|
297 | - if($verifKey instanceof WSError) { |
|
298 | - $this->handleError($verifKey); |
|
299 | - } else { |
|
300 | - $results = array(); |
|
301 | - foreach($users as $user) { |
|
302 | - $result_tmp = array(); |
|
288 | + /** |
|
289 | + * Creates multiple users |
|
290 | + * |
|
291 | + * @param string API secret key |
|
292 | + * @param array Users array. Each member of this array must follow the structure imposed by the CreateUser method |
|
293 | + * @return array Array with elements of the form array('user_id_value' => 'original value sent', 'user_id_generated' => 'value_generated', 'result' => array('code' => 0, 'message' => 'Operation was successful')) |
|
294 | + */ |
|
295 | + public function CreateUsers($secret_key, $users) { |
|
296 | + $verifKey = $this->verifyKey($secret_key); |
|
297 | + if($verifKey instanceof WSError) { |
|
298 | + $this->handleError($verifKey); |
|
299 | + } else { |
|
300 | + $results = array(); |
|
301 | + foreach($users as $user) { |
|
302 | + $result_tmp = array(); |
|
303 | 303 | // re-initialize variables just in case |
304 | 304 | $firstname = $lastname = $status = $login = $password = $encrypt_method = $user_id_field_name = $user_id_value = $visibility = $email = $language = $phone = $expiration_date = $extras = null; |
305 | - extract($user); |
|
306 | - $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
|
307 | - if($result instanceof WSError) { |
|
308 | - $result_tmp['result'] = $result->toArray(); |
|
309 | - $result_tmp['user_id_value'] = $user_id_value; |
|
310 | - $result_tmp['user_id_generated'] = 0; |
|
311 | - } else { |
|
312 | - $result_tmp['result'] = $this->getSuccessfulResult(); |
|
313 | - $result_tmp['user_id_value'] = $user_id_value; |
|
314 | - $result_tmp['user_id_generated'] = $result; |
|
315 | - } |
|
316 | - $results[] = $result_tmp; |
|
317 | - } |
|
318 | - return $results; |
|
319 | - } |
|
320 | - } |
|
305 | + extract($user); |
|
306 | + $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
|
307 | + if($result instanceof WSError) { |
|
308 | + $result_tmp['result'] = $result->toArray(); |
|
309 | + $result_tmp['user_id_value'] = $user_id_value; |
|
310 | + $result_tmp['user_id_generated'] = 0; |
|
311 | + } else { |
|
312 | + $result_tmp['result'] = $this->getSuccessfulResult(); |
|
313 | + $result_tmp['user_id_value'] = $user_id_value; |
|
314 | + $result_tmp['user_id_generated'] = $result; |
|
315 | + } |
|
316 | + $results[] = $result_tmp; |
|
317 | + } |
|
318 | + return $results; |
|
319 | + } |
|
320 | + } |
|
321 | 321 | |
322 | - /** |
|
323 | - * Edits user info (helper method) |
|
324 | - * |
|
325 | - * @param string User id field name. Use "chamilo_user_id" in order to use internal system id |
|
326 | - * @param string User id value |
|
327 | - * @param string First name |
|
328 | - * @param string Last name |
|
329 | - * @param int User status |
|
330 | - * @param string Login name |
|
331 | - * @param string Password. Leave blank if you don't want to update it |
|
332 | - * @param string Encrypt method |
|
333 | - * @param string User email |
|
334 | - * @param string Language. Set by default to english |
|
335 | - * @param string Phone. Set by default to an empty string |
|
336 | - * @param string Expiration date. Set to null by default |
|
337 | - * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Leave empty if you don't want to update |
|
338 | - * @return mixed True if user was successfully updated, WSError otherwise |
|
339 | - */ |
|
340 | - protected function editUserHelper( |
|
341 | - $user_id_field_name, |
|
342 | - $user_id_value, |
|
343 | - $firstname, |
|
344 | - $lastname, |
|
345 | - $status, |
|
346 | - $loginname, |
|
347 | - $password, |
|
348 | - $encrypt_method, |
|
349 | - $email, |
|
350 | - $language, |
|
351 | - $phone, |
|
352 | - $expiration_date, |
|
353 | - $extras |
|
354 | - ) { |
|
355 | - $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
356 | - if($user_id instanceof WSError) { |
|
357 | - return $user_id; |
|
358 | - } else { |
|
359 | - if($password == '') { |
|
360 | - $password = null; |
|
361 | - } |
|
362 | - $user_info = api_get_user_info($user_id); |
|
363 | - if (count($extras) == 0) { |
|
364 | - $extras = null; |
|
365 | - } |
|
322 | + /** |
|
323 | + * Edits user info (helper method) |
|
324 | + * |
|
325 | + * @param string User id field name. Use "chamilo_user_id" in order to use internal system id |
|
326 | + * @param string User id value |
|
327 | + * @param string First name |
|
328 | + * @param string Last name |
|
329 | + * @param int User status |
|
330 | + * @param string Login name |
|
331 | + * @param string Password. Leave blank if you don't want to update it |
|
332 | + * @param string Encrypt method |
|
333 | + * @param string User email |
|
334 | + * @param string Language. Set by default to english |
|
335 | + * @param string Phone. Set by default to an empty string |
|
336 | + * @param string Expiration date. Set to null by default |
|
337 | + * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Leave empty if you don't want to update |
|
338 | + * @return mixed True if user was successfully updated, WSError otherwise |
|
339 | + */ |
|
340 | + protected function editUserHelper( |
|
341 | + $user_id_field_name, |
|
342 | + $user_id_value, |
|
343 | + $firstname, |
|
344 | + $lastname, |
|
345 | + $status, |
|
346 | + $loginname, |
|
347 | + $password, |
|
348 | + $encrypt_method, |
|
349 | + $email, |
|
350 | + $language, |
|
351 | + $phone, |
|
352 | + $expiration_date, |
|
353 | + $extras |
|
354 | + ) { |
|
355 | + $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
|
356 | + if($user_id instanceof WSError) { |
|
357 | + return $user_id; |
|
358 | + } else { |
|
359 | + if($password == '') { |
|
360 | + $password = null; |
|
361 | + } |
|
362 | + $user_info = api_get_user_info($user_id); |
|
363 | + if (count($extras) == 0) { |
|
364 | + $extras = null; |
|
365 | + } |
|
366 | 366 | |
367 | - $result = UserManager::update_user( |
|
368 | - $user_id, |
|
369 | - $firstname, |
|
370 | - $lastname, |
|
371 | - $loginname, |
|
372 | - $password, |
|
373 | - PLATFORM_AUTH_SOURCE, |
|
374 | - $email, |
|
375 | - $status, |
|
376 | - '', |
|
377 | - $phone, |
|
378 | - $user_info['picture_uri'], |
|
379 | - $expiration_date, |
|
380 | - $user_info['active'], |
|
381 | - null, |
|
382 | - $user_info['hr_dept_id'], |
|
383 | - $extras, |
|
384 | - $encrypt_method |
|
385 | - ); |
|
386 | - if (!$result) { |
|
387 | - /*if($failure == 'encrypt_method invalid') { |
|
367 | + $result = UserManager::update_user( |
|
368 | + $user_id, |
|
369 | + $firstname, |
|
370 | + $lastname, |
|
371 | + $loginname, |
|
372 | + $password, |
|
373 | + PLATFORM_AUTH_SOURCE, |
|
374 | + $email, |
|
375 | + $status, |
|
376 | + '', |
|
377 | + $phone, |
|
378 | + $user_info['picture_uri'], |
|
379 | + $expiration_date, |
|
380 | + $user_info['active'], |
|
381 | + null, |
|
382 | + $user_info['hr_dept_id'], |
|
383 | + $extras, |
|
384 | + $encrypt_method |
|
385 | + ); |
|
386 | + if (!$result) { |
|
387 | + /*if($failure == 'encrypt_method invalid') { |
|
388 | 388 | return new WSError(103, 'The encryption of the password is invalid'); |
389 | 389 | } else { |
390 | 390 | return new WSError(105, 'There was an error updating the user'); |
391 | 391 | }*/ |
392 | - return new WSError(105, 'There was an error updating the user'); |
|
393 | - } else { |
|
394 | - return $result; |
|
395 | - } |
|
396 | - } |
|
397 | - } |
|
392 | + return new WSError(105, 'There was an error updating the user'); |
|
393 | + } else { |
|
394 | + return $result; |
|
395 | + } |
|
396 | + } |
|
397 | + } |
|
398 | 398 | |
399 | - /** |
|
400 | - * Edits user info |
|
401 | - * |
|
402 | - * @param string API secret key |
|
403 | - * @param string User id field name. Use "chamilo_user_id" in order to use internal system id |
|
404 | - * @param string User id value |
|
405 | - * @param string First name |
|
406 | - * @param string Last name |
|
407 | - * @param int User status |
|
408 | - * @param string Login name |
|
409 | - * @param string Password. Leave blank if you don't want to update it |
|
410 | - * @param string Encrypt method |
|
411 | - * @param string User email |
|
412 | - * @param string Language. Set by default to english |
|
413 | - * @param string Phone. Set by default to an empty string |
|
414 | - * @param string Expiration date. Set to null by default |
|
415 | - * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Leave empty if you don't want to update |
|
416 | - */ |
|
417 | - public function EditUser($secret_key, $user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras) { |
|
418 | - // First, verify the secret key |
|
419 | - $verifKey = $this->verifyKey($secret_key); |
|
420 | - if($verifKey instanceof WSError) { |
|
421 | - $this->handleError($verifKey); |
|
422 | - } else { |
|
399 | + /** |
|
400 | + * Edits user info |
|
401 | + * |
|
402 | + * @param string API secret key |
|
403 | + * @param string User id field name. Use "chamilo_user_id" in order to use internal system id |
|
404 | + * @param string User id value |
|
405 | + * @param string First name |
|
406 | + * @param string Last name |
|
407 | + * @param int User status |
|
408 | + * @param string Login name |
|
409 | + * @param string Password. Leave blank if you don't want to update it |
|
410 | + * @param string Encrypt method |
|
411 | + * @param string User email |
|
412 | + * @param string Language. Set by default to english |
|
413 | + * @param string Phone. Set by default to an empty string |
|
414 | + * @param string Expiration date. Set to null by default |
|
415 | + * @param array Extra fields. An array with elements of the form ('field_name' => 'name_of_the_field', 'field_value' => 'value_of_the_field'). Leave empty if you don't want to update |
|
416 | + */ |
|
417 | + public function EditUser($secret_key, $user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras) { |
|
418 | + // First, verify the secret key |
|
419 | + $verifKey = $this->verifyKey($secret_key); |
|
420 | + if($verifKey instanceof WSError) { |
|
421 | + $this->handleError($verifKey); |
|
422 | + } else { |
|
423 | 423 | |
424 | - $extras_associative = array(); |
|
425 | - if (!empty($extras)) { |
|
426 | - foreach($extras as $extra) { |
|
427 | - $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
428 | - } |
|
429 | - } |
|
424 | + $extras_associative = array(); |
|
425 | + if (!empty($extras)) { |
|
426 | + foreach($extras as $extra) { |
|
427 | + $extras_associative[$extra['field_name']] = $extra['field_value']; |
|
428 | + } |
|
429 | + } |
|
430 | 430 | |
431 | - $result = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras_associative); |
|
432 | - if($result instanceof WSError) { |
|
433 | - $this->handleError($result); |
|
434 | - } |
|
435 | - } |
|
436 | - } |
|
431 | + $result = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras_associative); |
|
432 | + if($result instanceof WSError) { |
|
433 | + $this->handleError($result); |
|
434 | + } |
|
435 | + } |
|
436 | + } |
|
437 | 437 | |
438 | - /** |
|
439 | - * Edits multiple users |
|
440 | - * |
|
441 | - * @param string API secret key |
|
442 | - * @param array Users array. Each member of this array must follow the structure imposed by the EditUser method |
|
443 | - * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
444 | - * than 0, an error occured |
|
445 | - */ |
|
446 | - public function EditUsers($secret_key, $users) { |
|
447 | - $verifKey = $this->verifyKey($secret_key); |
|
448 | - if($verifKey instanceof WSError) { |
|
449 | - $this->handleError($verifKey); |
|
450 | - } else { |
|
451 | - $results = array(); |
|
452 | - foreach($users as $user) { |
|
453 | - $result_tmp = array(); |
|
438 | + /** |
|
439 | + * Edits multiple users |
|
440 | + * |
|
441 | + * @param string API secret key |
|
442 | + * @param array Users array. Each member of this array must follow the structure imposed by the EditUser method |
|
443 | + * @return array Array with elements like array('user_id_value' => 'value', 'result' => array('code' => 0, 'message' => 'Operation was successful')). Note that if the result array contains a code different |
|
444 | + * than 0, an error occured |
|
445 | + */ |
|
446 | + public function EditUsers($secret_key, $users) { |
|
447 | + $verifKey = $this->verifyKey($secret_key); |
|
448 | + if($verifKey instanceof WSError) { |
|
449 | + $this->handleError($verifKey); |
|
450 | + } else { |
|
451 | + $results = array(); |
|
452 | + foreach($users as $user) { |
|
453 | + $result_tmp = array(); |
|
454 | 454 | // re-initialize variables just in case |
455 | 455 | $user_id_field_name = $user_id_value = $firstname = $lastname = $status = $loginname = $password = $encrypt_method = $email = $language = $phone = $expiration_date = $extras = null; |
456 | - extract($user); |
|
457 | - $result_op = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras); |
|
458 | - $result_tmp['user_id_value'] = $user['user_id_value']; |
|
459 | - if($result_op instanceof WSError) { |
|
460 | - // Return the error in the results |
|
461 | - $result_tmp['result'] = $result_op->toArray(); |
|
462 | - } else { |
|
463 | - $result_tmp['result'] = $this->getSuccessfulResult(); |
|
464 | - } |
|
465 | - $results[] = $result_tmp; |
|
466 | - } |
|
467 | - return $results; |
|
468 | - } |
|
469 | - } |
|
456 | + extract($user); |
|
457 | + $result_op = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras); |
|
458 | + $result_tmp['user_id_value'] = $user['user_id_value']; |
|
459 | + if($result_op instanceof WSError) { |
|
460 | + // Return the error in the results |
|
461 | + $result_tmp['result'] = $result_op->toArray(); |
|
462 | + } else { |
|
463 | + $result_tmp['result'] = $this->getSuccessfulResult(); |
|
464 | + } |
|
465 | + $results[] = $result_tmp; |
|
466 | + } |
|
467 | + return $results; |
|
468 | + } |
|
469 | + } |
|
470 | 470 | } |
@@ -20,12 +20,12 @@ discard block |
||
20 | 20 | */ |
21 | 21 | protected function changeUserActiveState($user_id_field_name, $user_id_value, $state) { |
22 | 22 | $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
23 | - if($user_id instanceof WSError) { |
|
23 | + if ($user_id instanceof WSError) { |
|
24 | 24 | return $user_id; |
25 | 25 | } else { |
26 | - if($state == 0) { |
|
26 | + if ($state == 0) { |
|
27 | 27 | UserManager::disable($user_id); |
28 | - } else if($state == 1) { |
|
28 | + } else if ($state == 1) { |
|
29 | 29 | UserManager::enable($user_id); |
30 | 30 | } |
31 | 31 | } |
@@ -40,11 +40,11 @@ discard block |
||
40 | 40 | */ |
41 | 41 | protected function changeUsersActiveState($users, $state) { |
42 | 42 | $results = array(); |
43 | - foreach($users as $user) { |
|
43 | + foreach ($users as $user) { |
|
44 | 44 | $result_tmp = array(); |
45 | 45 | $result_op = $this->changeUserActiveState($user['user_id_field_name'], $user['user_id_value'], $state); |
46 | 46 | $result_tmp['user_id_value'] = $user['user_id_value']; |
47 | - if($result_op instanceof WSError) { |
|
47 | + if ($result_op instanceof WSError) { |
|
48 | 48 | // Return the error in the results |
49 | 49 | $result_tmp['result'] = $result_op->toArray(); |
50 | 50 | } else { |
@@ -64,12 +64,12 @@ discard block |
||
64 | 64 | */ |
65 | 65 | public function DisableUser($secret_key, $user_id_field_name, $user_id_value) { |
66 | 66 | $verifKey = $this->verifyKey($secret_key); |
67 | - if($verifKey instanceof WSError) { |
|
67 | + if ($verifKey instanceof WSError) { |
|
68 | 68 | // Let the implementation handle it |
69 | 69 | $this->handleError($verifKey); |
70 | 70 | } else { |
71 | 71 | $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 0); |
72 | - if($result instanceof WSError) { |
|
72 | + if ($result instanceof WSError) { |
|
73 | 73 | $this->handleError($result); |
74 | 74 | } |
75 | 75 | } |
@@ -85,7 +85,7 @@ discard block |
||
85 | 85 | */ |
86 | 86 | public function DisableUsers($secret_key, $users) { |
87 | 87 | $verifKey = $this->verifyKey($secret_key); |
88 | - if($verifKey instanceof WSError) { |
|
88 | + if ($verifKey instanceof WSError) { |
|
89 | 89 | // Let the implementation handle it |
90 | 90 | $this->handleError($verifKey); |
91 | 91 | } else { |
@@ -102,11 +102,11 @@ discard block |
||
102 | 102 | */ |
103 | 103 | public function EnableUser($secret_key, $user_id_field_name, $user_id_value) { |
104 | 104 | $verifKey = $this->verifyKey($secret_key); |
105 | - if($verifKey instanceof WSError) { |
|
105 | + if ($verifKey instanceof WSError) { |
|
106 | 106 | $this->handleError($verifKey); |
107 | 107 | } else { |
108 | 108 | $result = $this->changeUserActiveState($user_id_field_name, $user_id_value, 1); |
109 | - if($result instanceof WSError) { |
|
109 | + if ($result instanceof WSError) { |
|
110 | 110 | $this->handleError($result); |
111 | 111 | } |
112 | 112 | } |
@@ -122,7 +122,7 @@ discard block |
||
122 | 122 | */ |
123 | 123 | public function EnableUsers($secret_key, $users) { |
124 | 124 | $verifKey = $this->verifyKey($secret_key); |
125 | - if($verifKey instanceof WSError) { |
|
125 | + if ($verifKey instanceof WSError) { |
|
126 | 126 | // Let the implementation handle it |
127 | 127 | $this->handleError($verifKey); |
128 | 128 | } else { |
@@ -139,10 +139,10 @@ discard block |
||
139 | 139 | */ |
140 | 140 | protected function deleteUserHelper($user_id_field_name, $user_id_value) { |
141 | 141 | $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
142 | - if($user_id instanceof WSError) { |
|
142 | + if ($user_id instanceof WSError) { |
|
143 | 143 | return $user_id; |
144 | 144 | } else { |
145 | - if(!UserManager::delete_user($user_id)) { |
|
145 | + if (!UserManager::delete_user($user_id)) { |
|
146 | 146 | return new WSError(101, "There was a problem while deleting this user"); |
147 | 147 | } else { |
148 | 148 | return true; |
@@ -159,11 +159,11 @@ discard block |
||
159 | 159 | */ |
160 | 160 | public function DeleteUser($secret_key, $user_id_field_name, $user_id_value) { |
161 | 161 | $verifKey = $this->verifyKey($secret_key); |
162 | - if($verifKey instanceof WSError) { |
|
162 | + if ($verifKey instanceof WSError) { |
|
163 | 163 | $this->handleError($verifKey); |
164 | 164 | } else { |
165 | 165 | $result = $this->deleteUserHelper($user_id_field_name, $user_id_value); |
166 | - if($result instanceof WSError) { |
|
166 | + if ($result instanceof WSError) { |
|
167 | 167 | $this->handleError($result); |
168 | 168 | } |
169 | 169 | } |
@@ -179,15 +179,15 @@ discard block |
||
179 | 179 | */ |
180 | 180 | public function DeleteUsers($secret_key, $users) { |
181 | 181 | $verifKey = $this->verifyKey($secret_key); |
182 | - if($verifKey instanceof WSError) { |
|
182 | + if ($verifKey instanceof WSError) { |
|
183 | 183 | $this->handleError($verifKey); |
184 | 184 | } else { |
185 | 185 | $results = array(); |
186 | - foreach($users as $user) { |
|
186 | + foreach ($users as $user) { |
|
187 | 187 | $result_tmp = array(); |
188 | 188 | $result_op = $this->deleteUserHelper($user['user_id_field_name'], $user['user_id_value']); |
189 | 189 | $result_tmp['user_id_value'] = $user['user_id_value']; |
190 | - if($result_op instanceof WSError) { |
|
190 | + if ($result_op instanceof WSError) { |
|
191 | 191 | // Return the error in the results |
192 | 192 | $result_tmp['result'] = $result_op->toArray(); |
193 | 193 | } else { |
@@ -223,11 +223,11 @@ discard block |
||
223 | 223 | |
224 | 224 | // Add the original user id field name and value to the extra fields if needed |
225 | 225 | $extras_associative = array(); |
226 | - if($user_id_field_name != "chamilo_user_id") { |
|
226 | + if ($user_id_field_name != "chamilo_user_id") { |
|
227 | 227 | $extras_associative[$user_id_field_name] = $user_id_value; |
228 | 228 | } |
229 | 229 | if (!empty($extras)) { |
230 | - foreach($extras as $extra) { |
|
230 | + foreach ($extras as $extra) { |
|
231 | 231 | $extras_associative[$extra['field_name']] = $extra['field_value']; |
232 | 232 | } |
233 | 233 | } |
@@ -273,11 +273,11 @@ discard block |
||
273 | 273 | public function CreateUser($secret_key, $firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility = 1, $email = '', $language = 'english', $phone = '', $expiration_date = '0000-00-00 00:00:00', $extras = array()) { |
274 | 274 | // First, verify the secret key |
275 | 275 | $verifKey = $this->verifyKey($secret_key); |
276 | - if($verifKey instanceof WSError) { |
|
276 | + if ($verifKey instanceof WSError) { |
|
277 | 277 | $this->handleError($verifKey); |
278 | 278 | } else { |
279 | 279 | $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
280 | - if($result instanceof WSError) { |
|
280 | + if ($result instanceof WSError) { |
|
281 | 281 | $this->handleError($result); |
282 | 282 | } else { |
283 | 283 | return $result; |
@@ -294,17 +294,17 @@ discard block |
||
294 | 294 | */ |
295 | 295 | public function CreateUsers($secret_key, $users) { |
296 | 296 | $verifKey = $this->verifyKey($secret_key); |
297 | - if($verifKey instanceof WSError) { |
|
297 | + if ($verifKey instanceof WSError) { |
|
298 | 298 | $this->handleError($verifKey); |
299 | 299 | } else { |
300 | 300 | $results = array(); |
301 | - foreach($users as $user) { |
|
301 | + foreach ($users as $user) { |
|
302 | 302 | $result_tmp = array(); |
303 | 303 | // re-initialize variables just in case |
304 | 304 | $firstname = $lastname = $status = $login = $password = $encrypt_method = $user_id_field_name = $user_id_value = $visibility = $email = $language = $phone = $expiration_date = $extras = null; |
305 | 305 | extract($user); |
306 | 306 | $result = $this->createUserHelper($firstname, $lastname, $status, $login, $password, $encrypt_method, $user_id_field_name, $user_id_value, $visibility, $email, $language, $phone, $expiration_date, $extras); |
307 | - if($result instanceof WSError) { |
|
307 | + if ($result instanceof WSError) { |
|
308 | 308 | $result_tmp['result'] = $result->toArray(); |
309 | 309 | $result_tmp['user_id_value'] = $user_id_value; |
310 | 310 | $result_tmp['user_id_generated'] = 0; |
@@ -353,10 +353,10 @@ discard block |
||
353 | 353 | $extras |
354 | 354 | ) { |
355 | 355 | $user_id = $this->getUserId($user_id_field_name, $user_id_value); |
356 | - if($user_id instanceof WSError) { |
|
356 | + if ($user_id instanceof WSError) { |
|
357 | 357 | return $user_id; |
358 | 358 | } else { |
359 | - if($password == '') { |
|
359 | + if ($password == '') { |
|
360 | 360 | $password = null; |
361 | 361 | } |
362 | 362 | $user_info = api_get_user_info($user_id); |
@@ -417,19 +417,19 @@ discard block |
||
417 | 417 | public function EditUser($secret_key, $user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras) { |
418 | 418 | // First, verify the secret key |
419 | 419 | $verifKey = $this->verifyKey($secret_key); |
420 | - if($verifKey instanceof WSError) { |
|
420 | + if ($verifKey instanceof WSError) { |
|
421 | 421 | $this->handleError($verifKey); |
422 | 422 | } else { |
423 | 423 | |
424 | 424 | $extras_associative = array(); |
425 | 425 | if (!empty($extras)) { |
426 | - foreach($extras as $extra) { |
|
426 | + foreach ($extras as $extra) { |
|
427 | 427 | $extras_associative[$extra['field_name']] = $extra['field_value']; |
428 | 428 | } |
429 | 429 | } |
430 | 430 | |
431 | 431 | $result = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras_associative); |
432 | - if($result instanceof WSError) { |
|
432 | + if ($result instanceof WSError) { |
|
433 | 433 | $this->handleError($result); |
434 | 434 | } |
435 | 435 | } |
@@ -445,18 +445,18 @@ discard block |
||
445 | 445 | */ |
446 | 446 | public function EditUsers($secret_key, $users) { |
447 | 447 | $verifKey = $this->verifyKey($secret_key); |
448 | - if($verifKey instanceof WSError) { |
|
448 | + if ($verifKey instanceof WSError) { |
|
449 | 449 | $this->handleError($verifKey); |
450 | 450 | } else { |
451 | 451 | $results = array(); |
452 | - foreach($users as $user) { |
|
452 | + foreach ($users as $user) { |
|
453 | 453 | $result_tmp = array(); |
454 | 454 | // re-initialize variables just in case |
455 | 455 | $user_id_field_name = $user_id_value = $firstname = $lastname = $status = $loginname = $password = $encrypt_method = $email = $language = $phone = $expiration_date = $extras = null; |
456 | 456 | extract($user); |
457 | 457 | $result_op = $this->editUserHelper($user_id_field_name, $user_id_value, $firstname, $lastname, $status, $loginname, $password, $encrypt_method, $email, $language, $phone, $expiration_date, $extras); |
458 | 458 | $result_tmp['user_id_value'] = $user['user_id_value']; |
459 | - if($result_op instanceof WSError) { |
|
459 | + if ($result_op instanceof WSError) { |
|
460 | 460 | // Return the error in the results |
461 | 461 | $result_tmp['result'] = $result_op->toArray(); |
462 | 462 | } else { |
@@ -212,7 +212,7 @@ |
||
212 | 212 | * @param array $arr1 first array |
213 | 213 | * @param array $arr2 second array |
214 | 214 | * |
215 | - * @return array difference between the two arrays |
|
215 | + * @return string difference between the two arrays |
|
216 | 216 | */ |
217 | 217 | function diff($arr1, $arr2) |
218 | 218 | { |
@@ -9,7 +9,7 @@ discard block |
||
9 | 9 | |
10 | 10 | $work_id = $_GET['id']; |
11 | 11 | require_once '../inc/global.inc.php'; |
12 | -$current_course_tool = TOOL_STUDENTPUBLICATION; |
|
12 | +$current_course_tool = TOOL_STUDENTPUBLICATION; |
|
13 | 13 | $_course = api_get_course_info(); |
14 | 14 | |
15 | 15 | // Protection |
@@ -178,10 +178,10 @@ discard block |
||
178 | 178 | if (!empty($files)) { |
179 | 179 | $fileName = api_replace_dangerous_char($work_data['title']); |
180 | 180 | // Logging |
181 | - Event::event_download($fileName .'.zip (folder)'); |
|
181 | + Event::event_download($fileName.'.zip (folder)'); |
|
182 | 182 | |
183 | 183 | //start download of created file |
184 | - $name = $fileName .'.zip'; |
|
184 | + $name = $fileName.'.zip'; |
|
185 | 185 | if (Security::check_abs_path($temp_zip_file, api_get_path(SYS_ARCHIVE_PATH))) { |
186 | 186 | DocumentManager::file_send_for_download($temp_zip_file, true, $name); |
187 | 187 | @unlink($temp_zip_file); |
@@ -370,7 +370,7 @@ discard block |
||
370 | 370 | * Register a user into a queue for a session |
371 | 371 | * @param $userId |
372 | 372 | * @param $sessionId |
373 | - * @return bool|int |
|
373 | + * @return false|string |
|
374 | 374 | */ |
375 | 375 | public function addToQueue($userId, $sessionId) |
376 | 376 | { |
@@ -396,7 +396,7 @@ discard block |
||
396 | 396 | * Register message with type and status |
397 | 397 | * @param $mailId |
398 | 398 | * @param $userId |
399 | - * @param $sessionId |
|
399 | + * @param integer $sessionId |
|
400 | 400 | * @return bool|int |
401 | 401 | */ |
402 | 402 | public function saveLastMessage($mailId, $userId, $sessionId) |
@@ -509,7 +509,7 @@ discard block |
||
509 | 509 | |
510 | 510 | /** |
511 | 511 | * Check if session is open for subscription |
512 | - * @param $sessionId |
|
512 | + * @param integer $sessionId |
|
513 | 513 | * @param string $fieldVariable |
514 | 514 | * @return bool |
515 | 515 | */ |
@@ -531,8 +531,8 @@ discard block |
||
531 | 531 | |
532 | 532 | /** |
533 | 533 | * Check if user is in the session's target group based on its area |
534 | - * @param $userId |
|
535 | - * @param $sessionId |
|
534 | + * @param integer $userId |
|
535 | + * @param integer $sessionId |
|
536 | 536 | * @param string $userFieldVariable |
537 | 537 | * @param string $sessionFieldVariable |
538 | 538 | * @return bool |
@@ -1002,7 +1002,7 @@ discard block |
||
1002 | 1002 | /** |
1003 | 1003 | * Return the session details data from a session ID (including the extra |
1004 | 1004 | * fields used for the advanced subscription mechanism) |
1005 | - * @param $sessionId |
|
1005 | + * @param integer $sessionId |
|
1006 | 1006 | * @return bool|mixed |
1007 | 1007 | */ |
1008 | 1008 | public function getSessionDetails($sessionId) |
@@ -1102,7 +1102,7 @@ discard block |
||
1102 | 1102 | |
1103 | 1103 | /** |
1104 | 1104 | * Return the url to go to session |
1105 | - * @param $sessionId |
|
1105 | + * @param integer $sessionId |
|
1106 | 1106 | * |
1107 | 1107 | * @return string |
1108 | 1108 | */ |
@@ -1069,7 +1069,7 @@ |
||
1069 | 1069 | */ |
1070 | 1070 | public function getStatusMessage($status, $isAble = true) |
1071 | 1071 | { |
1072 | - $message = ''; |
|
1072 | + $message = ''; |
|
1073 | 1073 | switch ($status) { |
1074 | 1074 | case ADVANCED_SUBSCRIPTION_QUEUE_STATUS_NO_QUEUE: |
1075 | 1075 | if ($isAble) { |
@@ -106,15 +106,15 @@ discard block |
||
106 | 106 | { |
107 | 107 | $advancedSubscriptionQueueTable = Database::get_main_table(TABLE_ADVANCED_SUBSCRIPTION_QUEUE); |
108 | 108 | |
109 | - $sql = "CREATE TABLE IF NOT EXISTS $advancedSubscriptionQueueTable (" . |
|
110 | - "id int UNSIGNED NOT NULL AUTO_INCREMENT, " . |
|
111 | - "session_id int UNSIGNED NOT NULL, " . |
|
112 | - "user_id int UNSIGNED NOT NULL, " . |
|
113 | - "status int UNSIGNED NOT NULL, " . |
|
114 | - "last_message_id int UNSIGNED NOT NULL, " . |
|
115 | - "created_at datetime NOT NULL, " . |
|
116 | - "updated_at datetime NULL, " . |
|
117 | - "PRIMARY KEY PK_advanced_subscription_queue (id), " . |
|
109 | + $sql = "CREATE TABLE IF NOT EXISTS $advancedSubscriptionQueueTable (". |
|
110 | + "id int UNSIGNED NOT NULL AUTO_INCREMENT, ". |
|
111 | + "session_id int UNSIGNED NOT NULL, ". |
|
112 | + "user_id int UNSIGNED NOT NULL, ". |
|
113 | + "status int UNSIGNED NOT NULL, ". |
|
114 | + "last_message_id int UNSIGNED NOT NULL, ". |
|
115 | + "created_at datetime NOT NULL, ". |
|
116 | + "updated_at datetime NULL, ". |
|
117 | + "PRIMARY KEY PK_advanced_subscription_queue (id), ". |
|
118 | 118 | "UNIQUE KEY UK_advanced_subscription_queue (user_id, session_id)); "; |
119 | 119 | Database::query($sql); |
120 | 120 | } |
@@ -265,11 +265,10 @@ discard block |
||
265 | 265 | $now = new DateTime(api_get_utc_datetime()); |
266 | 266 | $newYearDate = $plugin->get('course_session_credit_year_start_date'); |
267 | 267 | $newYearDate = !empty($newYearDate) ? |
268 | - new \DateTime($newYearDate . $now->format('/Y')) : |
|
269 | - $now; |
|
268 | + new \DateTime($newYearDate.$now->format('/Y')) : $now; |
|
270 | 269 | $extra = new ExtraFieldValue('session'); |
271 | - $joinSessionTable = Database::get_main_table(TABLE_MAIN_SESSION_USER) . ' su INNER JOIN ' . |
|
272 | - Database::get_main_table(TABLE_MAIN_SESSION) . ' s ON s.id = su.session_id'; |
|
270 | + $joinSessionTable = Database::get_main_table(TABLE_MAIN_SESSION_USER).' su INNER JOIN '. |
|
271 | + Database::get_main_table(TABLE_MAIN_SESSION).' s ON s.id = su.session_id'; |
|
273 | 272 | $whereSessionParams = 'su.relation_type = ? AND s.access_start_date >= ? AND su.user_id = ?'; |
274 | 273 | $whereSessionParamsValues = array( |
275 | 274 | 0, |
@@ -734,14 +733,14 @@ discard block |
||
734 | 733 | $tpl->assign('termsContent', $termsAndConditions); |
735 | 734 | $termsAndConditions = $tpl->fetch('/advanced_subscription/views/terms_and_conditions_to_pdf.tpl'); |
736 | 735 | $pdf = new PDF(); |
737 | - $filename = 'terms' . sha1(rand(0,99999)); |
|
736 | + $filename = 'terms'.sha1(rand(0, 99999)); |
|
738 | 737 | $pdf->content_to_pdf($termsAndConditions, null, $filename, null, 'F'); |
739 | 738 | $fileAttachments['file'][] = array( |
740 | - 'name' => $filename . '.pdf', |
|
741 | - 'application/pdf' => $filename . '.pdf', |
|
742 | - 'tmp_name' => api_get_path(SYS_ARCHIVE_PATH) . $filename . '.pdf', |
|
739 | + 'name' => $filename.'.pdf', |
|
740 | + 'application/pdf' => $filename.'.pdf', |
|
741 | + 'tmp_name' => api_get_path(SYS_ARCHIVE_PATH).$filename.'.pdf', |
|
743 | 742 | 'error' => UPLOAD_ERR_OK, |
744 | - 'size' => filesize(api_get_path(SYS_ARCHIVE_PATH) . $filename . '.pdf'), |
|
743 | + 'size' => filesize(api_get_path(SYS_ARCHIVE_PATH).$filename.'.pdf'), |
|
745 | 744 | ); |
746 | 745 | $fileAttachments['comments'][] = get_lang('TermsAndConditions'); |
747 | 746 | } |
@@ -1032,7 +1031,7 @@ discard block |
||
1032 | 1031 | |
1033 | 1032 | $mergedArray = array_merge(array($sessionId), array_keys($fields)); |
1034 | 1033 | |
1035 | - $sql = "SELECT * FROM " . Database::get_main_table(TABLE_EXTRA_FIELD_VALUES) ." |
|
1034 | + $sql = "SELECT * FROM ".Database::get_main_table(TABLE_EXTRA_FIELD_VALUES)." |
|
1036 | 1035 | WHERE item_id = %d AND field_id IN (%d, %d, %d, %d, %d, %d, %d)"; |
1037 | 1036 | $sql = vsprintf($sql, $mergedArray); |
1038 | 1037 | $sessionFieldValueList = Database::query($sql); |
@@ -1048,10 +1047,10 @@ discard block |
||
1048 | 1047 | $sessionArray['description'] = SessionManager::getDescriptionFromSessionId($sessionId); |
1049 | 1048 | |
1050 | 1049 | if (isset($sessionArray['brochure'])) { |
1051 | - $sessionArray['brochure'] = api_get_path(WEB_UPLOAD_PATH) . $sessionArray['brochure']; |
|
1050 | + $sessionArray['brochure'] = api_get_path(WEB_UPLOAD_PATH).$sessionArray['brochure']; |
|
1052 | 1051 | } |
1053 | 1052 | if (isset($sessionArray['banner'])) { |
1054 | - $sessionArray['banner'] = api_get_path(WEB_UPLOAD_PATH) . $sessionArray['banner']; |
|
1053 | + $sessionArray['banner'] = api_get_path(WEB_UPLOAD_PATH).$sessionArray['banner']; |
|
1055 | 1054 | } |
1056 | 1055 | |
1057 | 1056 | return $sessionArray; |
@@ -1108,7 +1107,7 @@ discard block |
||
1108 | 1107 | */ |
1109 | 1108 | public function getSessionUrl($sessionId) |
1110 | 1109 | { |
1111 | - $url = api_get_path(WEB_CODE_PATH) . 'session/?session_id=' . intval($sessionId); |
|
1110 | + $url = api_get_path(WEB_CODE_PATH).'session/?session_id='.intval($sessionId); |
|
1112 | 1111 | |
1113 | 1112 | return $url; |
1114 | 1113 | } |
@@ -1157,16 +1156,16 @@ discard block |
||
1157 | 1156 | */ |
1158 | 1157 | public function getQueueUrl($params) |
1159 | 1158 | { |
1160 | - $url = api_get_path(WEB_PLUGIN_PATH) . 'advanced_subscription/ajax/advanced_subscription.ajax.php?' . |
|
1161 | - 'a=' . Security::remove_XSS($params['action']) . '&' . |
|
1162 | - 's=' . intval($params['sessionId']) . '&' . |
|
1163 | - 'current_user_id=' . intval($params['currentUserId']) . '&' . |
|
1164 | - 'e=' . intval($params['newStatus']) . '&' . |
|
1165 | - 'u=' . intval($params['studentUserId']) . '&' . |
|
1166 | - 'q=' . intval($params['queueId']) . '&' . |
|
1167 | - 'is_connected=' . 1 . '&' . |
|
1168 | - 'profile_completed=' . intval($params['profile_completed']) . '&' . |
|
1169 | - 'v=' . $this->generateHash($params); |
|
1159 | + $url = api_get_path(WEB_PLUGIN_PATH).'advanced_subscription/ajax/advanced_subscription.ajax.php?'. |
|
1160 | + 'a='.Security::remove_XSS($params['action']).'&'. |
|
1161 | + 's='.intval($params['sessionId']).'&'. |
|
1162 | + 'current_user_id='.intval($params['currentUserId']).'&'. |
|
1163 | + 'e='.intval($params['newStatus']).'&'. |
|
1164 | + 'u='.intval($params['studentUserId']).'&'. |
|
1165 | + 'q='.intval($params['queueId']).'&'. |
|
1166 | + 'is_connected='.1.'&'. |
|
1167 | + 'profile_completed='.intval($params['profile_completed']).'&'. |
|
1168 | + 'v='.$this->generateHash($params); |
|
1170 | 1169 | |
1171 | 1170 | return $url; |
1172 | 1171 | } |
@@ -1219,7 +1218,7 @@ discard block |
||
1219 | 1218 | } |
1220 | 1219 | $queueTable = Database::get_main_table(TABLE_ADVANCED_SUBSCRIPTION_QUEUE); |
1221 | 1220 | $userTable = Database::get_main_table(TABLE_MAIN_USER); |
1222 | - $userJoinTable = $queueTable . ' q INNER JOIN ' . $userTable . ' u ON q.user_id = u.user_id'; |
|
1221 | + $userJoinTable = $queueTable.' q INNER JOIN '.$userTable.' u ON q.user_id = u.user_id'; |
|
1223 | 1222 | $where = array( |
1224 | 1223 | 'where' => array( |
1225 | 1224 | 'q.session_id = ?' => array( |
@@ -1232,7 +1231,7 @@ discard block |
||
1232 | 1231 | $students = Database::select($select, $userJoinTable, $where); |
1233 | 1232 | foreach ($students as &$student) { |
1234 | 1233 | $status = intval($student['status']); |
1235 | - switch($status) { |
|
1234 | + switch ($status) { |
|
1236 | 1235 | case ADVANCED_SUBSCRIPTION_QUEUE_STATUS_NO_QUEUE: |
1237 | 1236 | case ADVANCED_SUBSCRIPTION_QUEUE_STATUS_START: |
1238 | 1237 | $student['validation'] = ''; |
@@ -1246,7 +1245,7 @@ discard block |
||
1246 | 1245 | $student['validation'] = 'Yes'; |
1247 | 1246 | break; |
1248 | 1247 | default: |
1249 | - error_log(__FILE__ . ' ' . __FUNCTION__ . ' Student status no detected'); |
|
1248 | + error_log(__FILE__.' '.__FUNCTION__.' Student status no detected'); |
|
1250 | 1249 | } |
1251 | 1250 | } |
1252 | 1251 | $return = array( |
@@ -1295,7 +1294,7 @@ discard block |
||
1295 | 1294 | $dataPrepared['queueId'] = intval($data['queueId']); |
1296 | 1295 | $dataPrepared['newStatus'] = intval($data['newStatus']); |
1297 | 1296 | $dataPrepared = serialize($dataPrepared); |
1298 | - return sha1($dataPrepared . $key); |
|
1297 | + return sha1($dataPrepared.$key); |
|
1299 | 1298 | } |
1300 | 1299 | |
1301 | 1300 | /** |
@@ -1350,12 +1349,12 @@ discard block |
||
1350 | 1349 | break; |
1351 | 1350 | } |
1352 | 1351 | |
1353 | - $url = api_get_path(WEB_PLUGIN_PATH) . "advanced_subscription/src/terms_and_conditions.php?"; |
|
1352 | + $url = api_get_path(WEB_PLUGIN_PATH)."advanced_subscription/src/terms_and_conditions.php?"; |
|
1354 | 1353 | $url .= http_build_query($urlParams); |
1355 | 1354 | |
1356 | 1355 | // Launch popup |
1357 | 1356 | if ($mode == ADVANCED_SUBSCRIPTION_TERMS_MODE_POPUP) { |
1358 | - $url = 'javascript:void(window.open(\'' . $url .'\',\'AdvancedSubscriptionTerms\', \'toolbar=no,location=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width=700px,height=600px\', \'100\' ))'; |
|
1357 | + $url = 'javascript:void(window.open(\''.$url.'\',\'AdvancedSubscriptionTerms\', \'toolbar=no,location=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width=700px,height=600px\', \'100\' ))'; |
|
1359 | 1358 | } |
1360 | 1359 | return $url; |
1361 | 1360 | } |
@@ -1367,9 +1366,9 @@ discard block |
||
1367 | 1366 | */ |
1368 | 1367 | public function getRenderMailUrl($params) |
1369 | 1368 | { |
1370 | - $url = api_get_path(WEB_PLUGIN_PATH) . 'advanced_subscription/src/render_mail.php?' . |
|
1371 | - 'q=' . $params['queueId'] . '&' . |
|
1372 | - 'v=' . $this->generateHash($params); |
|
1369 | + $url = api_get_path(WEB_PLUGIN_PATH).'advanced_subscription/src/render_mail.php?'. |
|
1370 | + 'q='.$params['queueId'].'&'. |
|
1371 | + 'v='.$this->generateHash($params); |
|
1373 | 1372 | return $url; |
1374 | 1373 | } |
1375 | 1374 | |
@@ -1440,7 +1439,7 @@ discard block |
||
1440 | 1439 | sf.extra_field_type = $extraFieldType AND |
1441 | 1440 | sf.variable = 'is_induction_session' AND |
1442 | 1441 | su.relation_type = 0 AND |
1443 | - su.user_id = " . intval($userId); |
|
1442 | + su.user_id = ".intval($userId); |
|
1444 | 1443 | |
1445 | 1444 | $result = Database::query($sql); |
1446 | 1445 |
@@ -240,7 +240,7 @@ discard block |
||
240 | 240 | /** |
241 | 241 | * Returns a meeting "join" URL |
242 | 242 | * @param string The name of the meeting (usually the course code) |
243 | - * @return mixed The URL to join the meeting, or false on error |
|
243 | + * @return false|string The URL to join the meeting, or false on error |
|
244 | 244 | * @todo implement moderator pass |
245 | 245 | * @assert ('') === false |
246 | 246 | * @assert ('abcdefghijklmnopqrstuvwxyzabcdefghijklmno') === false |
@@ -647,7 +647,7 @@ discard block |
||
647 | 647 | * Closes a meeting (usually when the user click on the close button from |
648 | 648 | * the conferences listing. |
649 | 649 | * @param string The internal ID of the meeting (id field for this meeting) |
650 | - * @return void |
|
650 | + * @return false|null |
|
651 | 651 | * @assert (0) === false |
652 | 652 | */ |
653 | 653 | public function endMeeting($id) |
@@ -210,7 +210,7 @@ discard block |
||
210 | 210 | |
211 | 211 | $params['record'] = api_get_course_setting('big_blue_button_record_and_store', $courseCode) == 1 ? true : false; |
212 | 212 | $max = api_get_course_setting('big_blue_button_max_students_allowed', $courseCode); |
213 | - $max = isset($max) ? $max : -1; |
|
213 | + $max = isset($max) ? $max : -1; |
|
214 | 214 | |
215 | 215 | $params['status'] = 1; |
216 | 216 | // Generate a pseudo-global-unique-id to avoid clash of conferences on |
@@ -243,23 +243,23 @@ discard block |
||
243 | 243 | $duration = 300; |
244 | 244 | |
245 | 245 | $bbbParams = array( |
246 | - 'meetingId' => $params['remote_id'], // REQUIRED |
|
247 | - 'meetingName' => $meetingName, // REQUIRED |
|
248 | - 'attendeePw' => $attendeePassword, // Match this value in getJoinMeetingURL() to join as attendee. |
|
249 | - 'moderatorPw' => $moderatorPassword, // Match this value in getJoinMeetingURL() to join as moderator. |
|
250 | - 'welcomeMsg' => $welcomeMessage, // ''= use default. Change to customize. |
|
251 | - 'dialNumber' => '', // The main number to call into. Optional. |
|
252 | - 'voiceBridge' => $params['voice_bridge'], // PIN to join voice. Required. |
|
253 | - 'webVoice' => '', // Alphanumeric to join voice. Optional. |
|
246 | + 'meetingId' => $params['remote_id'], // REQUIRED |
|
247 | + 'meetingName' => $meetingName, // REQUIRED |
|
248 | + 'attendeePw' => $attendeePassword, // Match this value in getJoinMeetingURL() to join as attendee. |
|
249 | + 'moderatorPw' => $moderatorPassword, // Match this value in getJoinMeetingURL() to join as moderator. |
|
250 | + 'welcomeMsg' => $welcomeMessage, // ''= use default. Change to customize. |
|
251 | + 'dialNumber' => '', // The main number to call into. Optional. |
|
252 | + 'voiceBridge' => $params['voice_bridge'], // PIN to join voice. Required. |
|
253 | + 'webVoice' => '', // Alphanumeric to join voice. Optional. |
|
254 | 254 | 'logoutUrl' => $this->logoutUrl, |
255 | - 'maxParticipants' => $max, // Optional. -1 = unlimitted. Not supported in BBB. [number] |
|
256 | - 'record' => $record, // New. 'true' will tell BBB to record the meeting. |
|
257 | - 'duration' => $duration, // Default = 0 which means no set duration in minutes. [number] |
|
255 | + 'maxParticipants' => $max, // Optional. -1 = unlimitted. Not supported in BBB. [number] |
|
256 | + 'record' => $record, // New. 'true' will tell BBB to record the meeting. |
|
257 | + 'duration' => $duration, // Default = 0 which means no set duration in minutes. [number] |
|
258 | 258 | //'meta_category' => '', // Use to pass additional info to BBB server. See API docs. |
259 | 259 | ); |
260 | 260 | |
261 | 261 | if ($this->debug) { |
262 | - error_log("create_meeting params: ".print_r($bbbParams,1)); |
|
262 | + error_log("create_meeting params: ".print_r($bbbParams, 1)); |
|
263 | 263 | } |
264 | 264 | |
265 | 265 | $status = false; |
@@ -272,7 +272,7 @@ discard block |
||
272 | 272 | if (isset($result) && strval($result['returncode']) == 'SUCCESS') { |
273 | 273 | if ($this->debug) { |
274 | 274 | error_log( |
275 | - "create_meeting result: " . print_r($result, 1) |
|
275 | + "create_meeting result: ".print_r($result, 1) |
|
276 | 276 | ); |
277 | 277 | } |
278 | 278 | $meeting = $this->joinMeeting($meetingName, true); |
@@ -303,7 +303,7 @@ discard block |
||
303 | 303 | |
304 | 304 | $courseId = api_get_course_int_id(); |
305 | 305 | $sessionId = api_get_session_id(); |
306 | - $conditions = array( |
|
306 | + $conditions = array( |
|
307 | 307 | 'where' => array( |
308 | 308 | 'c_id = ? AND session_id = ? AND meeting_name = ? AND status = 1 AND access_url = ?' => |
309 | 309 | array($courseId, $sessionId, $meetingName, $this->accessUrl) |
@@ -312,7 +312,7 @@ discard block |
||
312 | 312 | |
313 | 313 | if ($this->hasGroupSupport()) { |
314 | 314 | $groupId = api_get_group_id(); |
315 | - $conditions = array( |
|
315 | + $conditions = array( |
|
316 | 316 | 'where' => array( |
317 | 317 | 'c_id = ? AND session_id = ? AND meeting_name = ? AND group_id = ? AND status = 1 AND access_url = ?' => |
318 | 318 | array($courseId, $sessionId, $meetingName, $groupId, $this->accessUrl) |
@@ -409,7 +409,7 @@ discard block |
||
409 | 409 | |
410 | 410 | if ($this->debug) { |
411 | 411 | error_log( |
412 | - "meeting is running: " . intval($meetingInfoExists) |
|
412 | + "meeting is running: ".intval($meetingInfoExists) |
|
413 | 413 | ); |
414 | 414 | } |
415 | 415 | |
@@ -426,11 +426,11 @@ discard block |
||
426 | 426 | |
427 | 427 | if ($meetingInfoExists) { |
428 | 428 | $joinParams = array( |
429 | - 'meetingId' => $meetingData['remote_id'], // -- REQUIRED - A unique id for the meeting |
|
430 | - 'username' => $this->userCompleteName, //-- REQUIRED - The name that will display for the user in the meeting |
|
431 | - 'password' => $pass, //-- REQUIRED - The attendee or moderator password, depending on what's passed here |
|
429 | + 'meetingId' => $meetingData['remote_id'], // -- REQUIRED - A unique id for the meeting |
|
430 | + 'username' => $this->userCompleteName, //-- REQUIRED - The name that will display for the user in the meeting |
|
431 | + 'password' => $pass, //-- REQUIRED - The attendee or moderator password, depending on what's passed here |
|
432 | 432 | //'createTime' => api_get_utc_datetime(), //-- OPTIONAL - string. Leave blank ('') unless you set this correctly. |
433 | - 'userID' => api_get_user_id(), //-- OPTIONAL - string |
|
433 | + 'userID' => api_get_user_id(), //-- OPTIONAL - string |
|
434 | 434 | 'webVoiceConf' => '' // -- OPTIONAL - string |
435 | 435 | ); |
436 | 436 | $url = $this->api->getJoinMeetingURL($joinParams); |
@@ -439,7 +439,7 @@ discard block |
||
439 | 439 | $url = $this->logoutUrl; |
440 | 440 | } |
441 | 441 | if ($this->debug) { |
442 | - error_log("return url :" . $url); |
|
442 | + error_log("return url :".$url); |
|
443 | 443 | } |
444 | 444 | |
445 | 445 | return $url; |
@@ -480,7 +480,7 @@ discard block |
||
480 | 480 | */ |
481 | 481 | public function getAllMeetingsInCourse($courseId, $sessionId, $status) |
482 | 482 | { |
483 | - $conditions = array( |
|
483 | + $conditions = array( |
|
484 | 484 | 'where' => array( |
485 | 485 | 'status = ? AND c_id = ? AND session_id = ? ' => array( |
486 | 486 | $status, |
@@ -512,7 +512,7 @@ discard block |
||
512 | 512 | $courseId = api_get_course_int_id(); |
513 | 513 | $sessionId = api_get_session_id(); |
514 | 514 | |
515 | - $conditions = array( |
|
515 | + $conditions = array( |
|
516 | 516 | 'where' => array( |
517 | 517 | 'c_id = ? AND session_id = ? AND access_url = ?' => array( |
518 | 518 | $courseId, |
@@ -524,7 +524,7 @@ discard block |
||
524 | 524 | |
525 | 525 | if ($this->hasGroupSupport()) { |
526 | 526 | $groupId = api_get_group_id(); |
527 | - $conditions = array( |
|
527 | + $conditions = array( |
|
528 | 528 | 'where' => array( |
529 | 529 | 'c_id = ? AND session_id = ? AND group_id = ? AND access_url = ?' => |
530 | 530 | array($courseId, $sessionId, $groupId, $this->accessUrl) |
@@ -533,7 +533,7 @@ discard block |
||
533 | 533 | } |
534 | 534 | |
535 | 535 | if ($isGlobalPerUser) { |
536 | - $conditions = array( |
|
536 | + $conditions = array( |
|
537 | 537 | 'where' => array( |
538 | 538 | 'user_id = ? AND access_url = ?' => |
539 | 539 | array($this->userId, $this->accessUrl) |
@@ -568,7 +568,7 @@ discard block |
||
568 | 568 | } |
569 | 569 | $meetingBBB['end_url'] = $this->endUrl($meetingDB); |
570 | 570 | |
571 | - if (isset($meetingBBB['returncode']) && (string)$meetingBBB['returncode'] == 'FAILED') { |
|
571 | + if (isset($meetingBBB['returncode']) && (string) $meetingBBB['returncode'] == 'FAILED') { |
|
572 | 572 | if ($meetingDB['status'] == 1 && $this->isConferenceManager()) { |
573 | 573 | $this->endMeeting($meetingDB['id']); |
574 | 574 | } |
@@ -737,7 +737,7 @@ discard block |
||
737 | 737 | $actionLinksArray[] = $actionLinks; |
738 | 738 | $item['action_links'] = implode('<br />', $actionLinksArray); |
739 | 739 | } |
740 | - $item['show_links'] = implode('<br />', $recordArray); |
|
740 | + $item['show_links'] = implode('<br />', $recordArray); |
|
741 | 741 | $item['action_links'] = implode('<br />', $actionLinksArray); |
742 | 742 | } |
743 | 743 | |
@@ -750,11 +750,11 @@ discard block |
||
750 | 750 | |
751 | 751 | if ($meetingDB['status'] == 1) { |
752 | 752 | $joinParams = array( |
753 | - 'meetingId' => $meetingDB['remote_id'], //-- REQUIRED - A unique id for the meeting |
|
754 | - 'username' => $this->userCompleteName, //-- REQUIRED - The name that will display for the user in the meeting |
|
755 | - 'password' => $pass, //-- REQUIRED - The attendee or moderator password, depending on what's passed here |
|
756 | - 'createTime' => '', //-- OPTIONAL - string. Leave blank ('') unless you set this correctly. |
|
757 | - 'userID' => '', // -- OPTIONAL - string |
|
753 | + 'meetingId' => $meetingDB['remote_id'], //-- REQUIRED - A unique id for the meeting |
|
754 | + 'username' => $this->userCompleteName, //-- REQUIRED - The name that will display for the user in the meeting |
|
755 | + 'password' => $pass, //-- REQUIRED - The attendee or moderator password, depending on what's passed here |
|
756 | + 'createTime' => '', //-- OPTIONAL - string. Leave blank ('') unless you set this correctly. |
|
757 | + 'userID' => '', // -- OPTIONAL - string |
|
758 | 758 | 'webVoiceConf' => '' // -- OPTIONAL - string |
759 | 759 | ); |
760 | 760 | $item['go_url'] = $this->protocol.$this->api->getJoinMeetingURL($joinParams); |
@@ -815,8 +815,8 @@ discard block |
||
815 | 815 | $pass = $this->getUserMeetingPassword(); |
816 | 816 | |
817 | 817 | $endParams = array( |
818 | - 'meetingId' => $meetingData['remote_id'], // REQUIRED - We have to know which meeting to end. |
|
819 | - 'password' => $pass, // REQUIRED - Must match moderator pass for meeting. |
|
818 | + 'meetingId' => $meetingData['remote_id'], // REQUIRED - We have to know which meeting to end. |
|
819 | + 'password' => $pass, // REQUIRED - Must match moderator pass for meeting. |
|
820 | 820 | ); |
821 | 821 | $this->api->endMeetingWithXmlResponseArray($endParams); |
822 | 822 | Database::update( |
@@ -1067,7 +1067,7 @@ discard block |
||
1067 | 1067 | */ |
1068 | 1068 | public function redirectToBBB($url) |
1069 | 1069 | { |
1070 | - if (file_exists(__DIR__ . '/../config.vm.php')) { |
|
1070 | + if (file_exists(__DIR__.'/../config.vm.php')) { |
|
1071 | 1071 | // Using VM |
1072 | 1072 | echo Display::url(get_lang('ClickToContinue'), $url); |
1073 | 1073 | exit; |
@@ -59,6 +59,9 @@ |
||
59 | 59 | $this->_bbbServerBaseUrl = CONFIG_SERVER_BASE_URL; |
60 | 60 | } |
61 | 61 | |
62 | + /** |
|
63 | + * @param string $url |
|
64 | + */ |
|
62 | 65 | private function _processXmlResponse($url){ |
63 | 66 | /* |
64 | 67 | A private utility method used by other public methods to process XML responses. |
@@ -55,25 +55,25 @@ discard block |
||
55 | 55 | */ |
56 | 56 | // BASE CONFIGS - set these for your BBB server in config.php and they will |
57 | 57 | // simply flow in here via the constants: |
58 | - $this->_securitySalt = CONFIG_SECURITY_SALT; |
|
59 | - $this->_bbbServerBaseUrl = CONFIG_SERVER_BASE_URL; |
|
58 | + $this->_securitySalt = CONFIG_SECURITY_SALT; |
|
59 | + $this->_bbbServerBaseUrl = CONFIG_SERVER_BASE_URL; |
|
60 | 60 | } |
61 | 61 | |
62 | - private function _processXmlResponse($url){ |
|
62 | + private function _processXmlResponse($url) { |
|
63 | 63 | /* |
64 | 64 | A private utility method used by other public methods to process XML responses. |
65 | 65 | */ |
66 | 66 | if (extension_loaded('curl')) { |
67 | - $ch = curl_init() or die ( curl_error($ch) ); |
|
67 | + $ch = curl_init() or die (curl_error($ch)); |
|
68 | 68 | $timeout = 10; |
69 | - curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, false); |
|
70 | - curl_setopt( $ch, CURLOPT_URL, $url ); |
|
71 | - curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 ); |
|
72 | - curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, $timeout); |
|
73 | - $data = curl_exec( $ch ); |
|
74 | - curl_close( $ch ); |
|
75 | - |
|
76 | - if($data) |
|
69 | + curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); |
|
70 | + curl_setopt($ch, CURLOPT_URL, $url); |
|
71 | + curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); |
|
72 | + curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $timeout); |
|
73 | + $data = curl_exec($ch); |
|
74 | + curl_close($ch); |
|
75 | + |
|
76 | + if ($data) |
|
77 | 77 | return (new SimpleXMLElement($data)); |
78 | 78 | else |
79 | 79 | return false; |
@@ -137,10 +137,10 @@ discard block |
||
137 | 137 | '&duration='.urlencode($creationParams['duration']); |
138 | 138 | //'&meta_category='.urlencode($creationParams['meta_category']); |
139 | 139 | $welcomeMessage = $creationParams['welcomeMsg']; |
140 | - if(trim($welcomeMessage)) |
|
140 | + if (trim($welcomeMessage)) |
|
141 | 141 | $params .= '&welcome='.urlencode($welcomeMessage); |
142 | 142 | // Return the complete URL: |
143 | - return ( $creationUrl.$params.'&checksum='.sha1("create".$params.$this->_securitySalt) ); |
|
143 | + return ($creationUrl.$params.'&checksum='.sha1("create".$params.$this->_securitySalt)); |
|
144 | 144 | } |
145 | 145 | |
146 | 146 | public function createMeetingWithXmlResponseArray($creationParams) { |
@@ -165,7 +165,7 @@ discard block |
||
165 | 165 | $xml = $this->_processXmlResponse($this->getCreateMeetingURL($creationParams)); |
166 | 166 | |
167 | 167 | if ($xml) { |
168 | - if($xml->meetingID) |
|
168 | + if ($xml->meetingID) |
|
169 | 169 | return array( |
170 | 170 | 'returncode' => $xml->returncode, |
171 | 171 | 'message' => $xml->message, |
@@ -283,7 +283,7 @@ discard block |
||
283 | 283 | $meetingId = '1234' -- REQUIRED - The unique id for the meeting |
284 | 284 | */ |
285 | 285 | $xml = $this->_processXmlResponse($this->getIsMeetingRunningUrl($meetingId)); |
286 | - if($xml) { |
|
286 | + if ($xml) { |
|
287 | 287 | return array( |
288 | 288 | 'returncode' => $xml->returncode, |
289 | 289 | 'running' => $xml->running // -- Returns true/false. |
@@ -310,7 +310,7 @@ discard block |
||
310 | 310 | and then handle the results that we get in the XML response. |
311 | 311 | */ |
312 | 312 | $xml = $this->_processXmlResponse($this->getGetMeetingsUrl()); |
313 | - if($xml) { |
|
313 | + if ($xml) { |
|
314 | 314 | // If we don't get a success code, stop processing and return just the returncode: |
315 | 315 | if ($xml->returncode != 'SUCCESS') { |
316 | 316 | $result = array( |
@@ -379,7 +379,7 @@ discard block |
||
379 | 379 | ); |
380 | 380 | */ |
381 | 381 | $xml = $this->_processXmlResponse($this->getMeetingInfoUrl($infoParams)); |
382 | - if($xml) { |
|
382 | + if ($xml) { |
|
383 | 383 | // If we don't get a success code or messageKey, find out why: |
384 | 384 | if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
385 | 385 | $result = array( |
@@ -454,7 +454,7 @@ discard block |
||
454 | 454 | probably be required in user code when 'recording' is set to true. |
455 | 455 | */ |
456 | 456 | $xml = $this->_processXmlResponse($this->getRecordingsUrl($recordingParams)); |
457 | - if($xml) { |
|
457 | + if ($xml) { |
|
458 | 458 | // If we don't get a success code or messageKey, find out why: |
459 | 459 | if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
460 | 460 | $result = array( |
@@ -524,7 +524,7 @@ discard block |
||
524 | 524 | ); |
525 | 525 | */ |
526 | 526 | $xml = $this->_processXmlResponse($this->getPublishRecordingsUrl($recordingParams)); |
527 | - if($xml) { |
|
527 | + if ($xml) { |
|
528 | 528 | return array( |
529 | 529 | 'returncode' => $xml->returncode, |
530 | 530 | 'published' => $xml->published // -- Returns true/false. |
@@ -557,7 +557,7 @@ discard block |
||
557 | 557 | */ |
558 | 558 | |
559 | 559 | $xml = $this->_processXmlResponse($this->getDeleteRecordingsUrl($recordingParams)); |
560 | - if($xml) { |
|
560 | + if ($xml) { |
|
561 | 561 | return array( |
562 | 562 | 'returncode' => $xml->returncode, |
563 | 563 | 'deleted' => $xml->deleted // -- Returns true/false. |
@@ -73,10 +73,11 @@ discard block |
||
73 | 73 | $data = curl_exec( $ch ); |
74 | 74 | curl_close( $ch ); |
75 | 75 | |
76 | - if($data) |
|
77 | - return (new SimpleXMLElement($data)); |
|
78 | - else |
|
79 | - return false; |
|
76 | + if($data) { |
|
77 | + return (new SimpleXMLElement($data)); |
|
78 | + } else { |
|
79 | + return false; |
|
80 | + } |
|
80 | 81 | } |
81 | 82 | return (simplexml_load_file($url)); |
82 | 83 | } |
@@ -85,11 +86,9 @@ discard block |
||
85 | 86 | /* Process required params and throw errors if we don't get values */ |
86 | 87 | if ((isset($param)) && ($param != '')) { |
87 | 88 | return $param; |
88 | - } |
|
89 | - elseif (!isset($param)) { |
|
89 | + } elseif (!isset($param)) { |
|
90 | 90 | throw new Exception('Missing parameter.'); |
91 | - } |
|
92 | - else { |
|
91 | + } else { |
|
93 | 92 | throw new Exception(''.$param.' is required.'); |
94 | 93 | } |
95 | 94 | } |
@@ -99,8 +98,7 @@ discard block |
||
99 | 98 | /* Don't know if we'll use this one, but let's build it in case. */ |
100 | 99 | if ((isset($param)) && ($param != '')) { |
101 | 100 | return $param; |
102 | - } |
|
103 | - else { |
|
101 | + } else { |
|
104 | 102 | $param = ''; |
105 | 103 | return $param; |
106 | 104 | } |
@@ -137,8 +135,9 @@ discard block |
||
137 | 135 | '&duration='.urlencode($creationParams['duration']); |
138 | 136 | //'&meta_category='.urlencode($creationParams['meta_category']); |
139 | 137 | $welcomeMessage = $creationParams['welcomeMsg']; |
140 | - if(trim($welcomeMessage)) |
|
141 | - $params .= '&welcome='.urlencode($welcomeMessage); |
|
138 | + if(trim($welcomeMessage)) { |
|
139 | + $params .= '&welcome='.urlencode($welcomeMessage); |
|
140 | + } |
|
142 | 141 | // Return the complete URL: |
143 | 142 | return ( $creationUrl.$params.'&checksum='.sha1("create".$params.$this->_securitySalt) ); |
144 | 143 | } |
@@ -165,8 +164,8 @@ discard block |
||
165 | 164 | $xml = $this->_processXmlResponse($this->getCreateMeetingURL($creationParams)); |
166 | 165 | |
167 | 166 | if ($xml) { |
168 | - if($xml->meetingID) |
|
169 | - return array( |
|
167 | + if($xml->meetingID) { |
|
168 | + return array( |
|
170 | 169 | 'returncode' => $xml->returncode, |
171 | 170 | 'message' => $xml->message, |
172 | 171 | 'messageKey' => $xml->messageKey, |
@@ -176,14 +175,14 @@ discard block |
||
176 | 175 | 'hasBeenForciblyEnded' => $xml->hasBeenForciblyEnded, |
177 | 176 | 'createTime' => $xml->createTime |
178 | 177 | ); |
179 | - else |
|
180 | - return array( |
|
178 | + } else { |
|
179 | + return array( |
|
181 | 180 | 'returncode' => $xml->returncode, |
182 | 181 | 'message' => $xml->message, |
183 | 182 | 'messageKey' => $xml->messageKey |
184 | 183 | ); |
185 | - } |
|
186 | - else { |
|
184 | + } |
|
185 | + } else { |
|
187 | 186 | return null; |
188 | 187 | } |
189 | 188 | } |
@@ -253,8 +252,7 @@ discard block |
||
253 | 252 | 'message' => $xml->message, |
254 | 253 | 'messageKey' => $xml->messageKey |
255 | 254 | ); |
256 | - } |
|
257 | - else { |
|
255 | + } else { |
|
258 | 256 | return null; |
259 | 257 | } |
260 | 258 | |
@@ -288,8 +286,7 @@ discard block |
||
288 | 286 | 'returncode' => $xml->returncode, |
289 | 287 | 'running' => $xml->running // -- Returns true/false. |
290 | 288 | ); |
291 | - } |
|
292 | - else { |
|
289 | + } else { |
|
293 | 290 | return null; |
294 | 291 | } |
295 | 292 | |
@@ -317,8 +314,7 @@ discard block |
||
317 | 314 | 'returncode' => $xml->returncode |
318 | 315 | ); |
319 | 316 | return $result; |
320 | - } |
|
321 | - elseif ($xml->messageKey == 'noMeetings') { |
|
317 | + } elseif ($xml->messageKey == 'noMeetings') { |
|
322 | 318 | /* No meetings on server, so return just this info: */ |
323 | 319 | $result = array( |
324 | 320 | 'returncode' => $xml->returncode, |
@@ -326,8 +322,7 @@ discard block |
||
326 | 322 | 'message' => $xml->message |
327 | 323 | ); |
328 | 324 | return $result; |
329 | - } |
|
330 | - else { |
|
325 | + } else { |
|
331 | 326 | // In this case, we have success and meetings. First return general response: |
332 | 327 | $result = array( |
333 | 328 | 'returncode' => $xml->returncode, |
@@ -348,8 +343,7 @@ discard block |
||
348 | 343 | } |
349 | 344 | return $result; |
350 | 345 | } |
351 | - } |
|
352 | - else { |
|
346 | + } else { |
|
353 | 347 | return null; |
354 | 348 | } |
355 | 349 | |
@@ -388,8 +382,7 @@ discard block |
||
388 | 382 | 'message' => $xml->message |
389 | 383 | ); |
390 | 384 | return $result; |
391 | - } |
|
392 | - else { |
|
385 | + } else { |
|
393 | 386 | // In this case, we have success and meeting info: |
394 | 387 | $result = array( |
395 | 388 | 'returncode' => $xml->returncode, |
@@ -418,8 +411,7 @@ discard block |
||
418 | 411 | } |
419 | 412 | return $result; |
420 | 413 | } |
421 | - } |
|
422 | - else { |
|
414 | + } else { |
|
423 | 415 | return null; |
424 | 416 | } |
425 | 417 | |
@@ -463,8 +455,7 @@ discard block |
||
463 | 455 | 'message' => $xml->message |
464 | 456 | ); |
465 | 457 | return $result; |
466 | - } |
|
467 | - else { |
|
458 | + } else { |
|
468 | 459 | // In this case, we have success and recording info: |
469 | 460 | $result = array( |
470 | 461 | 'returncode' => $xml->returncode, |
@@ -495,8 +486,7 @@ discard block |
||
495 | 486 | } |
496 | 487 | return $result; |
497 | 488 | } |
498 | - } |
|
499 | - else { |
|
489 | + } else { |
|
500 | 490 | return null; |
501 | 491 | } |
502 | 492 | } |
@@ -529,8 +519,7 @@ discard block |
||
529 | 519 | 'returncode' => $xml->returncode, |
530 | 520 | 'published' => $xml->published // -- Returns true/false. |
531 | 521 | ); |
532 | - } |
|
533 | - else { |
|
522 | + } else { |
|
534 | 523 | return null; |
535 | 524 | } |
536 | 525 | |
@@ -562,8 +551,7 @@ discard block |
||
562 | 551 | 'returncode' => $xml->returncode, |
563 | 552 | 'deleted' => $xml->deleted // -- Returns true/false. |
564 | 553 | ); |
565 | - } |
|
566 | - else { |
|
554 | + } else { |
|
567 | 555 | return null; |
568 | 556 | } |
569 | 557 |
@@ -44,107 +44,107 @@ discard block |
||
44 | 44 | |
45 | 45 | class BigBlueButtonBN { |
46 | 46 | |
47 | - private $_securitySalt; |
|
48 | - private $_bbbServerBaseUrl; |
|
47 | + private $_securitySalt; |
|
48 | + private $_bbbServerBaseUrl; |
|
49 | 49 | |
50 | - /* ___________ General Methods for the BigBlueButton Class __________ */ |
|
50 | + /* ___________ General Methods for the BigBlueButton Class __________ */ |
|
51 | 51 | |
52 | - function __construct() { |
|
53 | - /* |
|
52 | + function __construct() { |
|
53 | + /* |
|
54 | 54 | Establish just our basic elements in the constructor: |
55 | 55 | */ |
56 | - // BASE CONFIGS - set these for your BBB server in config.php and they will |
|
57 | - // simply flow in here via the constants: |
|
58 | - $this->_securitySalt = CONFIG_SECURITY_SALT; |
|
59 | - $this->_bbbServerBaseUrl = CONFIG_SERVER_BASE_URL; |
|
60 | - } |
|
61 | - |
|
62 | - private function _processXmlResponse($url){ |
|
63 | - /* |
|
56 | + // BASE CONFIGS - set these for your BBB server in config.php and they will |
|
57 | + // simply flow in here via the constants: |
|
58 | + $this->_securitySalt = CONFIG_SECURITY_SALT; |
|
59 | + $this->_bbbServerBaseUrl = CONFIG_SERVER_BASE_URL; |
|
60 | + } |
|
61 | + |
|
62 | + private function _processXmlResponse($url){ |
|
63 | + /* |
|
64 | 64 | A private utility method used by other public methods to process XML responses. |
65 | 65 | */ |
66 | - if (extension_loaded('curl')) { |
|
67 | - $ch = curl_init() or die ( curl_error($ch) ); |
|
68 | - $timeout = 10; |
|
69 | - curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, false); |
|
70 | - curl_setopt( $ch, CURLOPT_URL, $url ); |
|
71 | - curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 ); |
|
72 | - curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, $timeout); |
|
73 | - $data = curl_exec( $ch ); |
|
74 | - curl_close( $ch ); |
|
75 | - |
|
76 | - if($data) |
|
77 | - return (new SimpleXMLElement($data)); |
|
78 | - else |
|
79 | - return false; |
|
80 | - } |
|
81 | - return (simplexml_load_file($url)); |
|
82 | - } |
|
83 | - |
|
84 | - private function _requiredParam($param) { |
|
85 | - /* Process required params and throw errors if we don't get values */ |
|
86 | - if ((isset($param)) && ($param != '')) { |
|
87 | - return $param; |
|
88 | - } |
|
89 | - elseif (!isset($param)) { |
|
90 | - throw new Exception('Missing parameter.'); |
|
91 | - } |
|
92 | - else { |
|
93 | - throw new Exception(''.$param.' is required.'); |
|
94 | - } |
|
95 | - } |
|
96 | - |
|
97 | - private function _optionalParam($param) { |
|
98 | - /* Pass most optional params through as set value, or set to '' */ |
|
99 | - /* Don't know if we'll use this one, but let's build it in case. */ |
|
100 | - if ((isset($param)) && ($param != '')) { |
|
101 | - return $param; |
|
102 | - } |
|
103 | - else { |
|
104 | - $param = ''; |
|
105 | - return $param; |
|
106 | - } |
|
107 | - } |
|
108 | - |
|
109 | - /* __________________ BBB ADMINISTRATION METHODS _________________ */ |
|
110 | - /* The methods in the following section support the following categories of the BBB API: |
|
66 | + if (extension_loaded('curl')) { |
|
67 | + $ch = curl_init() or die ( curl_error($ch) ); |
|
68 | + $timeout = 10; |
|
69 | + curl_setopt( $ch, CURLOPT_SSL_VERIFYPEER, false); |
|
70 | + curl_setopt( $ch, CURLOPT_URL, $url ); |
|
71 | + curl_setopt( $ch, CURLOPT_RETURNTRANSFER, 1 ); |
|
72 | + curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT, $timeout); |
|
73 | + $data = curl_exec( $ch ); |
|
74 | + curl_close( $ch ); |
|
75 | + |
|
76 | + if($data) |
|
77 | + return (new SimpleXMLElement($data)); |
|
78 | + else |
|
79 | + return false; |
|
80 | + } |
|
81 | + return (simplexml_load_file($url)); |
|
82 | + } |
|
83 | + |
|
84 | + private function _requiredParam($param) { |
|
85 | + /* Process required params and throw errors if we don't get values */ |
|
86 | + if ((isset($param)) && ($param != '')) { |
|
87 | + return $param; |
|
88 | + } |
|
89 | + elseif (!isset($param)) { |
|
90 | + throw new Exception('Missing parameter.'); |
|
91 | + } |
|
92 | + else { |
|
93 | + throw new Exception(''.$param.' is required.'); |
|
94 | + } |
|
95 | + } |
|
96 | + |
|
97 | + private function _optionalParam($param) { |
|
98 | + /* Pass most optional params through as set value, or set to '' */ |
|
99 | + /* Don't know if we'll use this one, but let's build it in case. */ |
|
100 | + if ((isset($param)) && ($param != '')) { |
|
101 | + return $param; |
|
102 | + } |
|
103 | + else { |
|
104 | + $param = ''; |
|
105 | + return $param; |
|
106 | + } |
|
107 | + } |
|
108 | + |
|
109 | + /* __________________ BBB ADMINISTRATION METHODS _________________ */ |
|
110 | + /* The methods in the following section support the following categories of the BBB API: |
|
111 | 111 | -- create |
112 | 112 | -- join |
113 | 113 | -- end |
114 | 114 | */ |
115 | 115 | |
116 | - public function getCreateMeetingUrl($creationParams) { |
|
117 | - /* |
|
116 | + public function getCreateMeetingUrl($creationParams) { |
|
117 | + /* |
|
118 | 118 | USAGE: |
119 | 119 | (see $creationParams array in createMeetingArray method.) |
120 | 120 | */ |
121 | - $this->_meetingId = $this->_requiredParam($creationParams['meetingId']); |
|
122 | - $this->_meetingName = $this->_requiredParam($creationParams['meetingName']); |
|
123 | - // Set up the basic creation URL: |
|
124 | - $creationUrl = $this->_bbbServerBaseUrl."api/create?"; |
|
125 | - // Add params: |
|
126 | - $params = |
|
127 | - 'name='.urlencode($this->_meetingName). |
|
128 | - '&meetingID='.urlencode($this->_meetingId). |
|
129 | - '&attendeePW='.urlencode($creationParams['attendeePw']). |
|
130 | - '&moderatorPW='.urlencode($creationParams['moderatorPw']). |
|
131 | - '&dialNumber='.urlencode($creationParams['dialNumber']). |
|
132 | - '&voiceBridge='.urlencode($creationParams['voiceBridge']). |
|
133 | - '&webVoice='.urlencode($creationParams['webVoice']). |
|
134 | - '&logoutURL='.urlencode($creationParams['logoutUrl']). |
|
135 | - '&maxParticipants='.urlencode($creationParams['maxParticipants']). |
|
136 | - '&record='.urlencode($creationParams['record']). |
|
137 | - '&duration='.urlencode($creationParams['duration']); |
|
138 | - //'&meta_category='.urlencode($creationParams['meta_category']); |
|
139 | - $welcomeMessage = $creationParams['welcomeMsg']; |
|
140 | - if(trim($welcomeMessage)) |
|
141 | - $params .= '&welcome='.urlencode($welcomeMessage); |
|
142 | - // Return the complete URL: |
|
143 | - return ( $creationUrl.$params.'&checksum='.sha1("create".$params.$this->_securitySalt) ); |
|
144 | - } |
|
145 | - |
|
146 | - public function createMeetingWithXmlResponseArray($creationParams) { |
|
147 | - /* |
|
121 | + $this->_meetingId = $this->_requiredParam($creationParams['meetingId']); |
|
122 | + $this->_meetingName = $this->_requiredParam($creationParams['meetingName']); |
|
123 | + // Set up the basic creation URL: |
|
124 | + $creationUrl = $this->_bbbServerBaseUrl."api/create?"; |
|
125 | + // Add params: |
|
126 | + $params = |
|
127 | + 'name='.urlencode($this->_meetingName). |
|
128 | + '&meetingID='.urlencode($this->_meetingId). |
|
129 | + '&attendeePW='.urlencode($creationParams['attendeePw']). |
|
130 | + '&moderatorPW='.urlencode($creationParams['moderatorPw']). |
|
131 | + '&dialNumber='.urlencode($creationParams['dialNumber']). |
|
132 | + '&voiceBridge='.urlencode($creationParams['voiceBridge']). |
|
133 | + '&webVoice='.urlencode($creationParams['webVoice']). |
|
134 | + '&logoutURL='.urlencode($creationParams['logoutUrl']). |
|
135 | + '&maxParticipants='.urlencode($creationParams['maxParticipants']). |
|
136 | + '&record='.urlencode($creationParams['record']). |
|
137 | + '&duration='.urlencode($creationParams['duration']); |
|
138 | + //'&meta_category='.urlencode($creationParams['meta_category']); |
|
139 | + $welcomeMessage = $creationParams['welcomeMsg']; |
|
140 | + if(trim($welcomeMessage)) |
|
141 | + $params .= '&welcome='.urlencode($welcomeMessage); |
|
142 | + // Return the complete URL: |
|
143 | + return ( $creationUrl.$params.'&checksum='.sha1("create".$params.$this->_securitySalt) ); |
|
144 | + } |
|
145 | + |
|
146 | + public function createMeetingWithXmlResponseArray($creationParams) { |
|
147 | + /* |
|
148 | 148 | USAGE: |
149 | 149 | $creationParams = array( |
150 | 150 | 'name' => 'Meeting Name', -- A name for the meeting (or username) |
@@ -162,34 +162,34 @@ discard block |
||
162 | 162 | 'meta_category' => '', -- Use to pass additional info to BBB server. See API docs to enable. |
163 | 163 | ); |
164 | 164 | */ |
165 | - $xml = $this->_processXmlResponse($this->getCreateMeetingURL($creationParams)); |
|
165 | + $xml = $this->_processXmlResponse($this->getCreateMeetingURL($creationParams)); |
|
166 | 166 | |
167 | 167 | if ($xml) { |
168 | - if($xml->meetingID) |
|
169 | - return array( |
|
170 | - 'returncode' => $xml->returncode->__toString(), |
|
171 | - 'message' => $xml->message->__toString(), |
|
172 | - 'messageKey' => $xml->messageKey->__toString(), |
|
173 | - 'meetingId' => $xml->meetingID->__toString(), |
|
174 | - 'attendeePw' => $xml->attendeePW->__toString(), |
|
175 | - 'moderatorPw' => $xml->moderatorPW->__toString(), |
|
176 | - 'hasBeenForciblyEnded' => $xml->hasBeenForciblyEnded->__toString(), |
|
177 | - 'createTime' => $xml->createTime->__toString() |
|
178 | - ); |
|
179 | - else |
|
180 | - return array( |
|
181 | - 'returncode' => $xml->returncode->__toString(), |
|
182 | - 'message' => $xml->message->__toString(), |
|
183 | - 'messageKey' => $xml->messageKey->__toString() |
|
184 | - ); |
|
185 | - } |
|
186 | - else { |
|
187 | - return null; |
|
188 | - } |
|
189 | - } |
|
190 | - |
|
191 | - public function getJoinMeetingURL($joinParams) { |
|
192 | - /* |
|
168 | + if($xml->meetingID) |
|
169 | + return array( |
|
170 | + 'returncode' => $xml->returncode->__toString(), |
|
171 | + 'message' => $xml->message->__toString(), |
|
172 | + 'messageKey' => $xml->messageKey->__toString(), |
|
173 | + 'meetingId' => $xml->meetingID->__toString(), |
|
174 | + 'attendeePw' => $xml->attendeePW->__toString(), |
|
175 | + 'moderatorPw' => $xml->moderatorPW->__toString(), |
|
176 | + 'hasBeenForciblyEnded' => $xml->hasBeenForciblyEnded->__toString(), |
|
177 | + 'createTime' => $xml->createTime->__toString() |
|
178 | + ); |
|
179 | + else |
|
180 | + return array( |
|
181 | + 'returncode' => $xml->returncode->__toString(), |
|
182 | + 'message' => $xml->message->__toString(), |
|
183 | + 'messageKey' => $xml->messageKey->__toString() |
|
184 | + ); |
|
185 | + } |
|
186 | + else { |
|
187 | + return null; |
|
188 | + } |
|
189 | + } |
|
190 | + |
|
191 | + public function getJoinMeetingURL($joinParams) { |
|
192 | + /* |
|
193 | 193 | NOTE: At this point, we don't use a corresponding joinMeetingWithXmlResponse here because the API |
194 | 194 | doesn't respond on success, but you can still code that method if you need it. Or, you can take the URL |
195 | 195 | that's returned from this method and simply send your users off to that URL in your code. |
@@ -203,249 +203,249 @@ discard block |
||
203 | 203 | 'webVoiceConf' => '' -- OPTIONAL - string |
204 | 204 | ); |
205 | 205 | */ |
206 | - $this->_meetingId = $this->_requiredParam($joinParams['meetingId']); |
|
207 | - $this->_username = $this->_requiredParam($joinParams['username']); |
|
208 | - $this->_password = $this->_requiredParam($joinParams['password']); |
|
209 | - // Establish the basic join URL: |
|
210 | - $joinUrl = $this->_bbbServerBaseUrl."api/join?"; |
|
211 | - // Add parameters to the URL: |
|
212 | - $params = |
|
213 | - 'meetingID='.urlencode($this->_meetingId). |
|
214 | - '&fullName='.urlencode($this->_username). |
|
215 | - '&password='.urlencode($this->_password). |
|
216 | - '&userID='.urlencode($joinParams['userID']). |
|
217 | - '&webVoiceConf='.urlencode($joinParams['webVoiceConf']); |
|
218 | - // Only use createTime if we really want to use it. If it's '', then don't pass it: |
|
219 | - if (((isset($joinParams['createTime'])) && ($joinParams['createTime'] != ''))) { |
|
220 | - $params .= '&createTime='.urlencode($joinParams['createTime']); |
|
221 | - } |
|
222 | - // Return the URL: |
|
223 | - return ($joinUrl.$params.'&checksum='.sha1("join".$params.$this->_securitySalt)); |
|
224 | - } |
|
225 | - |
|
226 | - public function getEndMeetingURL($endParams) { |
|
227 | - /* USAGE: |
|
206 | + $this->_meetingId = $this->_requiredParam($joinParams['meetingId']); |
|
207 | + $this->_username = $this->_requiredParam($joinParams['username']); |
|
208 | + $this->_password = $this->_requiredParam($joinParams['password']); |
|
209 | + // Establish the basic join URL: |
|
210 | + $joinUrl = $this->_bbbServerBaseUrl."api/join?"; |
|
211 | + // Add parameters to the URL: |
|
212 | + $params = |
|
213 | + 'meetingID='.urlencode($this->_meetingId). |
|
214 | + '&fullName='.urlencode($this->_username). |
|
215 | + '&password='.urlencode($this->_password). |
|
216 | + '&userID='.urlencode($joinParams['userID']). |
|
217 | + '&webVoiceConf='.urlencode($joinParams['webVoiceConf']); |
|
218 | + // Only use createTime if we really want to use it. If it's '', then don't pass it: |
|
219 | + if (((isset($joinParams['createTime'])) && ($joinParams['createTime'] != ''))) { |
|
220 | + $params .= '&createTime='.urlencode($joinParams['createTime']); |
|
221 | + } |
|
222 | + // Return the URL: |
|
223 | + return ($joinUrl.$params.'&checksum='.sha1("join".$params.$this->_securitySalt)); |
|
224 | + } |
|
225 | + |
|
226 | + public function getEndMeetingURL($endParams) { |
|
227 | + /* USAGE: |
|
228 | 228 | $endParams = array ( |
229 | 229 | 'meetingId' => '1234', -- REQUIRED - The unique id for the meeting |
230 | 230 | 'password' => 'mp' -- REQUIRED - The moderator password for the meeting |
231 | 231 | ); |
232 | 232 | */ |
233 | - $this->_meetingId = $this->_requiredParam($endParams['meetingId']); |
|
234 | - $this->_password = $this->_requiredParam($endParams['password']); |
|
235 | - $endUrl = $this->_bbbServerBaseUrl."api/end?"; |
|
236 | - $params = |
|
237 | - 'meetingID='.urlencode($this->_meetingId). |
|
238 | - '&password='.urlencode($this->_password); |
|
239 | - return ($endUrl.$params.'&checksum='.sha1("end".$params.$this->_securitySalt)); |
|
240 | - } |
|
241 | - |
|
242 | - public function endMeetingWithXmlResponseArray($endParams) { |
|
243 | - /* USAGE: |
|
233 | + $this->_meetingId = $this->_requiredParam($endParams['meetingId']); |
|
234 | + $this->_password = $this->_requiredParam($endParams['password']); |
|
235 | + $endUrl = $this->_bbbServerBaseUrl."api/end?"; |
|
236 | + $params = |
|
237 | + 'meetingID='.urlencode($this->_meetingId). |
|
238 | + '&password='.urlencode($this->_password); |
|
239 | + return ($endUrl.$params.'&checksum='.sha1("end".$params.$this->_securitySalt)); |
|
240 | + } |
|
241 | + |
|
242 | + public function endMeetingWithXmlResponseArray($endParams) { |
|
243 | + /* USAGE: |
|
244 | 244 | $endParams = array ( |
245 | 245 | 'meetingId' => '1234', -- REQUIRED - The unique id for the meeting |
246 | 246 | 'password' => 'mp' -- REQUIRED - The moderator password for the meeting |
247 | 247 | ); |
248 | 248 | */ |
249 | - $xml = $this->_processXmlResponse($this->getEndMeetingURL($endParams)); |
|
250 | - if ($xml) { |
|
251 | - return array( |
|
252 | - 'returncode' => $xml->returncode->__toString(), |
|
253 | - 'message' => $xml->message->__toString(), |
|
254 | - 'messageKey' => $xml->messageKey->__toString() |
|
255 | - ); |
|
256 | - } |
|
257 | - else { |
|
258 | - return null; |
|
259 | - } |
|
260 | - |
|
261 | - } |
|
262 | - |
|
263 | - /* __________________ BBB MONITORING METHODS _________________ */ |
|
264 | - /* The methods in the following section support the following categories of the BBB API: |
|
249 | + $xml = $this->_processXmlResponse($this->getEndMeetingURL($endParams)); |
|
250 | + if ($xml) { |
|
251 | + return array( |
|
252 | + 'returncode' => $xml->returncode->__toString(), |
|
253 | + 'message' => $xml->message->__toString(), |
|
254 | + 'messageKey' => $xml->messageKey->__toString() |
|
255 | + ); |
|
256 | + } |
|
257 | + else { |
|
258 | + return null; |
|
259 | + } |
|
260 | + |
|
261 | + } |
|
262 | + |
|
263 | + /* __________________ BBB MONITORING METHODS _________________ */ |
|
264 | + /* The methods in the following section support the following categories of the BBB API: |
|
265 | 265 | -- isMeetingRunning |
266 | 266 | -- getMeetings |
267 | 267 | -- getMeetingInfo |
268 | 268 | */ |
269 | 269 | |
270 | - public function getIsMeetingRunningUrl($meetingId) { |
|
271 | - /* USAGE: |
|
270 | + public function getIsMeetingRunningUrl($meetingId) { |
|
271 | + /* USAGE: |
|
272 | 272 | $meetingId = '1234' -- REQUIRED - The unique id for the meeting |
273 | 273 | */ |
274 | - $this->_meetingId = $this->_requiredParam($meetingId); |
|
275 | - $runningUrl = $this->_bbbServerBaseUrl."api/isMeetingRunning?"; |
|
276 | - $params = |
|
277 | - 'meetingID='.urlencode($this->_meetingId); |
|
278 | - return ($runningUrl.$params.'&checksum='.sha1("isMeetingRunning".$params.$this->_securitySalt)); |
|
279 | - } |
|
280 | - |
|
281 | - public function isMeetingRunningWithXmlResponseArray($meetingId) { |
|
282 | - /* USAGE: |
|
274 | + $this->_meetingId = $this->_requiredParam($meetingId); |
|
275 | + $runningUrl = $this->_bbbServerBaseUrl."api/isMeetingRunning?"; |
|
276 | + $params = |
|
277 | + 'meetingID='.urlencode($this->_meetingId); |
|
278 | + return ($runningUrl.$params.'&checksum='.sha1("isMeetingRunning".$params.$this->_securitySalt)); |
|
279 | + } |
|
280 | + |
|
281 | + public function isMeetingRunningWithXmlResponseArray($meetingId) { |
|
282 | + /* USAGE: |
|
283 | 283 | $meetingId = '1234' -- REQUIRED - The unique id for the meeting |
284 | 284 | */ |
285 | - $xml = $this->_processXmlResponse($this->getIsMeetingRunningUrl($meetingId)); |
|
286 | - if($xml) { |
|
287 | - return array( |
|
288 | - 'returncode' => $xml->returncode->__toString(), |
|
289 | - 'running' => $xml->running->__toString() // -- Returns true/false. |
|
290 | - ); |
|
291 | - } |
|
292 | - else { |
|
293 | - return null; |
|
294 | - } |
|
295 | - |
|
296 | - } |
|
297 | - |
|
298 | - public function getGetMeetingsUrl() { |
|
299 | - /* Simply formulate the getMeetings URL |
|
285 | + $xml = $this->_processXmlResponse($this->getIsMeetingRunningUrl($meetingId)); |
|
286 | + if($xml) { |
|
287 | + return array( |
|
288 | + 'returncode' => $xml->returncode->__toString(), |
|
289 | + 'running' => $xml->running->__toString() // -- Returns true/false. |
|
290 | + ); |
|
291 | + } |
|
292 | + else { |
|
293 | + return null; |
|
294 | + } |
|
295 | + |
|
296 | + } |
|
297 | + |
|
298 | + public function getGetMeetingsUrl() { |
|
299 | + /* Simply formulate the getMeetings URL |
|
300 | 300 | We do this in a separate function so we have the option to just get this |
301 | 301 | URL and print it if we want for some reason. |
302 | 302 | */ |
303 | - $getMeetingsUrl = $this->_bbbServerBaseUrl."api/getMeetings?checksum=".sha1("getMeetings".$this->_securitySalt); |
|
304 | - return $getMeetingsUrl; |
|
305 | - } |
|
303 | + $getMeetingsUrl = $this->_bbbServerBaseUrl."api/getMeetings?checksum=".sha1("getMeetings".$this->_securitySalt); |
|
304 | + return $getMeetingsUrl; |
|
305 | + } |
|
306 | 306 | |
307 | - public function getMeetingsWithXmlResponseArray() { |
|
308 | - /* USAGE: |
|
307 | + public function getMeetingsWithXmlResponseArray() { |
|
308 | + /* USAGE: |
|
309 | 309 | We don't need to pass any parameters with this one, so we just send the query URL off to BBB |
310 | 310 | and then handle the results that we get in the XML response. |
311 | 311 | */ |
312 | - $xml = $this->_processXmlResponse($this->getGetMeetingsUrl()); |
|
313 | - if($xml) { |
|
314 | - // If we don't get a success code, stop processing and return just the returncode: |
|
315 | - if ($xml->returncode != 'SUCCESS') { |
|
316 | - $result = array( |
|
317 | - 'returncode' => $xml->returncode->__toString() |
|
318 | - ); |
|
319 | - return $result; |
|
320 | - } |
|
321 | - elseif ($xml->messageKey == 'noMeetings') { |
|
322 | - /* No meetings on server, so return just this info: */ |
|
323 | - $result = array( |
|
324 | - 'returncode' => $xml->returncode->__toString(), |
|
325 | - 'messageKey' => $xml->messageKey->__toString(), |
|
326 | - 'message' => $xml->message->__toString() |
|
327 | - ); |
|
328 | - return $result; |
|
329 | - } |
|
330 | - else { |
|
331 | - // In this case, we have success and meetings. First return general response: |
|
332 | - $result = array( |
|
333 | - 'returncode' => $xml->returncode->__toString(), |
|
334 | - 'messageKey' => $xml->messageKey->__toString(), |
|
335 | - 'message' => $xml->message->__toString() |
|
336 | - ); |
|
337 | - // Then interate through meeting results and return them as part of the array: |
|
338 | - foreach ($xml->meetings->meeting as $m) { |
|
339 | - $result[] = array( |
|
340 | - 'meetingId' => $m->meetingID->__toString(), |
|
341 | - 'meetingName' => $m->meetingName->__toString(), |
|
342 | - 'createTime' => $m->createTime->__toString(), |
|
343 | - 'attendeePw' => $m->attendeePW->__toString(), |
|
344 | - 'moderatorPw' => $m->moderatorPW->__toString(), |
|
345 | - 'hasBeenForciblyEnded' => $m->hasBeenForciblyEnded->__toString(), |
|
346 | - 'running' => $m->running->__toString() |
|
347 | - ); |
|
348 | - } |
|
349 | - return $result; |
|
350 | - } |
|
351 | - } |
|
352 | - else { |
|
353 | - return null; |
|
354 | - } |
|
355 | - |
|
356 | - } |
|
357 | - |
|
358 | - public function getMeetingInfoUrl($infoParams) { |
|
359 | - /* USAGE: |
|
312 | + $xml = $this->_processXmlResponse($this->getGetMeetingsUrl()); |
|
313 | + if($xml) { |
|
314 | + // If we don't get a success code, stop processing and return just the returncode: |
|
315 | + if ($xml->returncode != 'SUCCESS') { |
|
316 | + $result = array( |
|
317 | + 'returncode' => $xml->returncode->__toString() |
|
318 | + ); |
|
319 | + return $result; |
|
320 | + } |
|
321 | + elseif ($xml->messageKey == 'noMeetings') { |
|
322 | + /* No meetings on server, so return just this info: */ |
|
323 | + $result = array( |
|
324 | + 'returncode' => $xml->returncode->__toString(), |
|
325 | + 'messageKey' => $xml->messageKey->__toString(), |
|
326 | + 'message' => $xml->message->__toString() |
|
327 | + ); |
|
328 | + return $result; |
|
329 | + } |
|
330 | + else { |
|
331 | + // In this case, we have success and meetings. First return general response: |
|
332 | + $result = array( |
|
333 | + 'returncode' => $xml->returncode->__toString(), |
|
334 | + 'messageKey' => $xml->messageKey->__toString(), |
|
335 | + 'message' => $xml->message->__toString() |
|
336 | + ); |
|
337 | + // Then interate through meeting results and return them as part of the array: |
|
338 | + foreach ($xml->meetings->meeting as $m) { |
|
339 | + $result[] = array( |
|
340 | + 'meetingId' => $m->meetingID->__toString(), |
|
341 | + 'meetingName' => $m->meetingName->__toString(), |
|
342 | + 'createTime' => $m->createTime->__toString(), |
|
343 | + 'attendeePw' => $m->attendeePW->__toString(), |
|
344 | + 'moderatorPw' => $m->moderatorPW->__toString(), |
|
345 | + 'hasBeenForciblyEnded' => $m->hasBeenForciblyEnded->__toString(), |
|
346 | + 'running' => $m->running->__toString() |
|
347 | + ); |
|
348 | + } |
|
349 | + return $result; |
|
350 | + } |
|
351 | + } |
|
352 | + else { |
|
353 | + return null; |
|
354 | + } |
|
355 | + |
|
356 | + } |
|
357 | + |
|
358 | + public function getMeetingInfoUrl($infoParams) { |
|
359 | + /* USAGE: |
|
360 | 360 | $infoParams = array( |
361 | 361 | 'meetingId' => '1234', -- REQUIRED - The unique id for the meeting |
362 | 362 | 'password' => 'mp' -- REQUIRED - The moderator password for the meeting |
363 | 363 | ); |
364 | 364 | */ |
365 | - $this->_meetingId = $this->_requiredParam($infoParams['meetingId']); |
|
366 | - $this->_password = $this->_requiredParam($infoParams['password']); |
|
367 | - $infoUrl = $this->_bbbServerBaseUrl."api/getMeetingInfo?"; |
|
368 | - $params = |
|
369 | - 'meetingID='.urlencode($this->_meetingId). |
|
370 | - '&password='.urlencode($this->_password); |
|
371 | - return ($infoUrl.$params.'&checksum='.sha1("getMeetingInfo".$params.$this->_securitySalt)); |
|
372 | - } |
|
373 | - |
|
374 | - public function getMeetingInfoWithXmlResponseArray($infoParams) { |
|
375 | - /* USAGE: |
|
365 | + $this->_meetingId = $this->_requiredParam($infoParams['meetingId']); |
|
366 | + $this->_password = $this->_requiredParam($infoParams['password']); |
|
367 | + $infoUrl = $this->_bbbServerBaseUrl."api/getMeetingInfo?"; |
|
368 | + $params = |
|
369 | + 'meetingID='.urlencode($this->_meetingId). |
|
370 | + '&password='.urlencode($this->_password); |
|
371 | + return ($infoUrl.$params.'&checksum='.sha1("getMeetingInfo".$params.$this->_securitySalt)); |
|
372 | + } |
|
373 | + |
|
374 | + public function getMeetingInfoWithXmlResponseArray($infoParams) { |
|
375 | + /* USAGE: |
|
376 | 376 | $infoParams = array( |
377 | 377 | 'meetingId' => '1234', -- REQUIRED - The unique id for the meeting |
378 | 378 | 'password' => 'mp' -- REQUIRED - The moderator password for the meeting |
379 | 379 | ); |
380 | 380 | */ |
381 | - $xml = $this->_processXmlResponse($this->getMeetingInfoUrl($infoParams)); |
|
382 | - if($xml) { |
|
383 | - // If we don't get a success code or messageKey, find out why: |
|
384 | - if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
|
385 | - $result = array( |
|
386 | - 'returncode' => $xml->returncode->__toString(), |
|
387 | - 'messageKey' => $xml->messageKey->__toString(), |
|
388 | - 'message' => $xml->message->__toString() |
|
389 | - ); |
|
390 | - return $result; |
|
391 | - } |
|
392 | - else { |
|
393 | - // In this case, we have success and meeting info: |
|
394 | - $result = array( |
|
395 | - 'returncode' => $xml->returncode->__toString(), |
|
396 | - 'meetingName' => $xml->meetingName->__toString(), |
|
397 | - 'meetingId' => $xml->meetingID->__toString(), |
|
398 | - 'createTime' => $xml->createTime->__toString(), |
|
399 | - 'voiceBridge' => $xml->voiceBridge->__toString(), |
|
400 | - 'attendeePw' => $xml->attendeePW->__toString(), |
|
401 | - 'moderatorPw' => $xml->moderatorPW->__toString(), |
|
402 | - 'running' => $xml->running->__toString(), |
|
403 | - 'recording' => $xml->recording->__toString(), |
|
404 | - 'hasBeenForciblyEnded' => $xml->hasBeenForciblyEnded->__toString(), |
|
405 | - 'startTime' => $xml->startTime->__toString(), |
|
406 | - 'endTime' => $xml->endTime->__toString(), |
|
407 | - 'participantCount' => $xml->participantCount->__toString(), |
|
408 | - 'maxUsers' => $xml->maxUsers->__toString(), |
|
409 | - 'moderatorCount' => $xml->moderatorCount->__toString(), |
|
410 | - ); |
|
411 | - // Then interate through attendee results and return them as part of the array: |
|
412 | - foreach ($xml->attendees->attendee as $a) { |
|
413 | - $result[] = array( |
|
414 | - 'userId' => $a->userID->__toString(), |
|
415 | - 'fullName' => $a->fullName->__toString(), |
|
416 | - 'role' => $a->role->__toString() |
|
417 | - ); |
|
418 | - } |
|
419 | - return $result; |
|
420 | - } |
|
421 | - } |
|
422 | - else { |
|
423 | - return null; |
|
424 | - } |
|
425 | - |
|
426 | - } |
|
427 | - |
|
428 | - /* __________________ BBB RECORDING METHODS _________________ */ |
|
429 | - /* The methods in the following section support the following categories of the BBB API: |
|
381 | + $xml = $this->_processXmlResponse($this->getMeetingInfoUrl($infoParams)); |
|
382 | + if($xml) { |
|
383 | + // If we don't get a success code or messageKey, find out why: |
|
384 | + if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
|
385 | + $result = array( |
|
386 | + 'returncode' => $xml->returncode->__toString(), |
|
387 | + 'messageKey' => $xml->messageKey->__toString(), |
|
388 | + 'message' => $xml->message->__toString() |
|
389 | + ); |
|
390 | + return $result; |
|
391 | + } |
|
392 | + else { |
|
393 | + // In this case, we have success and meeting info: |
|
394 | + $result = array( |
|
395 | + 'returncode' => $xml->returncode->__toString(), |
|
396 | + 'meetingName' => $xml->meetingName->__toString(), |
|
397 | + 'meetingId' => $xml->meetingID->__toString(), |
|
398 | + 'createTime' => $xml->createTime->__toString(), |
|
399 | + 'voiceBridge' => $xml->voiceBridge->__toString(), |
|
400 | + 'attendeePw' => $xml->attendeePW->__toString(), |
|
401 | + 'moderatorPw' => $xml->moderatorPW->__toString(), |
|
402 | + 'running' => $xml->running->__toString(), |
|
403 | + 'recording' => $xml->recording->__toString(), |
|
404 | + 'hasBeenForciblyEnded' => $xml->hasBeenForciblyEnded->__toString(), |
|
405 | + 'startTime' => $xml->startTime->__toString(), |
|
406 | + 'endTime' => $xml->endTime->__toString(), |
|
407 | + 'participantCount' => $xml->participantCount->__toString(), |
|
408 | + 'maxUsers' => $xml->maxUsers->__toString(), |
|
409 | + 'moderatorCount' => $xml->moderatorCount->__toString(), |
|
410 | + ); |
|
411 | + // Then interate through attendee results and return them as part of the array: |
|
412 | + foreach ($xml->attendees->attendee as $a) { |
|
413 | + $result[] = array( |
|
414 | + 'userId' => $a->userID->__toString(), |
|
415 | + 'fullName' => $a->fullName->__toString(), |
|
416 | + 'role' => $a->role->__toString() |
|
417 | + ); |
|
418 | + } |
|
419 | + return $result; |
|
420 | + } |
|
421 | + } |
|
422 | + else { |
|
423 | + return null; |
|
424 | + } |
|
425 | + |
|
426 | + } |
|
427 | + |
|
428 | + /* __________________ BBB RECORDING METHODS _________________ */ |
|
429 | + /* The methods in the following section support the following categories of the BBB API: |
|
430 | 430 | -- getRecordings |
431 | 431 | -- publishRecordings |
432 | 432 | -- deleteRecordings |
433 | 433 | */ |
434 | 434 | |
435 | - public function getRecordingsUrl($recordingParams) { |
|
436 | - /* USAGE: |
|
435 | + public function getRecordingsUrl($recordingParams) { |
|
436 | + /* USAGE: |
|
437 | 437 | $recordingParams = array( |
438 | 438 | 'meetingId' => '1234', -- OPTIONAL - comma separate if multiple ids |
439 | 439 | ); |
440 | 440 | */ |
441 | - $recordingsUrl = $this->_bbbServerBaseUrl."api/getRecordings?"; |
|
442 | - $params = 'meetingID='.urlencode($recordingParams['meetingId']); |
|
443 | - return ($recordingsUrl.$params.'&checksum='.sha1("getRecordings".$params.$this->_securitySalt)); |
|
441 | + $recordingsUrl = $this->_bbbServerBaseUrl."api/getRecordings?"; |
|
442 | + $params = 'meetingID='.urlencode($recordingParams['meetingId']); |
|
443 | + return ($recordingsUrl.$params.'&checksum='.sha1("getRecordings".$params.$this->_securitySalt)); |
|
444 | 444 | |
445 | - } |
|
445 | + } |
|
446 | 446 | |
447 | - public function getRecordingsWithXmlResponseArray($recordingParams) { |
|
448 | - /* USAGE: |
|
447 | + public function getRecordingsWithXmlResponseArray($recordingParams) { |
|
448 | + /* USAGE: |
|
449 | 449 | $recordingParams = array( |
450 | 450 | 'meetingId' => '1234', -- OPTIONAL - comma separate if multiple ids |
451 | 451 | ); |
@@ -453,121 +453,121 @@ discard block |
||
453 | 453 | when creating a meeting, it will kick users out after the duration. Should |
454 | 454 | probably be required in user code when 'recording' is set to true. |
455 | 455 | */ |
456 | - $xml = $this->_processXmlResponse($this->getRecordingsUrl($recordingParams)); |
|
457 | - if($xml) { |
|
458 | - // If we don't get a success code or messageKey, find out why: |
|
459 | - if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
|
460 | - $result = array( |
|
461 | - 'returncode' => $xml->returncode->__toString(), |
|
462 | - 'messageKey' => $xml->messageKey->__toString(), |
|
463 | - 'message' => $xml->message->__toString() |
|
464 | - ); |
|
465 | - return $result; |
|
466 | - } |
|
467 | - else { |
|
468 | - // In this case, we have success and recording info: |
|
469 | - $result = array( |
|
470 | - 'returncode' => $xml->returncode->__toString(), |
|
471 | - 'messageKey' => $xml->messageKey->__toString(), |
|
472 | - 'message' => $xml->message->__toString() |
|
473 | - ); |
|
474 | - |
|
475 | - foreach ($xml->recordings->recording as $r) { |
|
476 | - $result[] = array( |
|
477 | - 'recordId' => $r->recordID->__toString(), |
|
478 | - 'meetingId' => $r->meetingID->__toString(), |
|
479 | - 'name' => $r->name->__toString(), |
|
480 | - 'published' => $r->published->__toString(), |
|
481 | - 'startTime' => $r->startTime->__toString(), |
|
482 | - 'endTime' => $r->endTime->__toString(), |
|
483 | - 'playbackFormatType' => $r->playback->format->type->__toString(), |
|
484 | - 'playbackFormatUrl' => $r->playback->format->url->__toString(), |
|
485 | - 'playbackFormatLength' => $r->playback->format->length->__toString(), |
|
486 | - 'metadataTitle' => $r->metadata->title->__toString(), |
|
487 | - 'metadataSubject' => $r->metadata->subject->__toString(), |
|
488 | - 'metadataDescription' => $r->metadata->description->__toString(), |
|
489 | - 'metadataCreator' => $r->metadata->creator->__toString(), |
|
490 | - 'metadataContributor' => $r->metadata->contributor->__toString(), |
|
491 | - 'metadataLanguage' => $r->metadata->language->__toString(), |
|
492 | - // Add more here as needed for your app depending on your |
|
493 | - // use of metadata when creating recordings. |
|
494 | - ); |
|
495 | - } |
|
496 | - return $result; |
|
497 | - } |
|
498 | - } |
|
499 | - else { |
|
500 | - return null; |
|
501 | - } |
|
502 | - } |
|
503 | - |
|
504 | - public function getPublishRecordingsUrl($recordingParams) { |
|
505 | - /* USAGE: |
|
456 | + $xml = $this->_processXmlResponse($this->getRecordingsUrl($recordingParams)); |
|
457 | + if($xml) { |
|
458 | + // If we don't get a success code or messageKey, find out why: |
|
459 | + if (($xml->returncode != 'SUCCESS') || ($xml->messageKey == null)) { |
|
460 | + $result = array( |
|
461 | + 'returncode' => $xml->returncode->__toString(), |
|
462 | + 'messageKey' => $xml->messageKey->__toString(), |
|
463 | + 'message' => $xml->message->__toString() |
|
464 | + ); |
|
465 | + return $result; |
|
466 | + } |
|
467 | + else { |
|
468 | + // In this case, we have success and recording info: |
|
469 | + $result = array( |
|
470 | + 'returncode' => $xml->returncode->__toString(), |
|
471 | + 'messageKey' => $xml->messageKey->__toString(), |
|
472 | + 'message' => $xml->message->__toString() |
|
473 | + ); |
|
474 | + |
|
475 | + foreach ($xml->recordings->recording as $r) { |
|
476 | + $result[] = array( |
|
477 | + 'recordId' => $r->recordID->__toString(), |
|
478 | + 'meetingId' => $r->meetingID->__toString(), |
|
479 | + 'name' => $r->name->__toString(), |
|
480 | + 'published' => $r->published->__toString(), |
|
481 | + 'startTime' => $r->startTime->__toString(), |
|
482 | + 'endTime' => $r->endTime->__toString(), |
|
483 | + 'playbackFormatType' => $r->playback->format->type->__toString(), |
|
484 | + 'playbackFormatUrl' => $r->playback->format->url->__toString(), |
|
485 | + 'playbackFormatLength' => $r->playback->format->length->__toString(), |
|
486 | + 'metadataTitle' => $r->metadata->title->__toString(), |
|
487 | + 'metadataSubject' => $r->metadata->subject->__toString(), |
|
488 | + 'metadataDescription' => $r->metadata->description->__toString(), |
|
489 | + 'metadataCreator' => $r->metadata->creator->__toString(), |
|
490 | + 'metadataContributor' => $r->metadata->contributor->__toString(), |
|
491 | + 'metadataLanguage' => $r->metadata->language->__toString(), |
|
492 | + // Add more here as needed for your app depending on your |
|
493 | + // use of metadata when creating recordings. |
|
494 | + ); |
|
495 | + } |
|
496 | + return $result; |
|
497 | + } |
|
498 | + } |
|
499 | + else { |
|
500 | + return null; |
|
501 | + } |
|
502 | + } |
|
503 | + |
|
504 | + public function getPublishRecordingsUrl($recordingParams) { |
|
505 | + /* USAGE: |
|
506 | 506 | $recordingParams = array( |
507 | 507 | 'recordId' => '1234', -- REQUIRED - comma separate if multiple ids |
508 | 508 | 'publish' => 'true', -- REQUIRED - boolean: true/false |
509 | 509 | ); |
510 | 510 | */ |
511 | - $recordingsUrl = $this->_bbbServerBaseUrl."api/publishRecordings?"; |
|
512 | - $params = |
|
513 | - 'recordID='.urlencode($recordingParams['recordId']). |
|
514 | - '&publish='.urlencode($recordingParams['publish']); |
|
515 | - return ($recordingsUrl.$params.'&checksum='.sha1("publishRecordings".$params.$this->_securitySalt)); |
|
511 | + $recordingsUrl = $this->_bbbServerBaseUrl."api/publishRecordings?"; |
|
512 | + $params = |
|
513 | + 'recordID='.urlencode($recordingParams['recordId']). |
|
514 | + '&publish='.urlencode($recordingParams['publish']); |
|
515 | + return ($recordingsUrl.$params.'&checksum='.sha1("publishRecordings".$params.$this->_securitySalt)); |
|
516 | 516 | |
517 | - } |
|
517 | + } |
|
518 | 518 | |
519 | - public function publishRecordingsWithXmlResponseArray($recordingParams) { |
|
520 | - /* USAGE: |
|
519 | + public function publishRecordingsWithXmlResponseArray($recordingParams) { |
|
520 | + /* USAGE: |
|
521 | 521 | $recordingParams = array( |
522 | 522 | 'recordId' => '1234', -- REQUIRED - comma separate if multiple ids |
523 | 523 | 'publish' => 'true', -- REQUIRED - boolean: true/false |
524 | 524 | ); |
525 | 525 | */ |
526 | - $xml = $this->_processXmlResponse($this->getPublishRecordingsUrl($recordingParams)); |
|
527 | - if($xml) { |
|
528 | - return array( |
|
529 | - 'returncode' => $xml->returncode->__toString(), |
|
530 | - 'published' => $xml->published->__toString() // -- Returns true/false. |
|
531 | - ); |
|
532 | - } |
|
533 | - else { |
|
534 | - return null; |
|
535 | - } |
|
536 | - |
|
537 | - |
|
538 | - } |
|
539 | - |
|
540 | - public function getDeleteRecordingsUrl($recordingParams) { |
|
541 | - /* USAGE: |
|
526 | + $xml = $this->_processXmlResponse($this->getPublishRecordingsUrl($recordingParams)); |
|
527 | + if($xml) { |
|
528 | + return array( |
|
529 | + 'returncode' => $xml->returncode->__toString(), |
|
530 | + 'published' => $xml->published->__toString() // -- Returns true/false. |
|
531 | + ); |
|
532 | + } |
|
533 | + else { |
|
534 | + return null; |
|
535 | + } |
|
536 | + |
|
537 | + |
|
538 | + } |
|
539 | + |
|
540 | + public function getDeleteRecordingsUrl($recordingParams) { |
|
541 | + /* USAGE: |
|
542 | 542 | $recordingParams = array( |
543 | 543 | 'recordId' => '1234', -- REQUIRED - comma separate if multiple ids |
544 | 544 | ); |
545 | 545 | */ |
546 | - $recordingsUrl = $this->_bbbServerBaseUrl."api/deleteRecordings?"; |
|
547 | - $params = |
|
548 | - 'recordID='.urlencode($recordingParams['recordId']); |
|
549 | - return ($recordingsUrl.$params.'&checksum='.sha1("deleteRecordings".$params.$this->_securitySalt)); |
|
550 | - } |
|
551 | - |
|
552 | - public function deleteRecordingsWithXmlResponseArray($recordingParams) { |
|
553 | - /* USAGE: |
|
546 | + $recordingsUrl = $this->_bbbServerBaseUrl."api/deleteRecordings?"; |
|
547 | + $params = |
|
548 | + 'recordID='.urlencode($recordingParams['recordId']); |
|
549 | + return ($recordingsUrl.$params.'&checksum='.sha1("deleteRecordings".$params.$this->_securitySalt)); |
|
550 | + } |
|
551 | + |
|
552 | + public function deleteRecordingsWithXmlResponseArray($recordingParams) { |
|
553 | + /* USAGE: |
|
554 | 554 | $recordingParams = array( |
555 | 555 | 'recordId' => '1234', -- REQUIRED - comma separate if multiple ids |
556 | 556 | ); |
557 | 557 | */ |
558 | 558 | |
559 | - $xml = $this->_processXmlResponse($this->getDeleteRecordingsUrl($recordingParams)); |
|
560 | - if($xml) { |
|
561 | - return array( |
|
562 | - 'returncode' => $xml->returncode->__toString(), |
|
563 | - 'deleted' => $xml->deleted->__toString() // -- Returns true/false. |
|
564 | - ); |
|
565 | - } |
|
566 | - else { |
|
567 | - return null; |
|
568 | - } |
|
569 | - |
|
570 | - } |
|
559 | + $xml = $this->_processXmlResponse($this->getDeleteRecordingsUrl($recordingParams)); |
|
560 | + if($xml) { |
|
561 | + return array( |
|
562 | + 'returncode' => $xml->returncode->__toString(), |
|
563 | + 'deleted' => $xml->deleted->__toString() // -- Returns true/false. |
|
564 | + ); |
|
565 | + } |
|
566 | + else { |
|
567 | + return null; |
|
568 | + } |
|
569 | + |
|
570 | + } |
|
571 | 571 | |
572 | 572 | |
573 | 573 |
@@ -324,6 +324,8 @@ |
||
324 | 324 | * @nvpStr is nvp string. |
325 | 325 | * returns an associtive array containing the response from the server. |
326 | 326 | * |
327 | + * @param string $methodName |
|
328 | + * @param string $nvpStr |
|
327 | 329 | */ |
328 | 330 | function hash_call($methodName, $nvpStr) |
329 | 331 | { |
@@ -111,8 +111,8 @@ discard block |
||
111 | 111 | * phoneNum: the phoneNum entered on the merchant's site |
112 | 112 | */ |
113 | 113 | function CallMarkExpressCheckout($paymentAmount, $currencyCodeType, $paymentType, $returnURL, |
114 | - $cancelURL, $shipToName, $shipToStreet, $shipToCity, $shipToState, |
|
115 | - $shipToCountryCode, $shipToZip, $shipToStreet2, $phoneNum |
|
114 | + $cancelURL, $shipToName, $shipToStreet, $shipToCity, $shipToState, |
|
115 | + $shipToCountryCode, $shipToZip, $shipToStreet2, $phoneNum |
|
116 | 116 | ) |
117 | 117 | { |
118 | 118 | // Construct the parameter string that describes the SetExpressCheckout API call in the shortcut implementation |
@@ -265,8 +265,8 @@ discard block |
||
265 | 265 | */ |
266 | 266 | |
267 | 267 | function DirectPayment($paymentType, $paymentAmount, $creditCardType, $creditCardNumber, |
268 | - $expDate, $cvv2, $firstName, $lastName, $street, $city, $state, $zip, |
|
269 | - $countryCode, $currencyCode) |
|
268 | + $expDate, $cvv2, $firstName, $lastName, $street, $city, $state, $zip, |
|
269 | + $countryCode, $currencyCode) |
|
270 | 270 | { |
271 | 271 | //Construct the parameter string that describes DoDirectPayment |
272 | 272 | $nvpstr = "&AMT=" . $paymentAmount; |
@@ -67,12 +67,12 @@ discard block |
||
67 | 67 | function CallShortcutExpressCheckout($paymentAmount, $currencyCodeType, $paymentType, $returnURL, $cancelURL, $extra) |
68 | 68 | { |
69 | 69 | // Construct the parameter string that describes the SetExpressCheckout API call in the shortcut implementation |
70 | - $nvpstr = "&PAYMENTREQUEST_0_AMT=" . $paymentAmount; |
|
71 | - $nvpstr .= "&PAYMENTREQUEST_0_ITEMAMT=" . $paymentAmount; |
|
72 | - $nvpstr .= "&PAYMENTREQUEST_0_PAYMENTACTION=" . $paymentType; |
|
73 | - $nvpstr .= "&RETURNURL=" . $returnURL; |
|
74 | - $nvpstr .= "&CANCELURL=" . $cancelURL; |
|
75 | - $nvpstr .= "&PAYMENTREQUEST_0_CURRENCYCODE=" . $currencyCodeType; |
|
70 | + $nvpstr = "&PAYMENTREQUEST_0_AMT=".$paymentAmount; |
|
71 | + $nvpstr .= "&PAYMENTREQUEST_0_ITEMAMT=".$paymentAmount; |
|
72 | + $nvpstr .= "&PAYMENTREQUEST_0_PAYMENTACTION=".$paymentType; |
|
73 | + $nvpstr .= "&RETURNURL=".$returnURL; |
|
74 | + $nvpstr .= "&CANCELURL=".$cancelURL; |
|
75 | + $nvpstr .= "&PAYMENTREQUEST_0_CURRENCYCODE=".$currencyCodeType; |
|
76 | 76 | $nvpstr .= $extra; |
77 | 77 | |
78 | 78 | $_SESSION["currencyCodeType"] = $currencyCodeType; |
@@ -116,20 +116,20 @@ discard block |
||
116 | 116 | ) |
117 | 117 | { |
118 | 118 | // Construct the parameter string that describes the SetExpressCheckout API call in the shortcut implementation |
119 | - $nvpstr = "&PAYMENTREQUEST_0_AMT=" . $paymentAmount; |
|
120 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_PAYMENTACTION=" . $paymentType; |
|
121 | - $nvpstr = $nvpstr . "&RETURNURL=" . $returnURL; |
|
122 | - $nvpstr = $nvpstr . "&CANCELURL=" . $cancelURL; |
|
123 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_CURRENCYCODE=" . $currencyCodeType; |
|
124 | - $nvpstr = $nvpstr . "&ADDROVERRIDE=1"; |
|
125 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTONAME=" . $shipToName; |
|
126 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOSTREET=" . $shipToStreet; |
|
127 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOSTREET2=" . $shipToStreet2; |
|
128 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOCITY=" . $shipToCity; |
|
129 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOSTATE=" . $shipToState; |
|
130 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOCOUNTRYCODE=" . $shipToCountryCode; |
|
131 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOZIP=" . $shipToZip; |
|
132 | - $nvpstr = $nvpstr . "&PAYMENTREQUEST_0_SHIPTOPHONENUM=" . $phoneNum; |
|
119 | + $nvpstr = "&PAYMENTREQUEST_0_AMT=".$paymentAmount; |
|
120 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_PAYMENTACTION=".$paymentType; |
|
121 | + $nvpstr = $nvpstr."&RETURNURL=".$returnURL; |
|
122 | + $nvpstr = $nvpstr."&CANCELURL=".$cancelURL; |
|
123 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_CURRENCYCODE=".$currencyCodeType; |
|
124 | + $nvpstr = $nvpstr."&ADDROVERRIDE=1"; |
|
125 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTONAME=".$shipToName; |
|
126 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOSTREET=".$shipToStreet; |
|
127 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOSTREET2=".$shipToStreet2; |
|
128 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOCITY=".$shipToCity; |
|
129 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOSTATE=".$shipToState; |
|
130 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOCOUNTRYCODE=".$shipToCountryCode; |
|
131 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOZIP=".$shipToZip; |
|
132 | + $nvpstr = $nvpstr."&PAYMENTREQUEST_0_SHIPTOPHONENUM=".$phoneNum; |
|
133 | 133 | |
134 | 134 | $_SESSION["currencyCodeType"] = $currencyCodeType; |
135 | 135 | $_SESSION["PaymentType"] = $paymentType; |
@@ -172,7 +172,7 @@ discard block |
||
172 | 172 | * Build a second API request to PayPal, using the token as the |
173 | 173 | * ID to get the details on the payment authorization |
174 | 174 | */ |
175 | - $nvpstr = "&TOKEN=" . $token; |
|
175 | + $nvpstr = "&TOKEN=".$token; |
|
176 | 176 | |
177 | 177 | /** |
178 | 178 | * Make the API call and store the results in an array. |
@@ -213,9 +213,9 @@ discard block |
||
213 | 213 | $payerID = urlencode($_SESSION['payer_id']); |
214 | 214 | $serverName = urlencode($_SERVER['SERVER_NAME']); |
215 | 215 | |
216 | - $nvpstr = '&TOKEN=' . $token . '&PAYERID=' . $payerID . '&PAYMENTREQUEST_0_PAYMENTACTION=' . $paymentType . '&PAYMENTREQUEST_0_AMT=' . $FinalPaymentAmt; |
|
217 | - $nvpstr .= '&PAYMENTREQUEST_0_CURRENCYCODE=' . $currencyCodeType . '&IPADDRESS=' . $serverName; |
|
218 | - $nvpstr = '&' . http_build_query([ |
|
216 | + $nvpstr = '&TOKEN='.$token.'&PAYERID='.$payerID.'&PAYMENTREQUEST_0_PAYMENTACTION='.$paymentType.'&PAYMENTREQUEST_0_AMT='.$FinalPaymentAmt; |
|
217 | + $nvpstr .= '&PAYMENTREQUEST_0_CURRENCYCODE='.$currencyCodeType.'&IPADDRESS='.$serverName; |
|
218 | + $nvpstr = '&'.http_build_query([ |
|
219 | 219 | 'TOKEN' => $token, |
220 | 220 | 'PAYERID' => $payerID, |
221 | 221 | 'PAYMENTACTION' => $paymentType, |
@@ -269,20 +269,20 @@ discard block |
||
269 | 269 | $countryCode, $currencyCode) |
270 | 270 | { |
271 | 271 | //Construct the parameter string that describes DoDirectPayment |
272 | - $nvpstr = "&AMT=" . $paymentAmount; |
|
273 | - $nvpstr = $nvpstr . "&CURRENCYCODE=" . $currencyCode; |
|
274 | - $nvpstr = $nvpstr . "&PAYMENTACTION=" . $paymentType; |
|
275 | - $nvpstr = $nvpstr . "&CREDITCARDTYPE=" . $creditCardType; |
|
276 | - $nvpstr = $nvpstr . "&ACCT=" . $creditCardNumber; |
|
277 | - $nvpstr = $nvpstr . "&EXPDATE=" . $expDate; |
|
278 | - $nvpstr = $nvpstr . "&CVV2=" . $cvv2; |
|
279 | - $nvpstr = $nvpstr . "&FIRSTNAME=" . $firstName; |
|
280 | - $nvpstr = $nvpstr . "&LASTNAME=" . $lastName; |
|
281 | - $nvpstr = $nvpstr . "&STREET=" . $street; |
|
282 | - $nvpstr = $nvpstr . "&CITY=" . $city; |
|
283 | - $nvpstr = $nvpstr . "&STATE=" . $state; |
|
284 | - $nvpstr = $nvpstr . "&COUNTRYCODE=" . $countryCode; |
|
285 | - $nvpstr = $nvpstr . "&IPADDRESS=" . $_SERVER['REMOTE_ADDR']; |
|
272 | + $nvpstr = "&AMT=".$paymentAmount; |
|
273 | + $nvpstr = $nvpstr."&CURRENCYCODE=".$currencyCode; |
|
274 | + $nvpstr = $nvpstr."&PAYMENTACTION=".$paymentType; |
|
275 | + $nvpstr = $nvpstr."&CREDITCARDTYPE=".$creditCardType; |
|
276 | + $nvpstr = $nvpstr."&ACCT=".$creditCardNumber; |
|
277 | + $nvpstr = $nvpstr."&EXPDATE=".$expDate; |
|
278 | + $nvpstr = $nvpstr."&CVV2=".$cvv2; |
|
279 | + $nvpstr = $nvpstr."&FIRSTNAME=".$firstName; |
|
280 | + $nvpstr = $nvpstr."&LASTNAME=".$lastName; |
|
281 | + $nvpstr = $nvpstr."&STREET=".$street; |
|
282 | + $nvpstr = $nvpstr."&CITY=".$city; |
|
283 | + $nvpstr = $nvpstr."&STATE=".$state; |
|
284 | + $nvpstr = $nvpstr."&COUNTRYCODE=".$countryCode; |
|
285 | + $nvpstr = $nvpstr."&IPADDRESS=".$_SERVER['REMOTE_ADDR']; |
|
286 | 286 | |
287 | 287 | $resArray = hash_call("DoDirectPayment", $nvpstr); |
288 | 288 | |
@@ -345,13 +345,13 @@ discard block |
||
345 | 345 | //if USE_PROXY constant set to TRUE in Constants.php, then only proxy will be enabled. |
346 | 346 | //Set proxy name to PROXY_HOST and port number to PROXY_PORT in constants.php |
347 | 347 | if ($USE_PROXY) { |
348 | - curl_setopt($ch, CURLOPT_PROXY, $PROXY_HOST . ":" . $PROXY_PORT); |
|
348 | + curl_setopt($ch, CURLOPT_PROXY, $PROXY_HOST.":".$PROXY_PORT); |
|
349 | 349 | } |
350 | 350 | |
351 | 351 | //NVPRequest for submitting to server |
352 | - $nvpreq = "METHOD=" . urlencode($methodName) . "&VERSION=" . urlencode($version) . |
|
353 | - "&PWD=" . urlencode($API_Password) . "&USER=" . urlencode($API_UserName) . |
|
354 | - "&SIGNATURE=" . urlencode($API_Signature) . $nvpStr . "&BUTTONSOURCE=" . urlencode($sBNCode); |
|
352 | + $nvpreq = "METHOD=".urlencode($methodName)."&VERSION=".urlencode($version). |
|
353 | + "&PWD=".urlencode($API_Password)."&USER=".urlencode($API_UserName). |
|
354 | + "&SIGNATURE=".urlencode($API_Signature).$nvpStr."&BUTTONSOURCE=".urlencode($sBNCode); |
|
355 | 355 | |
356 | 356 | //setting the nvpreq as POST FIELD to curl |
357 | 357 | curl_setopt($ch, CURLOPT_POSTFIELDS, $nvpreq); |
@@ -385,8 +385,8 @@ discard block |
||
385 | 385 | { |
386 | 386 | global $PAYPAL_URL; |
387 | 387 | // Redirect to paypal.com here |
388 | - $payPalURL = $PAYPAL_URL . $token; |
|
389 | - header("Location: " . $payPalURL); |
|
388 | + $payPalURL = $PAYPAL_URL.$token; |
|
389 | + header("Location: ".$payPalURL); |
|
390 | 390 | exit; |
391 | 391 | } |
392 | 392 |
@@ -14,7 +14,7 @@ |
||
14 | 14 | /** |
15 | 15 | * create (a singleton function that ensures ClockworksmsPlugin instance is |
16 | 16 | * created only once. If it is already created, it returns the instance) |
17 | - * @return object ClockworksmsPlugin instance |
|
17 | + * @return ClockworksmsPlugin ClockworksmsPlugin instance |
|
18 | 18 | */ |
19 | 19 | public static function create() |
20 | 20 | { |