Исходный код вики Для_разработчиков
Редактировал(а) Михаил Галич 26.11.2024, 12:16
Последние авторы
author | version | line-number | content |
---|---|---|---|
1 | {{toc depth="4"/}} | ||
2 | |||
3 | = Инструкция для подключения = | ||
4 | |||
5 | Назначение данного раздела — описать способы взаимодействия с виджетом Веб-платформы по задуманному вами сценарию. Типичный процесс подключения, открытия и отслеживания виджета выглядит так: | ||
6 | |||
7 | ~1. Подключите скрипт ##external.script.js## к вашему сайту. Его адрес будет доступен **после добавления сайта** в процессе настройки в **администраторской панели Веб-Платформы**, так же как и параметр ##id## для подключения | ||
8 | |||
9 | 2. Вставьте в необходимом месте на своём сайте код: | ||
10 | |||
11 | {{code language="html"}} | ||
12 | |||
13 | <script type="text/javascript"> | ||
14 | // инициализируем виджет с параметрами | ||
15 | WPInit({ | ||
16 | id: 1, | ||
17 | width: 400, | ||
18 | type: 'modal' | ||
19 | }) | ||
20 | |||
21 | // сразу откроем его для пользователя | ||
22 | WPOpenModal(); // вариант для модального окна | ||
23 | // WPOpen(); // вариант для открытия в теле страницы. Используется при инициализации виджета с type: 'instant' | ||
24 | |||
25 | // будем следить за состоянием виджета | ||
26 | WPChange = function(response) { | ||
27 | if (response.status == 'reserved') { | ||
28 | // если заказ зарезирвирован, занесём данные из response.data.order_id себе на сайт | ||
29 | } | ||
30 | if (response.status == 'completed') { | ||
31 | // если заказ оплачен, занесём данные из response.data.order_id себе на сайт | ||
32 | } | ||
33 | } | ||
34 | </script> | ||
35 | |||
36 | {{/code}} | ||
37 | |||
38 | = Функции = | ||
39 | |||
40 | == WPInit == | ||
41 | |||
42 | (% class="box infomessage" %) | ||
43 | ((( | ||
44 | Функция загрузки виджета с параметризацией, при создании необходимо передать**## id ##**виджета, который можно найти в Административной панели | ||
45 | ))) | ||
46 | |||
47 | ===== Минимальный способ инициализации: ===== | ||
48 | |||
49 | {{code language="javascript"}} | ||
50 | WPInit({ id: 1 }) | ||
51 | {{/code}} | ||
52 | |||
53 | ===== Пример передаваемых данных: ===== | ||
54 | |||
55 | (% class="box infomessage" %) | ||
56 | ((( | ||
57 | Виджет можно инициализировать с различными параметрами, все из них опциональные, кроме **##id##**. | ||
58 | ))) | ||
59 | |||
60 | {{code language="javascript"}} | ||
61 | WPInit({ | ||
62 | id: 1, | ||
63 | width: 400, | ||
64 | height: 600, | ||
65 | type: 'modal' | ||
66 | }) | ||
67 | {{/code}} | ||
68 | |||
69 | == WPOpen == | ||
70 | |||
71 | (% class="box infomessage" %) | ||
72 | ((( | ||
73 | Функция открытия виджета в каком-либо блоке, используется при инициализации виджета с## **type: 'instant'**## | ||
74 | ))) | ||
75 | |||
76 | ===== Пример передаваемых данных: ===== | ||
77 | |||
78 | {{code language="javascript"}} | ||
79 | // показ виджета с группой id 5 | ||
80 | WPOpen({ | ||
81 | groupid: [5] | ||
82 | }) | ||
83 | {{/code}} | ||
84 | |||
85 | == WPOpenModal == | ||
86 | |||
87 | (% class="box infomessage" %) | ||
88 | ((( | ||
89 | Функция открытия виджета в модальном окне, используется при инициализации виджета с## **type: 'modal'**## | ||
90 | ))) | ||
91 | |||
92 | ===== Пример передаваемых данных: ===== | ||
93 | |||
94 | {{code language="javascript"}} | ||
95 | // показ виджета на нажатие кнопки с id "OpenButton" | ||
96 | var OpenButton = document.getElementById('OpenButton'); | ||
97 | OpenButton.onclick = function () { | ||
98 | WPOpenModal({ tariffsid: [27, 28] }); | ||
99 | }; | ||
100 | {{/code}} | ||
101 | |||
102 | == WPChange == | ||
103 | |||
104 | (% class="box infomessage" %) | ||
105 | ((( | ||
106 | Функция, которая вызывается каждый раз при изменении состояния виджета. | ||
107 | Каждый раз передаёт в переменной response состояние в **##status##** и опционально данные в **##data##**. | ||
108 | При переопределении этой функции у себя на странице, администратор может следить за состоянием виджета и статусом заказа из javascript | ||
109 | ))) | ||
110 | |||
111 | ===== Примеры передаваемых данных: ===== | ||
112 | |||
113 | - ##{ status:'starting' }## — виджет в процессе запуска, в этот момент определяется, что он должен в данный момент отображать | ||
114 | - ##{ status:'started' }## — виджет на начальном экране, где показывается список услуг для покупки | ||
115 | - ##{ status:'reserved', data: { order_id: 2 } }## — виджет находится на стадии забронированного заказ, в data передаётся id | ||
116 | - ##{ status:'completed', data: { order_id: 2 } }## — виджет находится на стадии оплаченного заказ, в data передаётся id заказа | ||
117 | |||
118 | ===== Пример работы с данными: ===== | ||
119 | |||
120 | {{code language="javascript"}} | ||
121 | WPChange = function(response) { | ||
122 | if (response.status == 'starting') { | ||
123 | // действие на внешней странице | ||
124 | } | ||
125 | if (response.status == 'started') { | ||
126 | // действие на внешней странице | ||
127 | } | ||
128 | if (response.status == 'reserved') { | ||
129 | // id зарезервированного заказа: response.data.order_id | ||
130 | } | ||
131 | if (response.status == 'completed') { | ||
132 | // id оплаченного заказа: response.data.order_id | ||
133 | } | ||
134 | } | ||
135 | {{/code}} | ||
136 | |||
137 | = Параметры = | ||
138 | |||
139 | == Обязательные параметры WPInit == | ||
140 | |||
141 | ==== id ==== | ||
142 | |||
143 | Тип данных:## //number//## | ||
144 | |||
145 | (% class="box infomessage" %) | ||
146 | ((( | ||
147 | id виджета, который можно узнать в Административной панели. | ||
148 | ))) | ||
149 | |||
150 | == Возможные параметры WPInit == | ||
151 | |||
152 | ==== height ==== | ||
153 | |||
154 | Тип данных:## //number//## | ||
155 | |||
156 | (% class="box infomessage" %) | ||
157 | ((( | ||
158 | Высота виджета в пикселях, по умолчанию: | ||
159 | • 480px, если виджет запущен как type: 'modal' | ||
160 | • 100%, если виджет запущен как type: 'instant' | ||
161 | ))) | ||
162 | |||
163 | ==== width ==== | ||
164 | |||
165 | Тип данных:## //number//## | ||
166 | |||
167 | (% class="box infomessage" %) | ||
168 | ((( | ||
169 | Ширина виджета в пикселях, по умолчанию: | ||
170 | • 640px, если виджет запущен как type: 'modal' | ||
171 | • 100%, если виджет запущен как type: 'instant' | ||
172 | ))) | ||
173 | |||
174 | ==== type ==== | ||
175 | |||
176 | Тип данных:## //string//## | ||
177 | |||
178 | По умолчанию:##// 'instant'//## | ||
179 | |||
180 | (% class="box infomessage" %) | ||
181 | ((( | ||
182 | Способ открытия виджета | ||
183 | • 'instant' Открытие виджета на месте, где был вызов виджета (на месте тэга script), либо в блоке place, если он указан в параметрах виджета при инициализации | ||
184 | • 'modal' Открытие виджета в модальном окне | ||
185 | ))) | ||
186 | |||
187 | ==== place ==== | ||
188 | |||
189 | Тип данных:## //string//## | ||
190 | |||
191 | (% class="box infomessage" %) | ||
192 | ((( | ||
193 | Идентификатор элемента DOM, в который необходимо поместить виджет, например: **###widget##**. Используется совместно с **##type: 'instant'##** | ||
194 | ))) | ||
195 | |||
196 | (% class="box warningmessage" %) | ||
197 | ((( | ||
198 | **Важно:** элемент DOM для place должен быть либо на странице до вставки инициализации виджета (WPInit), либо инициализация виджета должна быть исполнена после загрузки DOM (например, обёрнута в событие $(document).ready(function(){}) в jQuery) | ||
199 | ))) | ||
200 | |||
201 | ---- | ||
202 | |||
203 | == Возможные параметры WPOpen и WPOpenModal == | ||
204 | |||
205 | === Инструкторские занятия === | ||
206 | |||
207 | ==== categories ==== | ||
208 | |||
209 | Тип данных:##// Array<string>//## | ||
210 | |||
211 | По умолчанию:##// []//## | ||
212 | |||
213 | (% class="box infomessage" %) | ||
214 | ((( | ||
215 | Фильтр категорий инструкторских занятий. Скрывает категории в выпадающем списке, **##id##** которых не совпадают заданными в массиве. | ||
216 | ))) | ||
217 | |||
218 | [[image:1703065952567-753.png]] | ||
219 | |||
220 | ==== coachid ==== | ||
221 | |||
222 | Тип данных:##// number//## | ||
223 | |||
224 | По умолчанию:##// undefined//## | ||
225 | |||
226 | (% class="box infomessage" %) | ||
227 | ((( | ||
228 | Идентификатор тренера, позволяет сепарировать список занятий по тренеру | ||
229 | ))) | ||
230 | |||
231 | ==== grouplessonsskillstariffs **##*##** ==== | ||
232 | |||
233 | Тип данных:##// object//## | ||
234 | |||
235 | По умолчанию:##// {}//## | ||
236 | |||
237 | (% class="box infomessage" %) | ||
238 | ((( | ||
239 | Ограничивает список тарифов (в фильтре) при выборе конкретной дисциплины групповых занятий. | ||
240 | Принимает объект, внутри которого указываются пары ключ/значение по выражению: {skillid}: [{tariffid},...] | ||
241 | ))) | ||
242 | |||
243 | Пример: | ||
244 | |||
245 | {{code language="javascript"}} | ||
246 | grouplessonsskillstariffs: { | ||
247 | "1": [ 15, 23] // При выборе дисциплины с id 1 - отображать тарифы с id 15 и 23 | ||
248 | } | ||
249 | {{/code}} | ||
250 | |||
251 | ==== grouplessonstariffsid ==== | ||
252 | |||
253 | Тип данных:##// Array<number>//## | ||
254 | |||
255 | По умолчанию:##// []//## | ||
256 | |||
257 | (% class="box infomessage" %) | ||
258 | ((( | ||
259 | Фильтр программ обучения для групповых занятий | ||
260 | ))) | ||
261 | |||
262 | [[image:1703065356750-663.png]] | ||
263 | |||
264 | Пример: | ||
265 | |||
266 | {{code language="javascript"}} | ||
267 | grouplessonstariffsid: [1823, 1900] // скрыть групповые программы обучения, кроме 1823 и 1900 | ||
268 | {{/code}} | ||
269 | |||
270 | ==== lessonslocation **##*##** ==== | ||
271 | |||
272 | Тип данных:##// number//## | ||
273 | |||
274 | По умолчанию:##// undefined//## | ||
275 | |||
276 | (% class="box infomessage" %) | ||
277 | ((( | ||
278 | Отображение места занятия для индивидуальных, групповых и многодневных занятий | ||
279 | ))) | ||
280 | |||
281 | [[image:1702560957244-690.png]] | ||
282 | |||
283 | ==== lessonstariffsid ==== | ||
284 | |||
285 | Тип данных:##// Array<number>//## | ||
286 | |||
287 | По умолчанию:##// []//## | ||
288 | |||
289 | (% class="box infomessage" %) | ||
290 | ((( | ||
291 | Ограничить видимость доступных тарифов в выпадающем списке программ обучения по массиву с их идентификаторами | ||
292 | ))) | ||
293 | |||
294 | [[image:1702641274330-465.png]] | ||
295 | |||
296 | ==== multidayslessonsskillstariffs **##*##** ==== | ||
297 | |||
298 | Тип данных:##// Array<number> //##//|## object##// | ||
299 | |||
300 | По умолчанию:##// []//## | ||
301 | |||
302 | (% class="box infomessage" %) | ||
303 | ((( | ||
304 | Производит фильтрацию тарифов для многодневных занятий. Принимает массив идентификаторов. | ||
305 | Параметр дополняет фильтрацию по параметру **##grouplessonsskillstariffs##**. | ||
306 | ))) | ||
307 | |||
308 | ==== nocategories **##*##** ==== | ||
309 | |||
310 | Тип данных:##// boolean//## | ||
311 | |||
312 | По умолчанию:##// false//## | ||
313 | |||
314 | (% class="box infomessage" %) | ||
315 | ((( | ||
316 | Если **##true##** скрывает фильтр по категории инструкторских занятий | ||
317 | ))) | ||
318 | |||
319 | [[image:1702638427440-675.png]] | ||
320 | |||
321 | ==== nocoach **##*##** ==== | ||
322 | |||
323 | Тип данных:##// boolean//## | ||
324 | |||
325 | По умолчанию:##// false//## | ||
326 | |||
327 | (% class="box infomessage" %) | ||
328 | ((( | ||
329 | Если **##true##** скрывает выпадающее меню выбора инструктора | ||
330 | ))) | ||
331 | |||
332 | [[image:1702638265778-588.png]] | ||
333 | |||
334 | ==== nolocation **##*##** ==== | ||
335 | |||
336 | Тип данных:##// boolean//## | ||
337 | |||
338 | По умолчанию:##// false//## | ||
339 | |||
340 | (% class="box infomessage" %) | ||
341 | ((( | ||
342 | Если **##true##** скрывает фильтр по месту проведения инструкторских занятий | ||
343 | ))) | ||
344 | |||
345 | [[image:1702638034420-756.png]] | ||
346 | |||
347 | ==== noskills **##*##** ==== | ||
348 | |||
349 | Тип данных:##// boolean//## | ||
350 | |||
351 | По умолчанию:##// false//## | ||
352 | |||
353 | (% class="box infomessage" %) | ||
354 | ((( | ||
355 | Если **##true##** скрывает фильтр по дисциплине инструкторских занятий | ||
356 | ))) | ||
357 | |||
358 | [[image:1702638705750-678.png]] | ||
359 | |||
360 | ==== notagfilter **##*##** ==== | ||
361 | |||
362 | Тип данных:##// boolean//## | ||
363 | |||
364 | По умолчанию:##// false//## | ||
365 | |||
366 | (% class="box infomessage" %) | ||
367 | ((( | ||
368 | Если **##true##** скрывает фильтр по тэгам | ||
369 | ))) | ||
370 | |||
371 | [[image:1732612477973-413.png]] | ||
372 | |||
373 | |||
374 | ==== notariffs ==== | ||
375 | |||
376 | Тип данных:##// boolean//## | ||
377 | |||
378 | По умолчанию:##// false//## | ||
379 | |||
380 | (% class="box infomessage" %) | ||
381 | ((( | ||
382 | Если **##true##** скрывает фильтр по программе обучения инструкторских занятий | ||
383 | ))) | ||
384 | |||
385 | [[image:1703063138160-208.png]] | ||
386 | |||
387 | ==== personallessonsskillstariffs **##*##** ==== | ||
388 | |||
389 | Тип данных:##// object//## | ||
390 | |||
391 | По умолчанию:##// {}//## | ||
392 | |||
393 | (% class="box infomessage" %) | ||
394 | ((( | ||
395 | Ограничивает список тарифов (в фильтре) при выборе конкретной дисциплины. | ||
396 | Принимает объект, внутри которого указываются пары ключ/значение по выражению: {skillid}: [{tariffid},...] | ||
397 | ))) | ||
398 | |||
399 | Пример: | ||
400 | |||
401 | {{code language="javascript"}} | ||
402 | personallessonsskillstariffs: { | ||
403 | "1": [ 15, 23] // При выборе дисциплины с id 1 - отображать тарифы с id 15 и 23 | ||
404 | } | ||
405 | {{/code}} | ||
406 | |||
407 | ==== placeid **##*##** ==== | ||
408 | |||
409 | Тип данных:##// number//## | ||
410 | |||
411 | По умолчанию:##// undefined//## | ||
412 | |||
413 | (% class="box infomessage" %) | ||
414 | ((( | ||
415 | Идентификатор места, использующийся для получения списка инструкторов. | ||
416 | ))) | ||
417 | |||
418 | ==== singleguest **##*##** ==== | ||
419 | |||
420 | Тип данных:##// Boolean//## | ||
421 | |||
422 | По умолчанию:##// false//## | ||
423 | |||
424 | (% class="box infomessage" %) | ||
425 | ((( | ||
426 | Если **##true##**, то при выборе занятия препятствует выбору 2 гостей. | ||
427 | ))) | ||
428 | |||
429 | [[image:1710854841918-858.png]] | ||
430 | |||
431 | ==== skills **##*##** ==== | ||
432 | |||
433 | Тип данных:##// Array<number>//## | ||
434 | |||
435 | По умолчанию:##// []//## | ||
436 | |||
437 | (% class="box infomessage" %) | ||
438 | ((( | ||
439 | Ограничить видимость доступных к выбору дисциплин по идентификатору | ||
440 | ))) | ||
441 | |||
442 | [[image:1702639385677-964.png]] | ||
443 | |||
444 | === Календарь и даты === | ||
445 | |||
446 | ==== disableddates ==== | ||
447 | |||
448 | Тип данных:##// Array<string>//## | ||
449 | |||
450 | По умолчанию:##// []//## | ||
451 | |||
452 | (% class="box infomessage" %) | ||
453 | ((( | ||
454 | Параметр отключения дат в календаре (и в //покупке// и в //пополнении//). Делает невозможным выбор определённых дней в массиве дат. | ||
455 | ))) | ||
456 | |||
457 | Пример: | ||
458 | |||
459 | {{code language="javascript"}} | ||
460 | disableddates: ['23.02.2018', '08.03.2018'] // уберёт даты 23.02.2018 и 08.03.2018 из возможных для выбора дат в календаре. | ||
461 | {{/code}} | ||
462 | |||
463 | ==== disableddays **##*##** ==== | ||
464 | |||
465 | Тип данных:##// Array<number>//## | ||
466 | |||
467 | По умолчанию:##// []//## | ||
468 | |||
469 | (% class="box infomessage" %) | ||
470 | ((( | ||
471 | Параметры открлючения дней недели в календаре (и в покупке и в пополнении), где 0 - воскресенье, 1 - понедельник и так далее. | ||
472 | ))) | ||
473 | |||
474 | ==== forcedate ==== | ||
475 | |||
476 | Тип данных:##// string//## | ||
477 | |||
478 | По умолчанию:##// undefined//## | ||
479 | |||
480 | (% class="box infomessage" %) | ||
481 | ((( | ||
482 | Параметр для открывания виджета с указанной сразу датой (и в //покупке// и в //пополнении//). | ||
483 | **##forcedate: '20.05.2018'##** покажет услуги к продаже на дату 20.05.2018. | ||
484 | ))) | ||
485 | |||
486 | ==== maxdate ==== | ||
487 | |||
488 | Тип данных:##// string//## | ||
489 | |||
490 | По умолчанию:##// undefined//## | ||
491 | |||
492 | (% class="box infomessage" %) | ||
493 | ((( | ||
494 | Параметр максимальной отображаемой даты в календаре (и в //покупке// и в //пополнении//). | ||
495 | **##maxdate: '20.05.2018'##** покажет 20.05.2018 как самую последнюю дату, доступную к выбору в календаре. | ||
496 | ))) | ||
497 | |||
498 | ==== mindate ==== | ||
499 | |||
500 | Тип данных:##// string//## | ||
501 | |||
502 | По умолчанию:##// undefined//## | ||
503 | |||
504 | (% class="box infomessage" %) | ||
505 | ((( | ||
506 | Параметр минимальной отображаемой даты в календаре (и в //покупке// и в //пополнении//). | ||
507 | **##mindate: '20.05.2018'##** покажет 20.05.2018 как самую первую дату, доступную к выбору в календаре, если она находится после текущего дня. | ||
508 | ))) | ||
509 | |||
510 | ==== nocalendar ==== | ||
511 | |||
512 | Тип данных:## //boolean//## | ||
513 | |||
514 | По умолчанию:##// false//## | ||
515 | |||
516 | (% class="box infomessage" %) | ||
517 | ((( | ||
518 | Убирает календарь внутри виджета (и в //покупке// и в //пополнении//), в случаях, когда дата, на которую покупается/пополняется билет, не важна. | ||
519 | ))) | ||
520 | |||
521 | ==== saledepth **##*##** ==== | ||
522 | |||
523 | Тип данных:## //number//## | ||
524 | |||
525 | По умолчанию:##// undefined//## | ||
526 | |||
527 | (% class="box infomessage" %) | ||
528 | ((( | ||
529 | Ограничивает глубину продаж начиная с сегодняшнего дня. Таким образом если ##saledepth: 1##, то доступные даты в календаре выбора тарифа будут __**сегодня **__и __**завтра**__. | ||
530 | ⚠ Имеет больший приоритет, чем ##maxdate## | ||
531 | ))) | ||
532 | |||
533 | ---- | ||
534 | |||
535 | === Отображение === | ||
536 | |||
537 | ==== cartmaxitems **##*##** ==== | ||
538 | |||
539 | Тип данных:##// number//## | ||
540 | |||
541 | По умолчанию:##// 6//## | ||
542 | |||
543 | (% class="box infomessage" %) | ||
544 | ((( | ||
545 | Ограничивает максимальное кол-во товаров в корзине. ##Минимальное значение 1, но не меньше **cartminitems**. Максимальное значение 60.## | ||
546 | ))) | ||
547 | |||
548 | ==== cartminitems **##*##** ==== | ||
549 | |||
550 | Тип данных:##// number//## | ||
551 | |||
552 | По умолчанию:##// 1//## | ||
553 | |||
554 | (% class="box infomessage" %) | ||
555 | ((( | ||
556 | Ограничивает минимальное кол-во товаров в корзине. ##Минимальное значение 1. Максимальное значение 60, но не больше **cartmaxitems**.## | ||
557 | ))) | ||
558 | |||
559 | ==== clubsiteid ==== | ||
560 | |||
561 | Тип данных:##// number//## | ||
562 | |||
563 | По умолчанию:##// 0//## | ||
564 | |||
565 | (% class="box infomessage" %) | ||
566 | ((( | ||
567 | Вызов сайта для оформления клубного контракта | ||
568 | ))) | ||
569 | |||
570 | ==== customseancetitles ==== | ||
571 | |||
572 | Типа данных: ##//Array<object>//## | ||
573 | |||
574 | (% class="box infomessage" %) | ||
575 | ((( | ||
576 | Выводит цветную текст-метку над сеансом. | ||
577 | Описание параметров объекта текста-метки: | ||
578 | \\##**seanceId**## - идентификатор сеанса, у которого нужно отобразить текст-метку | ||
579 | ##**days**## - массив с днями недели, в которые нужно отобразить текст-метку. **ВАЖНО**: 0 - воскресенье, 1 - понедельник ... 6 - суббота | ||
580 | ##**dates**## - массив с датами, в которые нужно отобразить текст-метку независимо от массива дней. | ||
581 | ##**color**## - любой валидный CSS цвет текста-метки | ||
582 | ##**text**## - текст, который нужно отобразить | ||
583 | \\Работает если **##tariffsseancesfilter: true##** | ||
584 | ))) | ||
585 | |||
586 | Пример: | ||
587 | |||
588 | {{code language="javascript"}} | ||
589 | customseancetitles: [ | ||
590 | { | ||
591 | seanceId: 1, | ||
592 | text: "Тематический сеанс", | ||
593 | color: "#f00", | ||
594 | days: [0,1], | ||
595 | dates: ["25.12.2023","17.04.2025"] | ||
596 | } | ||
597 | ] | ||
598 | {{/code}} | ||
599 | |||
600 | ==== disablemultipleseances **##*##** ==== | ||
601 | |||
602 | Тип данных:##// boolean//## | ||
603 | |||
604 | По умолчанию:##// false//## | ||
605 | |||
606 | (% class="box infomessage" %) | ||
607 | ((( | ||
608 | Параметр предотвращает добавление в корзину тарифов с различными сеансами. | ||
609 | Таким образом как только в корзине появится хоть один товар с сеансом "10:00 - 11:30", товары, у которых есть сеанс например "13:00 - 14:30" будет невозможно добавить в корзину. | ||
610 | Товары без сеансов **не будут затронуты**. | ||
611 | ))) | ||
612 | |||
613 | ==== forcemedia ==== | ||
614 | |||
615 | Тип данных:##// string//## | ||
616 | |||
617 | По умолчанию:##// ''//## | ||
618 | |||
619 | (% class="box infomessage" %) | ||
620 | ((( | ||
621 | Параметр, который вставяет строчку с носителем в поле носителя во вкладке «Пополнение услуг». Используется, например, для QR-кода нанесённого на носитель, чтобы быстро его пополнить. | ||
622 | ))) | ||
623 | |||
624 | Пример: | ||
625 | |||
626 | {{code language="javascript"}} | ||
627 | forcemedia: 'E0012345678900' | ||
628 | {{/code}} | ||
629 | |||
630 | ==== forceseanceid **##*##** ==== | ||
631 | |||
632 | Тип данных:##// number//## | ||
633 | |||
634 | По умолчанию без указания идентификатора не учитывается. | ||
635 | |||
636 | (% class="box infomessage" %) | ||
637 | ((( | ||
638 | Заставит виджет выбрать мероприятие арены по идентификатору платформы и не позволять вернуться к этапу выбора других мероприятий. | ||
639 | ))) | ||
640 | |||
641 | ==== forcesectorid **##*##** ==== | ||
642 | |||
643 | Тип данных:##// number//## | ||
644 | |||
645 | По умолчанию без указания идентификатора не учитывается. | ||
646 | |||
647 | (% class="box infomessage" %) | ||
648 | ((( | ||
649 | Заставит виджет выбрать сектор мероприятия по **##id##** и не позволять вернуться к этапу выбора других секторов. | ||
650 | ))) | ||
651 | |||
652 | ==== forcetab **##*##** ==== | ||
653 | |||
654 | Тип данных:##// string//## | ||
655 | |||
656 | По умолчанию:##// ''//## | ||
657 | |||
658 | (% class="box infomessage" %) | ||
659 | ((( | ||
660 | Переключение на необходимую вкладку виджета («**покупка услуг**» или «**пополнение услуг**») при загрузке. | ||
661 | По умолчанию открывается вкладка «**покупка услуг**». | ||
662 | **##forcetab: 'rewrite'##** принудительно откроет «**пополнение услуг**». | ||
663 | Обычно используется в комбинации с параметром **##onlytab##** | ||
664 | ))) | ||
665 | |||
666 | ==== locale **##*##** ==== | ||
667 | |||
668 | Тип данных:##// string//## | ||
669 | |||
670 | По умолчанию:##// ''//## | ||
671 | |||
672 | (% class="box infomessage" %) | ||
673 | ((( | ||
674 | Параметр локализации. Позволяет переключать между языками виджета, например 'ru' - русский язык, 'en' - английский язык. | ||
675 | ))) | ||
676 | |||
677 | ==== minimap **##*##** ==== | ||
678 | |||
679 | Тип данных:##// boolean//## | ||
680 | |||
681 | По умолчанию:##// true//## | ||
682 | |||
683 | (% class="box infomessage" %) | ||
684 | ((( | ||
685 | Отображать миникарту. | ||
686 | ))) | ||
687 | |||
688 | ==== minimapaspect **##*##** ==== | ||
689 | |||
690 | Тип данных:##// number//## | ||
691 | |||
692 | По умолчанию:##// 0.2//## | ||
693 | |||
694 | (% class="box infomessage" %) | ||
695 | ((( | ||
696 | Размер миникарты относительной полного размера карты, а не контейнера, в которой она находится. | ||
697 | ))) | ||
698 | |||
699 | ==== nopromo **##*##** ==== | ||
700 | |||
701 | Тип данных:##// boolean//## | ||
702 | |||
703 | По умолчанию:##// false//## | ||
704 | |||
705 | (% class="box infomessage" %) | ||
706 | ((( | ||
707 | Убирает вывод промокода на странице подтверждения заказа. | ||
708 | ))) | ||
709 | |||
710 | ==== noscroll **##*##** ==== | ||
711 | |||
712 | Тип данных:##// boolean//## | ||
713 | |||
714 | По умолчанию:##// false//## | ||
715 | |||
716 | (% class="box infomessage" %) | ||
717 | ((( | ||
718 | Скрывает кнопку прокручивания страницы виджета продаж вверх | ||
719 | ))) | ||
720 | |||
721 | ==== onlytab **##*##** ==== | ||
722 | |||
723 | Тип данных:##// string //##//|## Array<string>##// | ||
724 | |||
725 | По умолчанию:##// []//## | ||
726 | |||
727 | (% class="box infomessage" %) | ||
728 | ((( | ||
729 | Скрытие других вкладок виджета («покупка услуг» или «пополнение услуг») при загрузке. Обычно используется в комбинации с параметром **##forcetab##** | ||
730 | ))) | ||
731 | |||
732 | {{code language="javascript"}} | ||
733 | onlytab: "service" // покажет только вкладку «покупка услуг». | ||
734 | onlytab: "rewrite" // покажет только вкладку «пополнение услуг». | ||
735 | onlytab: "personal_lessons" // покажет только вкладку «индивидуальные занятия». | ||
736 | onlytab: "group_lessons" // покажет только вкладку «групповые занятия». | ||
737 | onlytab: "bundles_lessons" // покажет только вкладку «многодневные занятия». | ||
738 | onlytab: ["service", "rewrite"] // покажет только вкладки «покупка услуг» и «пополнение услуг»; | ||
739 | onlytab: "service, rewrite" // покажет только вкладки «покупка услуг» и «пополнение услуг»; | ||
740 | {{/code}} | ||
741 | |||
742 | ==== ordercomment **##*##** ==== | ||
743 | |||
744 | Тип данных:##// string//## | ||
745 | |||
746 | По умолчанию:##// ''//## | ||
747 | |||
748 | (% class="box infomessage" %) | ||
749 | ((( | ||
750 | Опциональный комментарий к заказу. Максимальная длинна комментария 50 символов. | ||
751 | ))) | ||
752 | |||
753 | ==== requiredloyalty **##*##** ==== | ||
754 | |||
755 | Тип данных:##// boolean//## | ||
756 | |||
757 | По умолчанию:##// false//## | ||
758 | |||
759 | (% class="box infomessage" %) | ||
760 | ((( | ||
761 | Включает обязательную регистрацию клиента в программе настроенной на объектке. | ||
762 | ))) | ||
763 | |||
764 | ==== resetcart **##*##** ==== | ||
765 | |||
766 | Тип данных:##// boolean//## | ||
767 | |||
768 | По умолчанию:##// false//## | ||
769 | |||
770 | (% class="box infomessage" %) | ||
771 | ((( | ||
772 | Автоматически очищать содержимое корзины. | ||
773 | ))) | ||
774 | |||
775 | ==== saletermstype **##*##** ==== | ||
776 | |||
777 | Тип данных:##// string//## | ||
778 | |||
779 | По умолчанию:##// '//default//'//## | ||
780 | |||
781 | (% class="box infomessage" %) | ||
782 | ((( | ||
783 | Перед оплатой просит пользователя согласиться с правилами в форме галочки или всплывающего окна | ||
784 | ))) | ||
785 | |||
786 | {{code language="javascript"}} | ||
787 | saletermstype: 'checkbox' // потребует установку галочки для согласия. | ||
788 | saletermstype: 'dialog' // покажет всплывающее окно с правилами, которые нужно принять. | ||
789 | saletermstype: 'default' // принятие правил не требуется. | ||
790 | {{/code}} | ||
791 | |||
792 | ==== shownoticketsseances **##*##** ==== | ||
793 | |||
794 | Тип данных:##// boolean//## | ||
795 | |||
796 | По умолчанию:##// false//## | ||
797 | |||
798 | (% class="box infomessage" %) | ||
799 | ((( | ||
800 | Не скрывать сеансы, на которые закончились билеты. Работает если **##tariffsseancesfilter: true##** | ||
801 | ))) | ||
802 | |||
803 | ==== showoverseances **##*##** ==== | ||
804 | |||
805 | Тип данных:##// boolean//## | ||
806 | |||
807 | По умолчанию:##// false//## | ||
808 | |||
809 | (% class="box infomessage" %) | ||
810 | ((( | ||
811 | Отвечает за отображение прошедших сеансов в списке для фильтрации по времени. При значении **##true##** прошедшие сеансы будут отображаться, но недоступны для выбора пользователем. Работает если **##tariffsseancesfilter: true##** | ||
812 | ))) | ||
813 | |||
814 | [[image:1702554598837-627.png]] | ||
815 | |||
816 | ==== tariffsseancesfilter **##*##** ==== | ||
817 | |||
818 | Тип данных:##// boolean//## | ||
819 | |||
820 | По умолчанию:##// false//## | ||
821 | |||
822 | (% class="box infomessage" %) | ||
823 | ((( | ||
824 | Включить отображение фильтра тарифов по сеансам. | ||
825 | ))) | ||
826 | |||
827 | [[image:https://info.moipass.ru/images/tariffsseancesfilter.png||alt="Example"]] | ||
828 | |||
829 | ---- | ||
830 | |||
831 | === Предзаказ === | ||
832 | |||
833 | ==== preorder ==== | ||
834 | |||
835 | Тип данных:##// Array<object>//## | ||
836 | |||
837 | По умолчанию:##// undefined//## | ||
838 | |||
839 | (% class="box infomessage" %) | ||
840 | ((( | ||
841 | Параметр, позволяющий купить сразу несколько услуг и перейти к подтверждению покупки. | ||
842 | • ##id## — id услуги к покупке | ||
843 | • ##date## — дата, на которую покупается услуга | ||
844 | • ##count## — количество покупаемых услуг | ||
845 | ))) | ||
846 | |||
847 | ===== Пример передаваемых данных: ===== | ||
848 | |||
849 | {{code language="javascript"}} | ||
850 | // либо WPOpenModal({}) | ||
851 | WPOpen({ | ||
852 | preorder: [ | ||
853 | { | ||
854 | id: 57, | ||
855 | date: '06.06.2019', | ||
856 | count: 1 | ||
857 | }, { | ||
858 | id: 58, | ||
859 | date: '07.06.2019', | ||
860 | count: 2 | ||
861 | } | ||
862 | ] | ||
863 | }) | ||
864 | {{/code}} | ||
865 | |||
866 | ---- | ||
867 | |||
868 | === Услуги, пакеты услуг, группы услуг === | ||
869 | |||
870 | ==== tariffsid ==== | ||
871 | |||
872 | Тип данных:##// Array<number> //##//|## boolean##// | ||
873 | |||
874 | По умолчанию:##// []//## | ||
875 | |||
876 | (% class="box infomessage" %) | ||
877 | ((( | ||
878 | Тарифы, которые следует показать на вкладке «Покупка услуг». | ||
879 | По умолчанию массив пуст и не показывает отдельно никакие из услуг. | ||
880 | Используется для принудительной фильтрации в том случае, когда определённому пользователю необходимо показывать услуги, доступные только для него. | ||
881 | ))) | ||
882 | |||
883 | Пример: | ||
884 | |||
885 | {{code language="javascript"}} | ||
886 | tariffsid: [29, 30] // покажет тарифы с id 29 и 30 во вкладке «Покупка услуг». | ||
887 | tariffsid: "15, 16" // покажет тарифы с id 15 и 16 во вкладке «Покупка услуг». | ||
888 | tariffsid: false // уберёт все тарифы с первой страницы | ||
889 | {{/code}} | ||
890 | |||
891 | ==== rewritetariffsid **##*##** ==== | ||
892 | |||
893 | Тип данных:##// Array<number> //##//|## boolean##// | ||
894 | |||
895 | По умолчанию:##// []//## | ||
896 | |||
897 | (% class="box infomessage" %) | ||
898 | ((( | ||
899 | Тарифы, которые следует показать после ввода карты во вкладке «Пополнение услуг». | ||
900 | По умолчанию массив пуст и не показывает отдельно никакие из услуг. | ||
901 | Используется для принудительной фильтрации в том случае, когда определённому пользователю необходимо показывать услуги, доступные только для него. | ||
902 | ))) | ||
903 | |||
904 | Пример: | ||
905 | |||
906 | {{code language="javascript"}} | ||
907 | rtariffsid: [56, 57] // покажет тарифы с id 56 и 57 после ввода карты во вкладке «Пополнение услуг» | ||
908 | rtariffsid: false // уберёт все тарифы во вкладке «Пополнение услуг» | ||
909 | {{/code}} | ||
910 | |||
911 | ==== rtariffsid ==== | ||
912 | |||
913 | (% class="box infomessage" %) | ||
914 | ((( | ||
915 | См. **##rewritetariffsid##**. Доступен и в старой версии виджета | ||
916 | ))) | ||
917 | |||
918 | ==== bundlesid ==== | ||
919 | |||
920 | Тип данных:##// Array<number> //##//|## boolean##// | ||
921 | |||
922 | По умолчанию:##// []//## | ||
923 | |||
924 | (% class="box infomessage" %) | ||
925 | ((( | ||
926 | Пакеты услуг, которые следует показать на первой странице. | ||
927 | По умолчанию массив пуст и не показывает отдельно никакие из пакетов услуг. | ||
928 | Используется для принудительной фильтрации в том случае, когда определённому пользователю необходимо показывать пакеты услуг, доступные только для него. | ||
929 | ))) | ||
930 | |||
931 | Пример: | ||
932 | |||
933 | {{code language="javascript"}} | ||
934 | bundlesid: [4, 5] // покажет пакеты услуг с id 4 и 5 в момент открытия виджета. | ||
935 | bundlesid: false // уберёт все пакеты услуг с первой страницы | ||
936 | {{/code}} | ||
937 | |||
938 | ==== bundleslessonstariffsid ==== | ||
939 | |||
940 | Тип данных:##// Array<number>//## | ||
941 | |||
942 | По умолчанию:##// []//## | ||
943 | |||
944 | (% class="box infomessage" %) | ||
945 | ((( | ||
946 | Фильтр списка доступных связок занятий по массиву идентификаторов | ||
947 | ))) | ||
948 | |||
949 | ==== groupid ==== | ||
950 | |||
951 | Тип данных:##// number//## | ||
952 | |||
953 | По умолчанию:##// undefined//## | ||
954 | |||
955 | (% class="box infomessage" %) | ||
956 | ((( | ||
957 | Параметр, который форсирует показ определённой группы услуг ппс. **##groupid: 5##** покажет только одну группу с **##id##** 5 в виджете. | ||
958 | ))) | ||
959 | |||
960 | ---- | ||
961 | |||
962 | (% class="box warningmessage" %) | ||
963 | ((( | ||
964 | **##* ##**- доступно в новой версии виджета | ||
965 | ))) |