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

This archive contains:
  - ulmer-social-widget-...-oc3x.ocmod.zip   the file you install
  - README_OC3_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)
============================================================
1. In the OpenCart admin: Extensions > Installer.
   Upload the file: ulmer-social-widget-...-oc3x.ocmod.zip
2. Go to Extensions > Modifications and click the blue Refresh button (top-right).
3. Go to Dashboard, click the blue gear icon (Developer Settings) in the top-right corner, and refresh the Theme cache.
4. Go to Extensions > Extensions, choose "Modules" in the dropdown, find "Ulmer Social Widget" and click the green Install (+) button.
5. Click Edit (pencil) on the module to open its settings.
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!

============================================================
UPDATING TO A NEW VERSION
============================================================
OpenCart's Extension Installer prevents overwriting files by default. To update the module via the admin panel, follow these steps:
1. Go to Extensions > Installer.
2. Find the old "Ulmer Social Widget" entry in the "Installed Extensions" list at the bottom of the page.
3. Click the RED Delete (Trash) button next to it. 
   (Don't worry: this only deletes the old files to allow uploading the new ones. Your module settings, links, and stats are safely stored in the database and will NOT be deleted!).
4. Upload the new ulmer-social-widget-...-oc3x.ocmod.zip file.
5. Go to Extensions > Modifications and click Refresh.
6. Crucially, refresh the Theme cache via the blue gear icon on your Dashboard!

============================================================
MANUAL FTP INSTALLATION / UPDATING (Recommended!)
============================================================
If you prefer manual upload:
Extract the contents of the `upload` folder from the archive directly into your store's root directory (over the `admin` and `catalog` folders).
IMPORTANT: Afterwards, you must clear the theme cache! To do this, go to Dashboard, click the blue gear icon (Developer Settings) in the top-right, and clear the cache. Also click "Refresh" in Extensions > Modifications. Otherwise, the admin panel will serve a cached older version of the template.

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