Підтримка й оновлення

Екран Підтримка в лівому меню збирає все, що потрібно, коли щось пішло не так або вийшла нова версія: відомості про модуль, документацію, контакти, оновлення, резервні копії та журнал роботи.

Ліворуч на екрані - картки Про модуль, Документація і Контакти, праворуч - Що нового і Резервні копії, унизу - Журнал роботи модуля. Над ними стоїть смуга оновлення.

Екран «Підтримка»: про модуль, документація, контакти й оновлення

Про модуль

Картка показує шість рядків, про які підтримка питає насамперед:

• Версія - версія модуля. Її також видно біля назви модуля у верхній панелі
• Ліцензія - стан ліцензії: «Ліцензія активна», а для ліцензії з терміном ще й «Залишилось днів» із числом
• OpenCart, PHP, MySQL - версії середовища, у якому працює магазин
• ionCube Loader - версія завантажувача або «не встановлено». Без нього модуль не оновиться

Документація і контакти

У картці Документація три посилання, кожне відкривається в новій вкладці:

• Посібник користувача - «встановлення, налаштування, усі розділи модуля»
• Ліцензійна угода - «умови використання модуля»
• Офіційний сайт Нової пошти - «особистий кабінет, тарифи, відстеження»

У картці Контакти - телеграм-чат і пошта підтримки з приміткою «відповідаємо до 24 годин у робочі дні». Перш ніж писати, підготуйте діагностичний звіт - з ним відповідь буде швидшою.

Картки «Про модуль», «Документація» і «Контакти» на екрані «Підтримка»

Що нового

Картка перелічує зміни найновішої випущеної версії модуля: під заголовком видно номер версії й дату випуску, нижче - список змін. Поки записів немає, картка каже «Записів ще немає». Зміни всіх версій зібрано на сторінці Що нового.

Картка «Що нового»: зміни нової версії модуля

Оновлення модуля

Як модуль повідомляє про нову версію

Коли ви відкриваєте модуль, він автоматично перевіряє, чи вийшла новіша версія, - не частіше ніж раз на добу. Якщо вона є, модуль повідомляє про це в кількох місцях:

• сповіщення «Доступна нова версія модуля» з підказкою «Оновити можна на сторінці «Підтримка».»
• крапка на пункті Підтримка в лівому меню з підказкою «доступне оновлення»
• рядок у дзвонику подій
• смуга «Доступна версія» з кнопкою Оновити на екрані Огляд

Перевірити негайно можна на екрані Підтримка: натисніть Перевірити зараз у смузі оновлення. Якщо нової версії немає, смуга відповість «У вас остання версія» і покаже, коли це перевірено.

Смуга оновлення на екрані «Підтримка» з кнопкою «Перевірити зараз»

Смуга «Доступна версія» з позначкою «Підписано OC Max» і кнопкою «Оновити»

Встановити оновлення

1. Відкрийте Підтримка.
2. У смузі «Доступна версія» натисніть Оновити.
3. Не закривайте сторінку, поки тривають кроки Завантаження, Перевірка, Встановлення і Завершення.
4. Дочекайтеся повідомлення «Модуль оновлено до» з номером версії. Сторінка перезавантажиться сама за кілька секунд.

Встановлення оновлення: завантаження, підпис, встановлення, завершення

Перед оновленням модуль:

• перевіряє ліцензію домену на oc-max.com
• перевіряє підпис OC Max: оновлення, яке не підписано OC Max, модуль не пропонує і не встановлює
• звіряє завантажений архів із контрольною сумою
• переконується, що архів містить лише файли модуля і що всі потрібні файли можна перезаписати
• зберігає поточну версію в резервну копію - про копії йдеться нижче

Якщо запис файлів переривається через помилку, модуль сам повертає попередні файли.

Коли кнопки Оновити немає

Якщо оновитися зараз не можна, смуга показує «Доступна версія» без кнопки і пояснює причину.

Що пише модуль	Що робити
«Щоб оновитись, потрібна активна ліцензія»	Активуйте або продовжіть ліцензію - див. розділ про ліцензію нижче.
«Оновлювати може адміністратор з правом змінювати модуль»	Зайдіть під користувачем, який має право змінювати модуль, - див. Встановлення.
«На сервері немає ionCube Loader - без нього нова версія не запуститься»	Попросіть хостинг увімкнути ionCube Loader.
«На сервері немає розширення PHP zip» або «На сервері немає розширення PHP curl»	Попросіть хостинг увімкнути це розширення PHP.
«Немає прав на запис у папці storage»	Попросіть хостинг дати серверу право запису в цю папку.
«Для PHP … новіших збірок немає»	Новіша версія модуля потребує іншої версії PHP - смуга каже, якої саме версії модуля це стосується. Змініть версію PHP на хостингу.
«Для OpenCart … новіших збірок немає»	Новішої версії модуля для вашої версії OpenCart ще немає: модуль отримує лише збірку для своєї гілки OpenCart.

Якщо оновлення не встановилося

Смуга покаже «Оновлення не встановлено», причину і кнопку Спробувати ще або Перевірити зараз.

Смуга «Оновлення не встановлено»: крок зупинки і причина

Що пише модуль	Що це означає і що робити
«Не вдалося завантажити архів з oc-max.com»	Сервер магазину не дістався до oc-max.com. Спробуйте пізніше.
«Архів не збігся з контрольною сумою - його не встановлено»	Архів завантажився з помилкою. Файли модуля не змінено, спробуйте ще раз.
«Версія … не підписана OC Max» або «Архів не підписано OC Max - оновлення зупинено»	Архів міг підмінити хтось інший. Модуль його не встановлює, файли модуля не змінено. Напишіть у підтримку OC Max.
«На сервері немає розширення PHP openssl»	Без нього підпис оновлення не перевірити. Попросіть хостинг увімкнути розширення PHP openssl.
«Архів містить файли поза модулем - його не встановлено»	Файли модуля не змінено. Напишіть у підтримку.
«oc-max.com не підтвердив ліцензію цього домену», «Ключ ліцензії не збігся з oc-max.com», «Термін дії ліцензії минув», «Ліцензія ще не почала діяти»	Оновлення видається лише для чинної ліцензії. Перевірте ліцензію або напишіть у підтримку.
«Цієї версії вже немає - перевірте оновлення ще раз»	Натисніть Перевірити зараз.
«Немає прав на запис» із назвою файлу і «Файли модуля не змінено»	Попросіть хостинг дати серверу право запису у файли модуля.
«Не вдалося записати файли. Попередню версію повернуто»	Модуль працює на попередній версії. Спробуйте ще раз або напишіть у підтримку.
«Оновлення перервалося - почніть ще раз»	Натисніть Спробувати ще.
«Файли записано, але відповідає стара версія. Очистіть кеш PHP (OPcache) і перезавантажте сторінку»	Очистіть кеш PHP у панелі хостингу або попросіть про це підтримку хостингу.
«Не всі файли вдалося повернути - напишіть у підтримку»	Напишіть у підтримку й додайте діагностичний звіт.

Смуга може також сказати «Оновлень ще немає» або «Не вдалося перевірити оновлення» - тоді натисніть Перевірити зараз трохи згодом.

Резервні копії

Картка «Резервні копії»: копії попередніх версій, файли й налаштування

Резервна копія - це файли модуля і його налаштування на певний момент. Перед кожним оновленням модуль робить копію сам. Зробити її вручну варто перед великими змінами в налаштуваннях.

Створити копію

1. Відкрийте Підтримка.
2. У картці Резервні копії натисніть Створити копію.
3. Дочекайтеся сповіщення «Резервну копію створено» - новий рядок з'явиться вгорі таблиці.

Кнопка «Створити копію»: нова копія з'являється у списку

У таблиці чотири колонки:

• Версія - версія модуля в копії та позначка «створено вручну» або «перед оновленням»
• Дата - коли копію зроблено
• Файли - кількість файлів і їхній обсяг
• Налаштування - кількість збережених значень

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

Повернутися до копії

Файли й налаштування повертаються окремо, і повернути можна будь-яку з копій у таблиці, не лише останню.

Щоб повернути файли:

1. У колонці Файли потрібного рядка натисніть Повернути файли.
2. Підтвердьте запит «Повернути файли версії …?».

Модуль попереджає: «Файли модуля буде замінено збереженою копією, після чого сторінка перезавантажиться» Так повертаються до попередньої версії модуля після невдалого оновлення.

Вікно «Повернути файли версії?» для резервної копії

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

Смуга «Повернення попередньої версії…» під час відкату

Щоб повернути налаштування:

1. У колонці Налаштування натисніть Повернути налаштування.
2. Підтвердьте запит «Повернути налаштування з цієї копії?».

Налаштування модуля стануть такими, як були в момент копії, ключі API та ліцензія не змінюються. Наприкінці модуль скаже «Налаштування повернуто» і назве кількість значень.

Завантажити копію

Поруч із кнопками повернення є кнопки Завантажити файли (zip) і Завантажити налаштування (json): вони зберігають відповідну частину копії на ваш комп'ютер.

Хто бачить ці кнопки

Створювати, повертати й завантажувати копії може лише користувач із правом змінювати модуль. Під час оновлення кнопки тимчасово недоступні.

Журнал роботи модуля

Унизу екрана - власний журнал модуля. У ньому видно, що модуль робив і які запити надсилав Новій пошті.

• Перемикач Увімкнути логування вмикає запис запитів до Нової пошти. Поки його вимкнено, запити в журнал не потрапляють
• Кнопки Усі, Успішні, Попередження і Помилки фільтрують журнал за рівнем записів
• Новіші записи стоять зверху, журнал автоматично оновлюється раз на 60 секунд і гортається сторінками
• Якщо модуль ще нічого не записав, журнал показує «Журнал порожній»

Картка «Журнал роботи модуля»: рівень, завантаження й очищення

Кнопка Очистити журнал видаляє всі записи журналу, але спершу просить підтвердження.

Вікно «Очистити журнал» з попередженням

Кнопка Діагностичний звіт завантажує файл для звернення в підтримку. У ньому версії середовища, стан ліцензії, відомості про таблиці й налаштування модуля та останні записи журналу - без ключів і без даних клієнтів.

Щоб підготувати звернення:

1. Увімкніть Увімкнути логування.
2. Повторіть дію, яка не вдається.
3. Натисніть Діагностичний звіт і дочекайтеся сповіщення «Звіт завантажено».
4. Надішліть файл у підтримку разом з описом того, що ви робили.

Експорт та імпорт налаштувань

Налаштування модуля можна зберегти у файл і перенести в інший магазин: пункти Експорт та Імпорт є в меню кнопки Зберегти на екрані Налаштування. Що потрапляє у файл, як переглянути зміни у вікні Що зміниться і що не переноситься, описано на сторінці Екран налаштувань.

Що не переноситься файлом

Ключі API, відправники й секрети файлом не переносяться: у новому магазині ключ API і відправників додають заново - див. Перший запуск.

Той самий файл приймає й останній крок майстра першого запуску - пункт Імпортувати налаштування.

Ліцензія

Модуль працює лише з активною ліцензією на домен магазину. Ось що він може показати і що з цим робити.

Що ви бачите	Що це означає	Що робити
«Ліцензія активна» в картці Про модуль	Усе гаразд.	Нічого.
Смуга під верхньою панеллю: «Ліцензія спливає через … дн.» або «Ліцензія спливає сьогодні»	До кінця терміну лишилося два тижні або менше. Модуль попереджає: «Продовжіть її, щоб кабінет не зупинився»	Продовжіть ліцензію. Кнопка Придбати ліцензію у смузі відкриває сайт розробника.
Екран «Потрібна ліцензія» з позначкою «Ліцензія відсутня»	Активної ліцензії для цього домену немає.	Активувати ліцензію відкриває крок активації, де вводять ключ або надсилають запит, - див. Перший запуск. Придбати ліцензію показує, де купити модуль. Після покупки натисніть там Вже придбано.
Екран «Ліцензію відключено»	Сервер ліцензій відключив ліцензію для цього домену.	Натисніть Звернутись в підтримку. Коли ліцензію ввімкнуть, натисніть Перевірити ще раз.
Екран «Ліцензію заблоковано»	Домен заблоковано на сервері ліцензій. Налаштування й дані магазину збережені.	Якщо це помилка, натисніть Звернутись в підтримку.

Поки модуль показує один із цих екранів, решта його розділів недоступна. Щойно ліцензія стає активною, модуль відкривається як звичайно.

Ліцензія діє на один домен і будь-яку кількість тестових піддоменів і сайтів. Після покупки її активують протягом кількох годин, щоб перевірити, чи вона вже активна, достатньо оновити сторінку.