--------------------------------------------------------------------------------
/osticket/doc/license.txt:
--------------------------------------------------------------------------------
1 | Apache License
2 | Version 2.0, January 2004
3 | http://www.apache.org/licenses/
4 |
5 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6 |
7 | 1. Definitions.
8 |
9 | "License" shall mean the terms and conditions for use, reproduction,
10 | and distribution as defined by Sections 1 through 9 of this document.
11 |
12 | "Licensor" shall mean the copyright owner or entity authorized by
13 | the copyright owner that is granting the License.
14 |
15 | "Legal Entity" shall mean the union of the acting entity and all
16 | other entities that control, are controlled by, or are under common
17 | control with that entity. For the purposes of this definition,
18 | "control" means (i) the power, direct or indirect, to cause the
19 | direction or management of such entity, whether by contract or
20 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
21 | outstanding shares, or (iii) beneficial ownership of such entity.
22 |
23 | "You" (or "Your") shall mean an individual or Legal Entity
24 | exercising permissions granted by this License.
25 |
26 | "Source" form shall mean the preferred form for making modifications,
27 | including but not limited to software source code, documentation
28 | source, and configuration files.
29 |
30 | "Object" form shall mean any form resulting from mechanical
31 | transformation or translation of a Source form, including but
32 | not limited to compiled object code, generated documentation,
33 | and conversions to other media types.
34 |
35 | "Work" shall mean the work of authorship, whether in Source or
36 | Object form, made available under the License, as indicated by a
37 | copyright notice that is included in or attached to the work
38 | (an example is provided in the Appendix below).
39 |
40 | "Derivative Works" shall mean any work, whether in Source or Object
41 | form, that is based on (or derived from) the Work and for which the
42 | editorial revisions, annotations, elaborations, or other modifications
43 | represent, as a whole, an original work of authorship. For the purposes
44 | of this License, Derivative Works shall not include works that remain
45 | separable from, or merely link (or bind by name) to the interfaces of,
46 | the Work and Derivative Works thereof.
47 |
48 | "Contribution" shall mean any work of authorship, including
49 | the original version of the Work and any modifications or additions
50 | to that Work or Derivative Works thereof, that is intentionally
51 | submitted to Licensor for inclusion in the Work by the copyright owner
52 | or by an individual or Legal Entity authorized to submit on behalf of
53 | the copyright owner. For the purposes of this definition, "submitted"
54 | means any form of electronic, verbal, or written communication sent
55 | to the Licensor or its representatives, including but not limited to
56 | communication on electronic mailing lists, source code control systems,
57 | and issue tracking systems that are managed by, or on behalf of, the
58 | Licensor for the purpose of discussing and improving the Work, but
59 | excluding communication that is conspicuously marked or otherwise
60 | designated in writing by the copyright owner as "Not a Contribution."
61 |
62 | "Contributor" shall mean Licensor and any individual or Legal Entity
63 | on behalf of whom a Contribution has been received by Licensor and
64 | subsequently incorporated within the Work.
65 |
66 | 2. Grant of Copyright License. Subject to the terms and conditions of
67 | this License, each Contributor hereby grants to You a perpetual,
68 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69 | copyright license to reproduce, prepare Derivative Works of,
70 | publicly display, publicly perform, sublicense, and distribute the
71 | Work and such Derivative Works in Source or Object form.
72 |
73 | 3. Grant of Patent License. Subject to the terms and conditions of
74 | this License, each Contributor hereby grants to You a perpetual,
75 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76 | (except as stated in this section) patent license to make, have made,
77 | use, offer to sell, sell, import, and otherwise transfer the Work,
78 | where such license applies only to those patent claims licensable
79 | by such Contributor that are necessarily infringed by their
80 | Contribution(s) alone or by combination of their Contribution(s)
81 | with the Work to which such Contribution(s) was submitted. If You
82 | institute patent litigation against any entity (including a
83 | cross-claim or counterclaim in a lawsuit) alleging that the Work
84 | or a Contribution incorporated within the Work constitutes direct
85 | or contributory patent infringement, then any patent licenses
86 | granted to You under this License for that Work shall terminate
87 | as of the date such litigation is filed.
88 |
89 | 4. Redistribution. You may reproduce and distribute copies of the
90 | Work or Derivative Works thereof in any medium, with or without
91 | modifications, and in Source or Object form, provided that You
92 | meet the following conditions:
93 |
94 | (a) You must give any other recipients of the Work or
95 | Derivative Works a copy of this License; and
96 |
97 | (b) You must cause any modified files to carry prominent notices
98 | stating that You changed the files; and
99 |
100 | (c) You must retain, in the Source form of any Derivative Works
101 | that You distribute, all copyright, patent, trademark, and
102 | attribution notices from the Source form of the Work,
103 | excluding those notices that do not pertain to any part of
104 | the Derivative Works; and
105 |
106 | (d) If the Work includes a "NOTICE" text file as part of its
107 | distribution, then any Derivative Works that You distribute must
108 | include a readable copy of the attribution notices contained
109 | within such NOTICE file, excluding those notices that do not
110 | pertain to any part of the Derivative Works, in at least one
111 | of the following places: within a NOTICE text file distributed
112 | as part of the Derivative Works; within the Source form or
113 | documentation, if provided along with the Derivative Works; or,
114 | within a display generated by the Derivative Works, if and
115 | wherever such third-party notices normally appear. The contents
116 | of the NOTICE file are for informational purposes only and
117 | do not modify the License. You may add Your own attribution
118 | notices within Derivative Works that You distribute, alongside
119 | or as an addendum to the NOTICE text from the Work, provided
120 | that such additional attribution notices cannot be construed
121 | as modifying the License.
122 |
123 | You may add Your own copyright statement to Your modifications and
124 | may provide additional or different license terms and conditions
125 | for use, reproduction, or distribution of Your modifications, or
126 | for any such Derivative Works as a whole, provided Your use,
127 | reproduction, and distribution of the Work otherwise complies with
128 | the conditions stated in this License.
129 |
130 | 5. Submission of Contributions. Unless You explicitly state otherwise,
131 | any Contribution intentionally submitted for inclusion in the Work
132 | by You to the Licensor shall be under the terms and conditions of
133 | this License, without any additional terms or conditions.
134 | Notwithstanding the above, nothing herein shall supersede or modify
135 | the terms of any separate license agreement you may have executed
136 | with Licensor regarding such Contributions.
137 |
138 | 6. Trademarks. This License does not grant permission to use the trade
139 | names, trademarks, service marks, or product names of the Licensor,
140 | except as required for reasonable and customary use in describing the
141 | origin of the Work and reproducing the content of the NOTICE file.
142 |
143 | 7. Disclaimer of Warranty. Unless required by applicable law or
144 | agreed to in writing, Licensor provides the Work (and each
145 | Contributor provides its Contributions) on an "AS IS" BASIS,
146 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 | implied, including, without limitation, any warranties or conditions
148 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 | PARTICULAR PURPOSE. You are solely responsible for determining the
150 | appropriateness of using or redistributing the Work and assume any
151 | risks associated with Your exercise of permissions under this License.
152 |
153 | 8. Limitation of Liability. In no event and under no legal theory,
154 | whether in tort (including negligence), contract, or otherwise,
155 | unless required by applicable law (such as deliberate and grossly
156 | negligent acts) or agreed to in writing, shall any Contributor be
157 | liable to You for damages, including any direct, indirect, special,
158 | incidental, or consequential damages of any character arising as a
159 | result of this License or out of the use or inability to use the
160 | Work (including but not limited to damages for loss of goodwill,
161 | work stoppage, computer failure or malfunction, or any and all
162 | other commercial damages or losses), even if such Contributor
163 | has been advised of the possibility of such damages.
164 |
165 | 9. Accepting Warranty or Additional Liability. While redistributing
166 | the Work or Derivative Works thereof, You may choose to offer,
167 | and charge a fee for, acceptance of support, warranty, indemnity,
168 | or other liability obligations and/or rights consistent with this
169 | License. However, in accepting such obligations, You may act only
170 | on Your own behalf and on Your sole responsibility, not on behalf
171 | of any other Contributor, and only if You agree to indemnify,
172 | defend, and hold each Contributor harmless for any liability
173 | incurred by, or claims asserted against, such Contributor by reason
174 | of your accepting any such warranty or additional liability.
175 |
176 | END OF TERMS AND CONDITIONS
177 |
178 | APPENDIX: How to apply the Apache License to your work.
179 |
180 | To apply the Apache License to your work, attach the following
181 | boilerplate notice, with the fields enclosed by brackets "[]"
182 | replaced with your own identifying information. (Don't include
183 | the brackets!) The text should be enclosed in the appropriate
184 | comment syntax for the file format. We also recommend that a
185 | file or class name and description of purpose be included on the
186 | same "printed page" as the copyright notice for easier
187 | identification within third-party archives.
188 |
189 | Copyright [yyyy] [name of copyright owner]
190 |
191 | Licensed under the Apache License, Version 2.0 (the "License");
192 | you may not use this file except in compliance with the License.
193 | You may obtain a copy of the License at
194 |
195 | http://www.apache.org/licenses/LICENSE-2.0
196 |
197 | Unless required by applicable law or agreed to in writing, software
198 | distributed under the License is distributed on an "AS IS" BASIS,
199 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 | See the License for the specific language governing permissions and
201 | limitations under the License.
--------------------------------------------------------------------------------
/osticket/bootstrap/bootstrap.php:
--------------------------------------------------------------------------------
1 | registerAutoload ();
19 |
20 | $dispatcher = erLhcoreClassChatEventDispatcher::getInstance();
21 |
22 | /**
23 | * We listen to all events, but check is done only in even method. This way we save 1 disk call for configuraiton file read.
24 | * */
25 |
26 | /**
27 | * User events
28 | */
29 | $dispatcher->listen('chat.close', array($this, 'chatClosed'));
30 | $dispatcher->listen('chat.chat_started', array($this, 'chatCreated'));
31 | $dispatcher->listen('chat.chat_offline_request', array($this, 'chatOfflineRequest'));
32 | }
33 |
34 | public function registerAutoload() {
35 | spl_autoload_register ( array (
36 | $this,
37 | 'autoload'
38 | ), true, false );
39 | }
40 |
41 | public function autoload($className) {
42 | $classesArray = array (
43 | 'erLhcoreClassOsTicketValidator' => 'extension/osticket/classes/erlhcoreclassosticketvalidator.php'
44 | );
45 |
46 | if (key_exists ( $className, $classesArray )) {
47 | include_once $classesArray [$className];
48 | }
49 | }
50 |
51 | public function getConfig()
52 | {
53 | if ($this->configData === false) {
54 | $osTicketOptions = erLhcoreClassModelChatConfig::fetch('osticket_options');
55 | $data = (array) $osTicketOptions->data;
56 | $this->configData = $data;
57 | }
58 | }
59 |
60 | public function sendRequest($data)
61 | {
62 | $this->getConfig();
63 |
64 | $ch = curl_init();
65 | curl_setopt($ch, CURLOPT_URL, $this->configData['host']);
66 | curl_setopt($ch, CURLOPT_POST, 1);
67 | curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
68 | curl_setopt($ch, CURLOPT_USERAGENT, 'osTicket API Client v1.7');
69 | curl_setopt($ch, CURLOPT_HEADER, FALSE);
70 | curl_setopt($ch, CURLOPT_HTTPHEADER, array(
71 | 'Expect:',
72 | 'X-API-Key: ' . $this->configData['api_key']
73 | ));
74 | curl_setopt($ch, CURLOPT_FOLLOWLOCATION, FALSE);
75 | curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
76 | $result = curl_exec($ch);
77 | $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
78 | curl_close($ch);
79 |
80 | if ($code != 201) {
81 | throw new Exception('Unable to create ticket: ' . $result);
82 | }
83 |
84 | $ticket_id = (int) $result;
85 |
86 | return $ticket_id;
87 | }
88 |
89 | public function getIssueUrl($issueId)
90 | {
91 | $this->getConfig();
92 | return str_replace('{osticketid}', $issueId, $this->configData['issueurl']);
93 | }
94 |
95 | public function fillDataByChat($chat)
96 | {
97 | $this->getConfig();
98 |
99 | $messages = array_reverse(erLhcoreClassModelmsg::getList(array(
100 | 'limit' => 5000,
101 | 'sort' => 'id DESC',
102 | 'filter' => array(
103 | 'chat_id' => $chat->id
104 | )
105 | )));
106 |
107 | $messagesContent = '';
108 | foreach ($messages as $msg) {
109 | if ($msg->user_id == - 1) {
110 | $messagesContent .= date(erLhcoreClassModule::$dateDateHourFormat, $msg->time) . ' ' . erTranslationClassLhTranslation::getInstance()->getTranslation('chat/syncadmin', 'System assistant') . ': ' . htmlspecialchars($msg->msg) . "\n";
111 | } else {
112 | $messagesContent .= date(erLhcoreClassModule::$dateDateHourFormat, $msg->time) . ' ' . ($msg->user_id == 0 ? htmlspecialchars($chat->nick) : htmlspecialchars($msg->name_support)) . ': ' . htmlspecialchars($msg->msg) . "\n";
113 | }
114 | }
115 |
116 | $data = array(
117 | 'name' => ((isset($this->configData['use_email']) && $this->configData['use_email'] == true && $chat->email != '') ? $chat->email : ((isset($this->configData['static_username']) && $this->configData['static_username'] != '') ? $this->configData['static_username'] : $chat->nick)),
118 | 'email' => $chat->email == '' ? ((isset($this->configData['static_email']) && $this->configData['static_email'] != '') ? $this->configData['static_email'] : 'no-email@' . $_SERVER['HTTP_HOST']) : $chat->email,
119 | 'subject' => str_replace(array(
120 | '{id}',
121 | '{department}',
122 | '{referrer}',
123 | '{nick}',
124 | '{phone}',
125 | '{email}',
126 | '{country_code}',
127 | '{country_name}',
128 | '{city}',
129 | '{user_tz_identifier}'
130 | ), array(
131 | (string)$chat->id,
132 | (string)$chat->department,
133 | $chat->referrer,
134 | $chat->nick,
135 | $chat->phone,
136 | $chat->email,
137 | $chat->country_code,
138 | $chat->country_name,
139 | $chat->city,
140 | $chat->user_tz_identifier
141 | ), $this->configData['subject']
142 | ),
143 | 'message' => 'data:text/html,' . nl2br(str_replace(array(
144 | '{department}',
145 | '{time_created_front}',
146 | '{additional_data}',
147 | '{id}',
148 | '{url}',
149 | '{referrer}',
150 | '{messages}',
151 | '{remarks}',
152 | '{nick}',
153 | '{email}',
154 | '{phone}',
155 | '{country_code}',
156 | '{country_name}',
157 | '{city}',
158 | '{user_tz_identifier}'
159 | ), array(
160 | (string)$chat->department,
161 | date(erLhcoreClassModule::$dateDateHourFormat,$chat->time),
162 | $chat->additional_data,
163 | $chat->id,
164 | (erLhcoreClassSystem::$httpsMode == true ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'] . erLhcoreClassDesign::baseurl('user/login') . '/(r)/' . rawurlencode(base64_encode('chat/single/' . $chat->id)),
165 | $chat->referrer,
166 | $messagesContent,
167 | $chat->remarks,
168 | $chat->nick,
169 | $chat->email,
170 | $chat->phone,
171 | $chat->country_code,
172 | $chat->country_name,
173 | $chat->city,
174 | $chat->user_tz_identifier
175 | ), $this->configData['message'])),
176 | 'ip' => $chat->ip
177 | );
178 |
179 | return $data;
180 | }
181 |
182 | public function chatCreated($params)
183 | {
184 | $this->getConfig();
185 |
186 | if (isset($this->configData['enabled']) && $this->configData['enabled'] == true && $this->configData['chat_create'] === true && ($this->configData['create_duplicate_issues'] == true || !isset($params['chat']->chat_variables_array['os_ticket_id'])) )
187 | {
188 | try {
189 | $data = $this->fillDataByChat($params['chat']);
190 | $ticketId = $this->sendRequest($data);
191 | $this->assignChatOsTicketId($params['chat'], $ticketId);
192 | } catch (Exception $e) {
193 | if ($this->configData['throw_exceptions'] == true) {
194 | throw $e;
195 | }
196 | }
197 | }
198 | }
199 |
200 | public function chatOfflineRequest($params)
201 | {
202 | $this->getConfig();
203 |
204 | if (isset($this->configData['enabled']) && $this->configData['enabled'] == true && $this->configData['offline_request'] === true)
205 | {
206 | $chat = $params['chat'];
207 | $inputData = $params['input_data'];
208 |
209 | $data = array(
210 | 'name' => $chat->nick,
211 | 'email' => $chat->email,
212 | 'subject' => str_replace(array(
213 | '{department}',
214 | '{referrer}',
215 | '{nick}',
216 | '{email}',
217 | '{phone}',
218 | '{country_code}',
219 | '{country_name}',
220 | '{city}',
221 | '{user_tz_identifier}'
222 | ), array(
223 | (string)$chat->department,
224 | $chat->referrer,
225 | $chat->nick,
226 | $chat->email,
227 | $chat->phone,
228 | $chat->country_code,
229 | $chat->country_name,
230 | $chat->city,
231 | $chat->user_tz_identifier
232 | ), $this->configData['subject']
233 | ),
234 | 'message' => str_replace(array(
235 | '{department}',
236 | '{time_created_front}',
237 | '{additional_data}',
238 | '{referrer}',
239 | '{message}',
240 | '{nick}',
241 | '{email}',
242 | '{phone}',
243 | '{country_code}',
244 | '{country_name}',
245 | '{city}',
246 | '{user_tz_identifier}'
247 | ), array(
248 | (string)$chat->department,
249 | date(erLhcoreClassModule::$dateDateHourFormat,time()),
250 | $chat->additional_data,
251 | (isset($_POST['URLRefer']) ? $_POST['URLRefer'] : ''),
252 | $inputData->question,
253 | $chat->nick,
254 | $chat->email,
255 | $chat->phone,
256 | $chat->country_code,
257 | $chat->country_name,
258 | $chat->city,
259 | $chat->user_tz_identifier
260 | ), $this->configData['message_offline']),
261 | 'ip' => $chat->ip
262 | );
263 |
264 | try {
265 | $ticketId = $this->sendRequest($data);
266 | } catch (Exception $e) {
267 | if ($this->configData['throw_exceptions'] == true) {
268 | throw $e;
269 | }
270 | }
271 | }
272 | }
273 |
274 |
275 | public function assignChatOsTicketId(erLhcoreClassModelChat & $chat, $ticketId)
276 | {
277 | /**
278 | * Remember created issue id
279 | * */
280 | $variablesArray = $chat->chat_variables_array;
281 | $variablesArray['os_ticket_id'] = $ticketId;
282 | $chat->chat_variables = json_encode($variablesArray);
283 | $chat->chat_variables_array = $variablesArray;
284 | $chat->updateThis();
285 | }
286 |
287 | public function createTicketByChat(erLhcoreClassModelChat & $chat)
288 | {
289 | $this->getConfig();
290 | if ((isset($this->configData['enabled']) && $this->configData['enabled'] == true) && ($this->configData['create_duplicate_issues'] === true || !isset($chat->chat_variables_array['os_ticket_id']))){
291 | $data = $this->fillDataByChat($chat);
292 | $ticketId = $this->sendRequest($data);
293 | $this->assignChatOsTicketId($chat, $ticketId);
294 | return $ticketId;
295 | } else {
296 | throw new Exception('Issue was already created');
297 | }
298 | }
299 |
300 | public function chatClosed($params)
301 | {
302 | $this->getConfig();
303 | if ((isset($this->configData['enabled']) && $this->configData['enabled'] == true) && $this->configData['chat_close'] === true && ($this->configData['create_duplicate_issues'] === true || !isset($params['chat']->chat_variables_array['os_ticket_id'])))
304 | {
305 | try {
306 | $data = $this->fillDataByChat($params['chat']);
307 | $ticketId = $this->sendRequest($data);
308 | $this->assignChatOsTicketId($params['chat'], $ticketId);
309 | } catch (Exception $e) {
310 | if ($this->configData['throw_exceptions'] == true) {
311 | throw $e;
312 | }
313 | }
314 | }
315 | }
316 | }
317 |
--------------------------------------------------------------------------------