Ulmer Social Widget
Free floating social / contact widget for OpenCart 4.0.x
by EmeraldWeb - https://emeraldweb.de

This archive contains:
  - ulmer_social_widget.ocmod.zip            the file you upload in admin
  - README_OC4_EN.txt / UK / RU              this guide (3 languages)
  - LICENSE.txt                                      license terms
  - DATENSCHUTZ.md                                   privacy notice

============================================================
BEFORE YOU START (IMPORTANT!)
============================================================
We highly recommend making a full backup of your store's files and database before installing or updating any extensions. As the saying goes, the world is divided into two types of people: those who already make backups, and those who spend half the night restoring their site! :)

============================================================
INSTALLATION (FOR NEW USERS)
============================================================
Attention: In OpenCart 4, the file MUST be named "ulmer_social_widget.ocmod.zip". Do not rename it!

1. In the OpenCart admin, go to: Extensions > Installer.
   Click the Upload button and select the ulmer_social_widget.ocmod.zip file.
2. Find the uploaded extension in the list below and click the green Install (+) button next to it. (This is required in OC4, it copies files and registers them in the database!).
3. Go to Extensions > Extensions, choose the "Modules" filter, find "Ulmer Social Widget" and click the green Install (+) button.
4. Go to System > Users > User Groups. Edit your Top Administrator group, find "extension/ulmer_social_widget/module/ulmer_social_widget" and check both the "Access Permission" and "Modify Permission" boxes. Save.
5. Go back to Extensions > Extensions > Modules and click Edit (pencil) next to "Ulmer Social Widget".
6. All channels are OFF by default. Turn on the 3-5 channels you actually use, fill in each link, and Save.
7. Open your storefront - the floating button appears in the corner!
(In OpenCart 4, you no longer need to refresh Modifications).

============================================================
UPDATING TO A NEW VERSION
============================================================
1. Go to Extensions > Installer.
2. Find the old "ulmer_social_widget" in the list and click the RED Delete (Trash) button next to it. 
   (Don't worry: this only deletes the old files. Your settings and stats are safely stored in the database and will NOT be deleted!).
3. Click Upload and select the new ulmer_social_widget.ocmod.zip file.
4. Click the green Install (+) button next to it in the list again.
5. IMPORTANT: Go to the Dashboard, click the blue gear icon (Developer Settings) in the top right corner and clear the Template cache. Otherwise, the admin panel might show the old cached version.
6. If you get a "Permission Denied" error when opening the module, ensure you granted permissions again in System > Users > User Groups for "extension/ulmer_social_widget/module/ulmer_social_widget".

============================================================
MANUAL FTP INSTALLATION / UPDATING
============================================================
Attention! In OpenCart 4, manual installation via FTP (simply copying folders) no longer works due to the new engine architecture. 
OpenCart 4 requires every extension file to be explicitly registered in the database (for the autoloader). 
Therefore, please always use the built-in Extension Installer (see instructions above).

============================================================
OC4 TROUBLESHOOTING & COMMON PITFALLS
============================================================
* Error: "You do not have permission to access this page" when opening settings:
  You forgot to assign permissions! Go to System > Users > User Groups, edit your admin group, and check both boxes for "extension/ulmer_social_widget/module/ulmer_social_widget".

* Broken installation / "Could not find install.json" / Mac Safari users:
  Mac Safari automatically unzips downloaded files. If you re-zip the downloaded folder yourself, the `install.json` will be inside a subfolder, causing the installation to fail. You MUST zip the files directly so that `install.json` is at the very ROOT of the `.zip` archive. Or simply download the file using Chrome/Firefox to avoid Safari's auto-unzip feature.

* Broken MVC-L / Missing class errors / Browser renamed the file:
  The uploaded file MUST be named exactly `ulmer_social_widget.ocmod.zip`. If you download the file twice, your browser might rename it to `ulmer_social_widget.ocmod (1).zip`. If you upload the renamed file, OpenCart 4 will create a corrupted folder name, breaking the entire namespace. Always rename the file back to `ulmer_social_widget.ocmod.zip` before uploading!

* Error: "File already exists":
  If a previous installation attempt timed out or failed, OpenCart 4 leaves temporary files behind. You must use FTP or your hosting File Manager to delete the leftover files in `system/storage/marketplace/` and `extension/ulmer_social_widget/` before trying to install again.

* Upload progress bar freezes / JSON.parse errors:
  This usually means your server's PHP `upload_max_filesize` or `post_max_size` is too small (e.g. 2MB). Increase these limits in your hosting control panel (cPanel) or contact your host. Also ensure your `system/storage/` directory is writable.


============================================================
SUPPORT & HELP
============================================================
Running into a problem or something went wrong? Reach out to us, and we will try our best to help!
Please note: this module is provided completely free of charge, so support is provided on a best-effort basis. Due to high workload, a response might occasionally take some time. Thank you for your understanding!

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