Розширення: встановлення, оновлення, дозволи

Розширення додають магазину оплату, доставку, аналітику, фіскалізацію, маркетплейси та інтеграції. Керуються в розділі «Розширення».

Сторінка «Розширення»

Сторінка має три розділи з лічильниками:

«Встановлені» — усе, що вже є в магазині: «Встановлено vX · увімкнено» або «вимкнено», головна дія — «Налаштувати».
«Доступні» — що можна додати з каталогу Tobto.shop: «Не встановлено · vX · ціна», головна дія — «Встановити» або «Отримати в кабінеті» для платних, яких ще не придбано.
«Оновлення» — розширення з новою версією: «Є оновлення X → Y», дія «Оновити до X» і кнопка «Оновити всі (N)».

У кожному рядку є бейдж Tobto.shop (офіційне) або «Сторонній: видавець», категорія й короткий опис. Фільтри однакові для всіх розділів: «Пошук» (назва, опис або код), «Категорія» (оплата, доставка, маркетплейси й фіди, CRM і телефонія, повідомлення й SMS, фіскалізація й облік, маркетинг і аналітика, ШІ, перенесення даних), розробник, стан і порядок. «Скинути фільтри» повертає повний список. Обраний розділ і фільтри зберігаються в адресі сторінки, тож посилання й перезавантаження відкривають те саме. На телефоні фільтри сховані за кнопкою «Фільтри (N)».

Якщо каталог пише «Каталог розширень тимчасово недоступний: маркетплейс Tobto.shop не відповідає», просто спробуйте за хвилину — встановлені розширення працюють і видно їх як завжди. Коли маркетплейс зайнятий, сторінка сама перезавантажить каталог за вказану кількість секунд. Лише повідомлення про ключ поновлення інсталяції означає, що щось треба налаштувати на сервері.

Як встановити розширення

Відкрийте «Розширення» → «Доступні». Знайдіть потрібне пошуком або категорією.
Відкрийте картку розширення й перегляньте «Дозволи»: що саме воно запитує. Якщо картка каже «Не запитує жодних дозволів», розширення не потребує додаткового доступу.
Натисніть «Встановити». Прогрес видно в блоці «Перебіг встановлення».
Після встановлення натисніть «Налаштувати», вкажіть ключі й збережіть кнопкою «Зберегти». Блок «Де воно працює» підкаже, у якому розділі розширення з'явиться, наприклад «Способи оплати» чи «Фіскалізація».
Якщо розширення вимкнене, натисніть «Увімкнути».

Окремий файл пакета завантажується кнопкою «Завантажити файлом» (потрібне право встановлення).

Як оновити розширення

Одне розширення: у розділі «Оновлення» натисніть «Оновити до ...». У вікні «Оновити розширення» можна обрати «Цільова версія».

Усі одразу — «Оновити всі (N)» (потрібне право оновлення розширень):

Відкривається вікно «Оновити всі розширення»: для кожного пакета показано версії «з → на» і позначка «Без нових дозволів» або «Потребує вашого підтвердження» зі списком того, що просить нова версія.
Для пакета, що просить нових дозволів, поставте галочку «Дозволяю це й оновлюю разом з іншими» або натисніть «Оновити окремо», щоб розібратися з ним пізніше. Без галочки такий пакет не завантажується — нові дозволи ніколи не погоджуються за вас.
Натисніть «Оновити (N)». Розширення оновлюються по черзі у фоні, сторінку можна закрити: після повернення вона знову показує «Хід оновлення» і стан кожного пакета («У черзі», «Оновлюється…», «Оновлено», «Пропущено», «Потребує вашого підтвердження», «Не вдалося» з причиною).
Наприкінці — підсумок «Оновлено · Пропущено · Потребують підтвердження · Не вдалося».

Кожен пакет оновлюється так само, як кнопкою «Оновити до ...»: перевірка підпису, відкликання й дозволів, а якщо нова версія не запустилася — автоматично повертається попередня («повернено попередню версію»). Помилка одного пакета не зупиняє решту. Повторний клік чи перезавантаження не запускають друге оновлення: «Оновлення вже йде — нижче його хід». Якщо фонове завдання зависло, сторінка скаже «Фонове оновлення не відповідає. Його можна запустити знову».

Після оновлення платіжного модуля зробіть тестовий платіж: розширення оновлюються окремо від платформи.

Як вимкнути чи видалити

«Вимкнути» зупиняє розширення. «Видалити» вимикає й видаляє його, але дані розширення зберігаються.

Дозволи розширень

Кожне розширення оголошує, що воно може робити («Дозволи: ...»), і працює лише в цих межах. Дії з розширеннями окремо залежать від прав співробітника: перегляд, встановлення, налаштування, увімкнення, вимкнення, оновлення, видалення. Ці права видаються на екрані «Ролі» (див. безпека акаунта).

Важливо

У Tobto.shop Cloud доступні лише офіційні розширення Tobto.shop, а платні розширення доступні на тарифі Business і вище. Розширення інших розробників можна встановити на власному сервері.
Розширення зі статусом «Несумісне» (несумісне з цією версією платформи), «Відкликане» (відкликано видавцем) або «Помилка встановлення» не працюють; після невдалого встановлення показується «Відновлено попередню версію» або «Зміни безпечно скасовано».
Якщо розширення «Помилка» чи його вимкнув запобіжник через повторні збої, оплата, аналітика чи доставка можуть не спрацювати в момент замовлення. Такі розширення видно у вкладці «З помилками» й на сторінці «Здоров'я магазину».
Повідомлення «Розширення відхилило цю дію. Перевірте його налаштування» означає, що ключі або параметри невірні.
Повідомлення «Хтось змінив це розширення раніше за вас» означає: перезавантажте сторінку.
Секрети (токени, ключі) зберігаються зашифрованими й не показуються знову; залиште поле порожнім, щоб не змінювати.