Ulmer Social Widget
Kostenloses schwebendes Social-/Kontakt-Widget für OpenCart 4.0.x - 4.1.x
von EmeraldWeb - https://emeraldweb.de

Dieses Archiv enthält:
  - ulmer_social_widget.ocmod.zip                    die Datei, die Sie im Administrationsbereich hochladen
  - README_OC4_DE.txt / EN / PL / RU / UK            diese Anleitung (5 Sprachen)
  - LICENSE.txt                                      Lizenzbedingungen
  - NOTICE                                           Hinweise zu Autor und Namensnennung
  - DATENSCHUTZ.md                                   Datenschutzhinweis

============================================================
BEVOR SIE BEGINNEN (WICHTIG!)
============================================================
Wir empfehlen dringend, vor der Installation oder Aktualisierung einer Erweiterung eine vollständige Sicherung der Dateien und der Datenbank Ihres Shops anzulegen. Wie man sagt: Die Welt teilt sich in zwei Arten von Menschen - die, die schon Backups machen, und die, die danach halbe Nächte damit verbringen, ihre Seite wiederherzustellen! :)

============================================================
INSTALLATION (FÜR NEUE NUTZER)
============================================================
Hinweis: Die Menüpunkte sind so angegeben, wie sie im Standard-Administrationsbereich von OpenCart (auf Englisch) erscheinen. Mit einem deutschen Sprachpaket können die Bezeichnungen abweichen.

Achtung: In OpenCart 4 MUSS die Datei "ulmer_social_widget.ocmod.zip" heißen. Benennen Sie sie nicht um!

1. Gehen Sie im OpenCart-Administrationsbereich zu: Extensions > Installer.
   Klicken Sie auf Upload und wählen Sie die Datei ulmer_social_widget.ocmod.zip.
2. Suchen Sie die hochgeladene Erweiterung in der Liste darunter und klicken Sie daneben auf die grüne Schaltfläche Install (+). (In OC4 ist das notwendig: Dabei werden die Dateien kopiert und in der Datenbank registriert.)
3. Gehen Sie zu Extensions > Extensions, wählen Sie den Filter "Modules", suchen Sie "Ulmer Social Widget" und klicken Sie auf die grüne Schaltfläche Install (+).
4. Klicken Sie dort, unter Extensions > Extensions > Modules, auf Edit (Stiftsymbol) neben "Ulmer Social Widget".
5. Alle Kanäle sind standardmäßig AUS. Schalten Sie die 3-5 Kanäle ein, die Sie wirklich nutzen, tragen Sie die jeweiligen Links ein und speichern Sie.
6. Öffnen Sie Ihren Shop - die schwebende Schaltfläche erscheint in der Ecke!
(In OpenCart 4 müssen die Modifications nicht mehr aktualisiert werden.)

Falls bei Schritt 4 eine Meldung über fehlende Berechtigungen erscheint: OpenCart erteilt die Rechte automatisch der Benutzergruppe des Administrators, der das Modul installiert hat. Das tritt also nur auf, wenn Sie den Shop unter einer anderen Gruppe verwalten. Gehen Sie zu System > Users > User Groups, bearbeiten Sie Ihre Gruppe, suchen Sie "extension/ulmer_social_widget/module/ulmer_social_widget" und setzen Sie beide Häkchen, bei "Access Permission" und bei "Modify Permission", dann speichern Sie.

============================================================
AUF EINE NEUE VERSION AKTUALISIEREN
============================================================
1. Gehen Sie zu Extensions > Installer.
2. Suchen Sie den alten Eintrag "ulmer_social_widget" in der Liste und klicken Sie daneben auf die ROTE Schaltfläche Delete (Papierkorb).
   (Keine Sorge: Damit werden nur die alten Dateien entfernt. Ihre Einstellungen und Statistiken liegen sicher in der Datenbank und werden NICHT gelöscht!)
3. Klicken Sie auf Upload und wählen Sie die neue Datei ulmer_social_widget.ocmod.zip.
4. Klicken Sie in der Liste erneut daneben auf die grüne Schaltfläche Install (+).
5. WICHTIG: Gehen Sie zum Dashboard, klicken Sie oben rechts auf das blaue Zahnradsymbol (Developer Settings) und leeren Sie den Template-Cache. Sonst zeigt der Administrationsbereich möglicherweise die alte zwischengespeicherte Fassung.
6. Falls beim Öffnen des Moduls eine Meldung über fehlende Berechtigungen erscheint, prüfen Sie System > Users > User Groups: In Ihrer Gruppe muss "extension/ulmer_social_widget/module/ulmer_social_widget" sowohl in der Access- als auch in der Modify-Liste angehakt sein. Normalerweise setzt OpenCart das bei der Installation selbst.

============================================================
MANUELLE INSTALLATION / AKTUALISIERUNG PER FTP
============================================================
Achtung! In OpenCart 4 funktioniert die manuelle Installation per FTP (also das bloße Kopieren von Ordnern) wegen der neuen Architektur nicht mehr.
OpenCart 4 verlangt, dass jede Datei einer Erweiterung ausdrücklich in der Datenbank registriert ist (für den Autoloader).
Nutzen Sie daher immer den eingebauten Extension Installer (siehe Anleitung oben).

============================================================
OC4: HÄUFIGE PROBLEME UND FALLSTRICKE
============================================================
* Fehler "You do not have permission to access this page" beim Öffnen der Einstellungen:
  OpenCart erteilt die Rechte automatisch der Benutzergruppe des Administrators, der das Modul installiert hat. Das tritt also nur auf, wenn Sie den Shop unter einer anderen Gruppe verwalten. Gehen Sie zu System > Users > User Groups, bearbeiten Sie Ihre Administratorgruppe und setzen Sie beide Häkchen für "extension/ulmer_social_widget/module/ulmer_social_widget".

* Defekte Installation / "Could not find install.json" / Safari auf dem Mac:
  Safari auf dem Mac entpackt heruntergeladene Dateien automatisch. Wenn Sie den entpackten Ordner selbst wieder zippen, liegt `install.json` in einem Unterordner und die Installation scheitert. Sie MÜSSEN die Dateien so zippen, dass `install.json` direkt im WURZELVERZEICHNIS des .zip-Archivs liegt. Oder laden Sie die Datei einfach mit Chrome oder Firefox herunter, dann entfällt das automatische Entpacken.

* Modul installiert, funktioniert aber nicht / fehlende Klassen / der Browser hat die Datei umbenannt:
  Die hochgeladene Datei MUSS genau `ulmer_social_widget.ocmod.zip` heißen. Wenn Sie die Datei zweimal herunterladen, benennt Ihr Browser sie womöglich in `ulmer_social_widget.ocmod (1).zip` um. Laden Sie die umbenannte Datei hoch, erzeugt OpenCart 4 einen fehlerhaften Ordnernamen und der gesamte Namensraum bricht. Benennen Sie die Datei vor dem Hochladen immer in `ulmer_social_widget.ocmod.zip` zurück!

* Fehler "File already exists":
  Wenn ein früherer Installationsversuch abgebrochen ist oder in eine Zeitüberschreitung lief, lässt OpenCart 4 temporäre Dateien zurück. Löschen Sie die Reste in `system/storage/marketplace/` und `extension/ulmer_social_widget/` per FTP oder über den Dateimanager Ihres Hosters, bevor Sie es erneut versuchen.

* Der Fortschrittsbalken beim Hochladen bleibt stehen / JSON.parse-Fehler:
  Meist sind `upload_max_filesize` oder `post_max_size` in der PHP-Konfiguration Ihres Servers zu klein (zum Beispiel 2 MB). Erhöhen Sie diese Werte im Hosting-Panel (cPanel) oder wenden Sie sich an Ihren Hoster. Stellen Sie außerdem sicher, dass das Verzeichnis `system/storage/` beschreibbar ist.

============================================================
SUPPORT & HILFE
============================================================
Etwas funktioniert nicht oder ist schiefgelaufen? Schreiben Sie uns, wir helfen Ihnen gerne weiter!
Bitte beachten Sie: Dieses Modul ist völlig kostenlos, der Support erfolgt daher im Rahmen unserer Möglichkeiten. Wegen hoher Auslastung kann eine Antwort gelegentlich etwas dauern. Vielen Dank für Ihr Verständnis!

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