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                                      условия лицензии
  - NOTICE                                           сведения об авторстве
  - DATENSCHUTZ.md                                   уведомление о конфиденциальности

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

============================================================
УСТАНОВКА (ДЛЯ НОВЫХ ПОЛЬЗОВАТЕЛЕЙ)
============================================================
Внимание: В OpenCart 4 файл обязательно должен называться "ulmer_social_widget.ocmod.zip". Не переименовывайте его!

1. В админке перейдите в: Расширения > Установка расширений.
   Нажмите кнопку Загрузить (Upload) и выберите файл ulmer_social_widget.ocmod.zip
2. В списке загруженных расширений ниже найдите этот модуль и нажмите зеленую кнопку Установить (+) рядом с ним. (В OC4 это обязательно, именно в этот момент файлы копируются и регистрируются в базе!).
3. Перейдите в Расширения > Расширения, выберите фильтр "Модули", найдите "Ulmer Social Widget" и нажмите зеленую кнопку Установить (+).
4. Там же, в Расширения > Расширения > Модули, нажмите Редактировать (карандаш) напротив "Ulmer Social Widget".
5. По умолчанию все каналы ВЫКЛЮЧЕНЫ. Включите 3-5 нужных вам каналов, укажите ссылки и сохраните настройки.
6. Откройте витрину магазина - плавающая кнопка появится в углу экрана!
(В OpenCart 4 больше не нужно обновлять модификаторы).

Если на шаге 4 появилось сообщение об отсутствии прав: OpenCart выдает права автоматически той группе пользователей, под которой модуль устанавливали, поэтому такое бывает только если вы управляете магазином из другой группы. Перейдите в Система > Пользователи > Группы пользователей, отредактируйте свою группу, найдите "extension/ulmer_social_widget/module/ulmer_social_widget", поставьте галочки в списках "Разрешить просмотр" и "Разрешить редактирование" и сохраните.

============================================================
ОБНОВЛЕНИЕ ДО НОВОЙ ВЕРСИИ
============================================================
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". Обычно OpenCart выдает эти права сам при установке модуля.

============================================================
УСТАНОВКА / ОБНОВЛЕНИЕ ВРУЧНУЮ ПО FTP
============================================================
Внимание! В OpenCart 4 ручная установка по FTP (простое копирование папок) больше не работает из-за новой архитектуры движка. 
OpenCart 4 требует обязательной регистрации каждого файла расширения в базе данных (autoloader). 
Поэтому всегда используйте только встроенный Установщик расширений (см. инструкции выше).

============================================================
РЕШЕНИЕ ЧАСТЫХ ПРОБЛЕМ OC4
============================================================
* Ошибка "У вас нет прав для доступа к этой странице" при открытии настроек:
  OpenCart выдает права автоматически той группе пользователей, под которой модуль устанавливали, поэтому такое бывает только если вы управляете магазином из другой группы. Перейдите в Система > Пользователи > Группы пользователей, отредактируйте свою группу и поставьте обе галочки для "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
