Ulmer Social Widget
Безкоштовний віджет соцмереж / контактів для OpenCart 4.0.x
від EmeraldWeb - https://emeraldweb.de

Цей архів містить:
  - ulmer_social_widget.ocmod.zip            файл для завантаження в адмінку
  - README_OC4_UK.txt / RU / EN              ця інструкція (3 мови)
  - LICENSE.txt                                      умови ліцензії
  - DATENSCHUTZ.md                                   повідомлення про конфіденційність

============================================================
ПЕРЕД ПОЧАТКОМ РОБОТИ (ВАЖЛИВО!)
============================================================
Наполегливо рекомендуємо зробити резервну копію (бекап) файлів та бази даних вашого магазину перед встановленням або оновленням будь-яких модулів. Як то кажуть, світ поділяється на тих, хто вже робить бекапи, і тих, хто потім півночі відновлює роботу сайту! :)

============================================================
ВСТАНОВЛЕННЯ (ДЛЯ НОВИХ КОРИСТУВАЧІВ)
============================================================
Увага: У OpenCart 4 файл обов'язково повинен називатися "ulmer_social_widget.ocmod.zip". Не перейменовуйте його!

1. В адмінці перейдіть у: Розширення > Встановлення розширень.
   Натисніть кнопку Завантажити (Upload) та оберіть файл ulmer_social_widget.ocmod.zip
2. У списку завантажених розширень нижче знайдіть цей модуль і натисніть зелену кнопку Встановити (+) поруч із ним. (В OC4 це обов'язково, саме в цей момент файли копіюються та реєструються в базі!).
3. Перейдіть у Розширення > Розширення, оберіть фільтр "Модулі", знайдіть "Ulmer Social Widget" і натисніть зелену кнопку Встановити (+).
4. Перейдіть у Система > Користувачі > Групи користувачів. Відредагуйте групу адміністраторів (Top Administrator), знайдіть "extension/ulmer_social_widget/module/ulmer_social_widget" і поставте галочки у списках "Дозволити перегляд" і "Дозволити редагування". Збережіть.
5. Поверніться у Розширення > Розширення > Модулі та натисніть Редагувати (олівець) навпроти "Ulmer Social Widget".
6. За замовчуванням усі канали ВИМКНЕНІ. Увімкніть 3-5 потрібних вам каналів, вкажіть посилання та збережіть налаштування.
7. Відкрийте вітрину магазину - плаваюча кнопка з'явиться у кутку екрана!
(В OpenCart 4 більше не потрібно оновлювати модифікатори).

============================================================
ОНОВЛЕННЯ ДО НОВОЇ ВЕРСІЇ
============================================================
1. Перейдіть у Розширення > Встановлення розширень.
2. У списку завантажених розширень знайдіть старий "ulmer_social_widget" і натисніть ЧЕРВОНУ кнопку з кошиком (Видалити) поруч із ним. 
   (Не хвилюйтеся: це видалить лише файли старої версії. Ваші налаштування та статистика безпечно зберігаються у базі даних і НЕ видаляться!).
3. Натисніть Завантажити (Upload) та оберіть новий файл ulmer_social_widget.ocmod.zip.
4. Знову натисніть зелену кнопку Встановити (+) поруч із ним у списку.
5. ВАЖЛИВО: Перейдіть у Панель стану (Dashboard), натисніть на синю шестірню (Налаштування розробника) праворуч угорі та очистіть кеш шаблону (Template). Інакше адмінка може показувати стару закешовану версію.
6. Якщо при спробі відкрити модуль ви бачите помилку "У вас немає дозволу", переконайтеся, що ви знову надали права у Система > Користувачі > Групи користувачів для "extension/ulmer_social_widget/module/ulmer_social_widget".

============================================================
ВСТАНОВЛЕННЯ / ОНОВЛЕННЯ ВРУЧНУ ПО FTP
============================================================
Увага! В OpenCart 4 ручне встановлення по FTP (просте копіювання папок) більше не працює через нову архітектуру рушія. 
OpenCart 4 вимагає обов'язкової реєстрації кожного файлу розширення в базі даних (autoloader). 
Тому завжди використовуйте лише вбудований Установник розширень (див. інструкції вище).

============================================================
ВИРІШЕННЯ ТИПОВИХ ПРОБЛЕМ OC4
============================================================
* Помилка "У вас немає дозволу на доступ до цієї сторінки" при відкритті налаштувань:
  Ви забули надати права! Перейдіть у Система > Користувачі > Групи користувачів, відредагуйте свою групу і поставте обидві галочки для "extension/ulmer_social_widget/module/ulmer_social_widget".

* Помилка встановлення / "Could not find install.json" / Користувачі Mac Safari:
  Mac Safari автоматично розпаковує завантажені файли. Якщо ви спробуєте запакувати папку назад у zip-архів самостійно, `install.json` опиниться всередині вкладеної папки, через що встановлення перерветься. Ви ЗОБОВ'ЯЗАНІ пакувати файли так, щоб `install.json` лежав у самому КОРЕНІ `.zip` архіву. Або просто завантажте файл через Chrome/Firefox, щоб уникнути авторозпакування Safari.

* Зламана архітектура MVC-L / Браузер перейменував файл:
  Завантажуваний файл ПОВИНЕН називатися рівно `ulmer_social_widget.ocmod.zip`. Якщо ви завантажили файл двічі, браузер міг перейменувати його на `ulmer_social_widget.ocmod (1).zip`. Якщо завантажити такий файл, OpenCart 4 створить папку з неправильним іменем, що повністю зламає простір імен (namespace) і модуль не працюватиме. Завжди перейменовуйте файл назад на `ulmer_social_widget.ocmod.zip` перед завантаженням!

* Помилка "File already exists" (Файл уже існує):
  Якщо попередня спроба встановлення обірвалася (через таймаут або ліміти), OpenCart 4 залишає "сміттєві" тимчасові файли. Вам необхідно зайти по FTP або через Файловий менеджер хостингу і видалити залишки в папках `system/storage/marketplace/` та `extension/ulmer_social_widget/` перед повторним встановленням.

* Зависає повзунок завантаження / Помилки JSON.parse:
  Зазвичай це означає, що на вашому сервері встановлено занадто жорсткий ліміт PHP `upload_max_filesize` або `post_max_size` (наприклад, 2 Мб). Збільште ці ліміти в панелі керування хостингом (cPanel) або зверніться до підтримки хостингу. Також перевірте, чи доступна папка `system/storage/` для запису.


============================================================
ПІДТРИМКА ТА ДОПОМОГА
============================================================
Зіткнулися з проблемою або щось пішло не так? Напишіть нам, і ми постараємося допомогти!
Зверніть увагу: модуль надається абсолютно безкоштовно, тому підтримка здійснюється в міру наших можливостей. У зв'язку з високим завантаженням відповідь може зайняти деякий час. Дякуємо за розуміння!

  Email:     support@emeraldweb.de
  Telegram:  @emeraldweb_support
  WhatsApp:  https://wa.me/message/SOTKVJT5H365N1
  Web:       https://emeraldweb.de
