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

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

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

============================================================
ВСТАНОВЛЕННЯ (ДЛЯ НОВИХ КОРИСТУВАЧІВ)
============================================================
1. В адмінці OpenCart перейдіть у: Модулі / Розширення > Встановлення розширень (у деяких збірках "Доповнення").
   Завантажте файл: ulmer-social-widget-1.4.14.ocmod.zip
2. Перейдіть у Модулі / Розширення > Модифікатори та натисніть синю кнопку Оновити (Refresh) у правому верхньому куті.
3. Перейдіть у Панель стану (Dashboard), натисніть на синю іконку шестірні (Налаштування розробника) у правому верхньому куті та очистіть кеш теми (Theme).
4. Перейдіть у Модулі / Розширення > Модулі / Розширення, оберіть тип "Модулі", знайдіть "Ulmer Social Widget" і натисніть зелену кнопку Встановити (+).
5. Там само, у Модулі / Розширення > Модулі / Розширення, натисніть Редагувати (олівець) напроти "Ulmer Social Widget".
6. За замовчуванням усі канали ВИМКНЕНІ. Увімкніть 3-5 потрібних вам каналів, вкажіть посилання та збережіть налаштування.
7. Відкрийте вітрину магазину - плаваюча кнопка з'явиться у кутку екрана!

Якщо на кроці 5 з'явилося повідомлення про відсутність прав: OpenCart видає права автоматично тій групі користувачів, під якою модуль встановлювали, тому таке буває лише якщо ви керуєте магазином з іншої групи. Перейдіть у Система > Користувачі > Групи користувачів, відредагуйте свою групу, знайдіть "extension/module/ulmer_social_widget" і поставте галочки у списках "Дозвіл на перегляд" та "Дозвіл на зміну", потім збережіть.

============================================================
ОНОВЛЕННЯ ДО НОВОЇ ВЕРСІЇ
============================================================
Установник OpenCart за замовчуванням блокує перезапис файлів. Щоб оновити модуль через адмінку, виконайте наступні кроки:
1. Перейдіть у Модулі / Розширення > Встановлення розширень.
2. Внизу сторінки, в таблиці "Історія встановлень" (Installed Extensions), знайдіть старий запис "Ulmer Social Widget".
3. Натисніть на ЧЕРВОНУ кнопку з кошиком (Видалити) поруч з нею. 
   (Не хвилюйтеся: це видалить лише файли старої версії, щоб дозволити завантаження нових. Ваші налаштування, посилання та статистика при цьому НЕ видаляться, вони безпечно зберігаються у базі даних!).
4. Завантажте новий файл ulmer-social-widget-1.4.14.ocmod.zip.
5. Перейдіть у Модулі / Розширення > Модифікатори та натисніть Оновити (Refresh).
6. Обов'язково очистіть кеш теми через синю шестірню на Панелі стану (Dashboard)!
7. Якщо при спробі відкрити модуль ви бачите помилку "У вас немає прав для доступу", перевірте у Система > Користувачі > Групи користувачів: у вашої групи мають стояти обидві галочки для "extension/module/ulmer_social_widget". Зазвичай OpenCart видає ці права сам під час встановлення модуля.

============================================================
ВСТАНОВЛЕННЯ / ОНОВЛЕННЯ ВРУЧНУ ПО FTP (якщо установник не працює)
============================================================
Використовуйте цей спосіб, якщо на вашому хостингу не працює установник розширень. Потрібні ДВА кроки, лише першого недостатньо:

1. Відкрийте .ocmod.zip, дістаньте з нього папку `upload` та скопіюйте її вміст у корінь вашого магазину (поверх папок `admin` та `catalog`).
2. Дістаньте файл `install.xml` з кореня .ocmod.zip, перейменуйте його на `ulmer.ocmod.xml` і покладіть у папку `system/` вашого магазину.
   Не пропускайте крок 2: саме цей файл додає віджет у футер вашої теми. Якщо зробити лише крок 1, модуль з'явиться в адмінці, але на вітрині віджет не покажеться.

Після цього: натисніть "Оновити" в розділі Модулі / Розширення > Модифікатори, потім очистіть кеш теми у Панелі стану (Dashboard, синя шестірня, Налаштування розробника). Інакше адмінка показуватиме стару версію кешованого шаблону. Не забудьте також надати права у Система > Користувачі > Групи користувачів.

Корисно знати: за такого встановлення модуль не з'явиться у списку Модулі / Розширення > Модифікатори, а вкладка "Діагностика" в самому модулі повідомить, що модифікатор не знайдено. Для вручну покладеного файлу це нормально, віджет при цьому працює.

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

* Помилка "Каталог не доступний для запису!" під час встановлення:
  Це обмеження безпеки OC3. Використовуйте метод ручного завантаження по FTP з інструкції вище, або встановіть популярний безкоштовний модуль "Fix OC 3.x Extension Installer" для виправлення установника.

* "Файл не може бути завантажений" / Вікно завантаження просто зникає без помилок:
  Ймовірно, на вашому хостингу встановлено занадто жорсткий ліміт `upload_max_filesize` (наприклад, 2 Мб). Збільште цей ліміт у налаштуваннях PHP (cPanel) або використовуйте ручне встановлення по FTP.

* Помилка "Для модифікатора потрібен унікальний ID код!":
  Ви намагаєтеся завантажити оновлення поверх старої версії модуля. В OC3 ви ЗОБОВ'ЯЗАНІ видалити стару версію в "Історія встановлень" ПЕРЕД завантаженням нової (див. крок 3 у розділі Оновлення).

* Налаштування не зберігаються / Віджет не з'являється / Відображається стара версія:
  У OC3 дуже агресивний кеш Twig. Натиснути "Оновити" у Модифікаторах НЕДОСТАТНЬО! Ви повинні перейти в "Панель стану" (Dashboard), натиснути на синю шестірню у правому верхньому куті та очистити "Кеш теми". Також переконайтеся, що ви скинули кеш у сторонніх плагінах (NitroPack, LiteSpeed) та Cloudflare, якщо вони використовуються.

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

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