Ulmer Social Widget
Darmowy pływający widget społecznościowy / kontaktowy dla OpenCart 3.0.x i ocStore 3.0.x
od EmeraldWeb - https://emeraldweb.de

To archiwum zawiera:
  - ulmer-social-widget-1.4.15.ocmod.zip             plik do instalacji
  - README_OC3_PL.txt / DE / EN / RU / UK            ta instrukcja (5 języków)
  - LICENSE.txt                                      warunki licencji
  - NOTICE                                           informacja o autorze
  - DATENSCHUTZ.md                                   informacja o prywatności

============================================================
ZANIM ZACZNIESZ (WAŻNE!)
============================================================
Zdecydowanie zalecamy wykonanie pełnej kopii zapasowej plików i bazy danych sklepu przed instalacją lub aktualizacją jakiegokolwiek rozszerzenia. Jak to się mówi: świat dzieli się na tych, którzy już robią kopie zapasowe, i na tych, którzy potem pół nocy przywracają swoją stronę! :)

============================================================
INSTALACJA (DLA NOWYCH UŻYTKOWNIKÓW)
============================================================
Uwaga: nazwy pozycji menu podajemy tak, jak wyglądają w standardowym panelu administracyjnym OpenCart (po angielsku). Jeśli masz zainstalowane polskie tłumaczenie panelu, nazwy mogą się różnić.

1. W panelu administracyjnym OpenCart: Extensions > Installer.
   Wyślij plik: ulmer-social-widget-1.4.15.ocmod.zip
2. Przejdź do Extensions > Modifications i kliknij niebieski przycisk Refresh w prawym górnym rogu.
3. Przejdź do Dashboard, kliknij niebieską ikonę zębatki (Developer Settings) w prawym górnym rogu i wyczyść pamięć podręczną szablonu (Theme).
4. Przejdź do Extensions > Extensions, wybierz z listy "Modules", znajdź "Ulmer Social Widget" i kliknij zielony przycisk Install (+).
5. W tym samym miejscu, Extensions > Extensions > Modules, kliknij Edit (ikona ołówka) obok "Ulmer Social Widget".
6. Wszystkie kanały są domyślnie WYŁĄCZONE. Włącz 3-5 kanałów, z których naprawdę korzystasz, wpisz odpowiednie linki i zapisz.
7. Otwórz swój sklep - pływający przycisk pojawi się w narożniku!

Jeśli w kroku 5 pojawi się komunikat o braku uprawnień: OpenCart nadaje uprawnienia automatycznie grupie użytkowników administratora, który instalował moduł, więc zdarza się to tylko wtedy, gdy zarządzasz sklepem z innej grupy. Przejdź do System > Users > User Groups, edytuj swoją grupę, znajdź "extension/module/ulmer_social_widget" i zaznacz pole zarówno na liście "Access Permission", jak i "Modify Permission", a następnie zapisz.

============================================================
AKTUALIZACJA DO NOWEJ WERSJI
============================================================
Instalator rozszerzeń OpenCart domyślnie nie pozwala nadpisywać plików. Aby zaktualizować moduł z panelu administracyjnego, wykonaj następujące kroki:
1. Przejdź do Extensions > Installer.
2. Znajdź stary wpis "Ulmer Social Widget" na liście "Installed Extensions" na dole strony.
3. Kliknij obok CZERWONY przycisk Delete (kosz).
   (Spokojnie: usuwa to tylko stare pliki, żeby można było wysłać nowe. Ustawienia modułu, linki i statystyki są bezpiecznie zapisane w bazie danych i NIE zostaną usunięte!)
4. Wyślij nowy plik ulmer-social-widget-1.4.15.ocmod.zip.
5. Przejdź do Extensions > Modifications i kliknij Refresh.
6. Co najważniejsze: wyczyść pamięć podręczną szablonu za pomocą niebieskiej ikony zębatki w Dashboard!
7. Jeśli przy edycji modułu pojawi się komunikat o braku uprawnień, sprawdź System > Users > User Groups: w Twojej grupie "extension/module/ulmer_social_widget" musi być zaznaczone na liście Access i na liście Modify. Zwykle OpenCart ustawia to sam przy instalacji modułu.

============================================================
RĘCZNA INSTALACJA / AKTUALIZACJA PRZEZ FTP (gdy instalator nie działa)
============================================================
Skorzystaj z tej metody, jeśli Twój hosting blokuje instalator rozszerzeń. Składa się ona z DWÓCH kroków - pierwszy sam w sobie nie wystarczy:

1. Otwórz plik .ocmod.zip, wyjmij z niego folder `upload` i skopiuj jego zawartość do katalogu głównego sklepu (na foldery `admin` i `catalog`).
2. Weź `install.xml` z katalogu głównego pliku .ocmod.zip, zmień nazwę na `ulmer.ocmod.xml` i wyślij do folderu `system/` swojego sklepu.
   Nie pomijaj kroku 2: właśnie ten plik dodaje widget do stopki Twojego szablonu. Po samym kroku 1 moduł pojawi się w panelu, ale widget nigdy nie wyświetli się w sklepie.

Następnie: kliknij "Refresh" w Extensions > Modifications, a potem wyczyść pamięć podręczną szablonu w Dashboard (niebieska ikona zębatki, Developer Settings) - inaczej panel będzie pokazywał starą, zapisaną w pamięci wersję szablonu. Nie zapomnij też o uprawnieniach grupy użytkowników (System > Users > User Groups).

Warto wiedzieć: przy instalacji tą metodą moduł nie jest wymieniony w Extensions > Modifications, a zakładka Diagnostyka w module zgłasza brak modyfikacji. Dla ręcznie umieszczonego pliku jest to normalne, a widget działa mimo to.

============================================================
NAJCZĘSTSZE PROBLEMY W OC3
============================================================
* "Permission Denied!" przy otwieraniu ustawień modułu:
  OpenCart nadaje uprawnienia automatycznie grupie użytkowników administratora, który instalował moduł, więc zdarza się to tylko wtedy, gdy zarządzasz sklepem z innej grupy. Przejdź do System > Users > User Groups, otwórz swoją grupę administracyjną do edycji i zaznacz "extension/module/ulmer_social_widget" na liście Access i na liście Modify.

* "Directory Not Allowed to be Written To" przy wysyłaniu:
  To znane ograniczenie bezpieczeństwa OC3, które zawęża katalogi, do których instalator może pisać. Skorzystaj z ręcznej instalacji przez FTP opisanej powyżej albo zainstaluj popularny moduł "Fix OC 3.x Extension Installer" z marketplace OpenCart.

* "File could not be uploaded" / wysyłanie kończy się bez komunikatu:
  Najprawdopodobniej `upload_max_filesize` w konfiguracji PHP u Twojego hostingodawcy jest zbyt małe (na przykład 2 MB). Zwiększ tę wartość w cPanel lub php.ini albo skorzystaj z ręcznej instalacji przez FTP.

* Błąd "Modification requires a unique ID code!":
  Próbujesz wysłać aktualizację na istniejącą instalację. NAJPIERW usuń starą modyfikację w Extensions > Installer (patrz krok 3 w rozdziale o aktualizacji).

* Zmiany nie są widoczne / widget się nie pojawia:
  OC3 ma bardzo uparty cache Twiga. Kliknięcie Refresh w Modifications NIE WYSTARCZY! Przejdź do głównego Dashboard, kliknij niebieską ikonę zębatki w prawym górnym rogu i wyczyść pamięć podręczną szablonu. Wyczyść też wszystkie cache zewnętrzne (NitroPack, LiteSpeed, Cloudflare).

============================================================
WSPARCIE I POMOC
============================================================
Coś nie działa albo poszło nie tak? Napisz do nas, postaramy się pomóc!
Uwaga: ten moduł jest całkowicie darmowy, dlatego wsparcie udzielane jest w miarę możliwości. Z powodu dużego obłożenia odpowiedź może czasem chwilę potrwać. Dziękujemy za zrozumienie!

  E-mail:    support@emeraldweb.de
  Telegram:  @emeraldweb_support
  WhatsApp:  https://wa.me/message/SOTKVJT5H365N1
  Strona:    https://emeraldweb.de
