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_RU.txt / UK / 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
