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

Dieses Archiv enthält:
  - ulmer-social-widget-1.4.15.ocmod.zip             die Datei, die Sie installieren
  - README_OC3_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.

1. Im OpenCart-Administrationsbereich: Extensions > Installer.
   Laden Sie die Datei hoch: ulmer-social-widget-1.4.15.ocmod.zip
2. Gehen Sie zu Extensions > Modifications und klicken Sie oben rechts auf die blaue Schaltfläche Refresh.
3. Gehen Sie zum Dashboard, klicken Sie oben rechts auf das blaue Zahnradsymbol (Developer Settings) und leeren Sie den Theme-Cache.
4. Gehen Sie zu Extensions > Extensions, wählen Sie in der Auswahlliste "Modules", suchen Sie "Ulmer Social Widget" und klicken Sie auf die grüne Schaltfläche Install (+).
5. Klicken Sie dort, unter Extensions > Extensions > Modules, auf Edit (Stiftsymbol) neben "Ulmer Social Widget".
6. 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.
7. Öffnen Sie Ihren Shop - die schwebende Schaltfläche erscheint in der Ecke!

Falls bei Schritt 5 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/module/ulmer_social_widget" und setzen Sie das Häkchen sowohl in der Liste "Access Permission" als auch in "Modify Permission", dann speichern Sie.

============================================================
AUF EINE NEUE VERSION AKTUALISIEREN
============================================================
Der Extension Installer von OpenCart verhindert standardmäßig das Überschreiben von Dateien. So aktualisieren Sie das Modul über den Administrationsbereich:
1. Gehen Sie zu Extensions > Installer.
2. Suchen Sie den alten Eintrag "Ulmer Social Widget" in der Liste "Installed Extensions" am Ende der Seite.
3. Klicken Sie daneben auf die ROTE Schaltfläche Delete (Papierkorb).
   (Keine Sorge: Damit werden nur die alten Dateien entfernt, damit die neuen hochgeladen werden können. Ihre Moduleinstellungen, Links und Statistiken liegen sicher in der Datenbank und werden NICHT gelöscht!)
4. Laden Sie die neue Datei ulmer-social-widget-1.4.15.ocmod.zip hoch.
5. Gehen Sie zu Extensions > Modifications und klicken Sie auf Refresh.
6. Ganz wichtig: Leeren Sie den Theme-Cache über das blaue Zahnradsymbol im Dashboard!
7. Falls beim Bearbeiten des Moduls eine Meldung über fehlende Berechtigungen erscheint, prüfen Sie System > Users > User Groups: In Ihrer Gruppe muss "extension/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 (wenn der Installer nicht funktioniert)
============================================================
Nutzen Sie diesen Weg, wenn Ihr Hosting den Extension Installer blockiert. Er besteht aus ZWEI Schritten - der erste allein genügt nicht:

1. Öffnen Sie die .ocmod.zip, nehmen Sie den Ordner `upload` heraus und kopieren Sie dessen Inhalt in das Wurzelverzeichnis Ihres Shops (über die Ordner `admin` und `catalog`).
2. Nehmen Sie `install.xml` aus dem Wurzelverzeichnis der .ocmod.zip, benennen Sie die Datei in `ulmer.ocmod.xml` um und laden Sie sie in den Ordner `system/` Ihres Shops.
   Überspringen Sie Schritt 2 nicht: Genau diese Datei fügt das Widget in den Footer Ihres Themes ein. Mit Schritt 1 allein erscheint das Modul im Administrationsbereich, das Widget im Shop aber nie.

Danach: Klicken Sie unter Extensions > Modifications auf "Refresh" und leeren Sie dann den Theme-Cache im Dashboard (blaues Zahnradsymbol, Developer Settings) - sonst liefert der Administrationsbereich eine zwischengespeicherte alte Vorlage aus. Denken Sie auch an die Berechtigungen der Benutzergruppe (System > Users > User Groups).

Gut zu wissen: Auf diesem Weg installiert, erscheint das Modul nicht in der Liste unter Extensions > Modifications, und der Diagnose-Tab des Moduls meldet die Modifikation als fehlend. Bei einer manuell abgelegten Datei ist das zu erwarten, und das Widget funktioniert trotzdem.

============================================================
HÄUFIGE PROBLEME UNTER OC3
============================================================
* "Permission Denied!" beim Öffnen der Moduleinstellungen:
  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 das Häkchen für "extension/module/ulmer_social_widget" in der Access- und in der Modify-Liste.

* "Directory Not Allowed to be Written To" beim Hochladen:
  Das ist eine bekannte Sicherheitsbeschränkung von OC3, die einschränkt, wohin der Installer Dateien schreiben darf. Nutzen Sie die manuelle FTP-Installation oben oder installieren Sie das verbreitete Modul "Fix OC 3.x Extension Installer" aus dem OpenCart-Marketplace.

* "File could not be uploaded" / Hochladen bricht ohne Meldung ab:
  Sehr wahrscheinlich ist `upload_max_filesize` in der PHP-Konfiguration Ihres Hosters zu klein (zum Beispiel 2 MB). Erhöhen Sie den Wert in cPanel bzw. php.ini oder nutzen Sie die manuelle FTP-Installation.

* Fehler "Modification requires a unique ID code!":
  Sie laden eine Aktualisierung über eine bestehende Installation hoch. Löschen Sie ZUERST die alte Modifikation unter Extensions > Installer (siehe Abschnitt zur Aktualisierung, Schritt 3).

* Änderungen greifen nicht / das Widget erscheint nicht:
  OC3 hat einen äußerst hartnäckigen Twig-Cache. Ein Klick auf Refresh unter Modifications GENÜGT NICHT! Gehen Sie zum Dashboard, klicken Sie oben rechts auf das blaue Zahnradsymbol und leeren Sie den Theme-Cache. Leeren Sie außerdem alle Caches von Drittanbietern (NitroPack, LiteSpeed, Cloudflare).

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