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

To archiwum zawiera:
  - ulmer_social_widget.ocmod.zip                    plik wysyłany w panelu administracyjnym
  - README_OC4_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ć.

Uwaga: w OpenCart 4 plik MUSI nazywać się "ulmer_social_widget.ocmod.zip". Nie zmieniaj jego nazwy!

1. W panelu administracyjnym OpenCart przejdź do: Extensions > Installer.
   Kliknij przycisk Upload i wybierz plik ulmer_social_widget.ocmod.zip.
2. Znajdź wysłane rozszerzenie na liście poniżej i kliknij obok zielony przycisk Install (+). (W OC4 jest to konieczne: wtedy pliki są kopiowane i zapisywane w bazie danych.)
3. Przejdź do Extensions > Extensions, wybierz filtr "Modules", znajdź "Ulmer Social Widget" i kliknij zielony przycisk Install (+).
4. W tym samym miejscu, Extensions > Extensions > Modules, kliknij Edit (ikona ołówka) obok "Ulmer Social Widget".
5. Wszystkie kanały są domyślnie WYŁĄCZONE. Włącz 3-5 kanałów, z których naprawdę korzystasz, wpisz odpowiednie linki i zapisz.
6. Otwórz swój sklep - pływający przycisk pojawi się w narożniku!
(W OpenCart 4 nie trzeba już odświeżać Modifications.)

Jeśli w kroku 4 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/ulmer_social_widget/module/ulmer_social_widget" i zaznacz oba pola, "Access Permission" i "Modify Permission", a następnie zapisz.

============================================================
AKTUALIZACJA DO NOWEJ WERSJI
============================================================
1. Przejdź do Extensions > Installer.
2. Znajdź stary wpis "ulmer_social_widget" na liście i kliknij obok CZERWONY przycisk Delete (kosz).
   (Spokojnie: usuwa to tylko stare pliki. Ustawienia i statystyki są bezpiecznie zapisane w bazie danych i NIE zostaną usunięte!)
3. Kliknij Upload i wybierz nowy plik ulmer_social_widget.ocmod.zip.
4. Ponownie kliknij obok niego zielony przycisk Install (+) na liście.
5. WAŻNE: Przejdź do Dashboard, kliknij niebieską ikonę zębatki (Developer Settings) w prawym górnym rogu i wyczyść pamięć podręczną szablonu. Inaczej panel administracyjny może pokazywać starą, zapisaną w pamięci wersję.
6. Jeśli przy otwieraniu modułu pojawi się komunikat o braku uprawnień, sprawdź System > Users > User Groups: w Twojej grupie "extension/ulmer_social_widget/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
============================================================
Uwaga! W OpenCart 4 ręczna instalacja przez FTP (czyli samo skopiowanie folderów) już nie działa z powodu nowej architektury silnika.
OpenCart 4 wymaga, aby każdy plik rozszerzenia był wyraźnie zapisany w bazie danych (dla automatycznego wczytywania klas).
Dlatego zawsze korzystaj z wbudowanego instalatora rozszerzeń (patrz instrukcja powyżej).

============================================================
OC4: NAJCZĘSTSZE PROBLEMY I PUŁAPKI
============================================================
* Błąd "You do not have permission to access this page" przy otwieraniu ustawień:
  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 oba pola dla "extension/ulmer_social_widget/module/ulmer_social_widget".

* Uszkodzona instalacja / "Could not find install.json" / Safari na Macu:
  Safari na Macu automatycznie rozpakowuje pobrane pliki. Jeśli samodzielnie spakujesz rozpakowany folder, `install.json` znajdzie się w podfolderze i instalacja się nie uda. Pliki MUSISZ spakować tak, aby `install.json` leżał bezpośrednio w KATALOGU GŁÓWNYM archiwum .zip. Albo po prostu pobierz plik w Chrome lub Firefoksie, wtedy automatyczne rozpakowywanie nie wystąpi.

* Moduł zainstalowany, ale nie działa / błędy o brakujących klasach / przeglądarka zmieniła nazwę pliku:
  Wysyłany plik MUSI nazywać się dokładnie `ulmer_social_widget.ocmod.zip`. Jeśli pobierzesz plik dwa razy, przeglądarka może zmienić jego nazwę na `ulmer_social_widget.ocmod (1).zip`. Po wysłaniu takiego pliku OpenCart 4 utworzy uszkodzoną nazwę folderu i cała przestrzeń nazw przestanie działać. Zawsze przywróć nazwę `ulmer_social_widget.ocmod.zip` przed wysłaniem!

* Błąd "File already exists":
  Jeśli poprzednia próba instalacji przekroczyła limit czasu lub się nie udała, OpenCart 4 pozostawia pliki tymczasowe. Przed kolejną próbą usuń pozostałości w `system/storage/marketplace/` i `extension/ulmer_social_widget/` przez FTP albo menedżer plików swojego hostingu.

* Pasek postępu wysyłania zatrzymuje się / błędy JSON.parse:
  Zwykle oznacza to, że `upload_max_filesize` albo `post_max_size` w konfiguracji PHP serwera są zbyt małe (na przykład 2 MB). Zwiększ te wartości w panelu hostingu (cPanel) albo skontaktuj się z hostingodawcą. Upewnij się też, że katalog `system/storage/` jest zapisywalny.

============================================================
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
