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

Этот архив содержит:
  - ulmer_social_widget.ocmod.zip            файл для загрузки в админку
  - README_OC4_RU.txt / UK / 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
