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

This archive contains:
  - ulmer-social-widget-...-oc2x.ocmod.zip   the file you install
  - README_OC2_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)
============================================================
NOTE: In OpenCart 2.3.x, the built-in installer requires FTP to be configured. If you get an error during upload, make sure you have the popular 'QuickFix / LocalCopy' extension installed, or use the manual FTP method below.

1. In the OpenCart admin: Extensions > Installer.
   Upload the file: ulmer-social-widget-1.4.13-oc2x.ocmod.zip
2. Go to Extensions > Modifications and click the blue Refresh button (top-right).
3. Go to Extensions > Extensions, choose "Modules" in the dropdown, find "Ulmer Social Widget" and click the green Install (+) button.
4. Click Edit (pencil) on the module to open its settings.
5. All channels are OFF by default. Turn on the 3-5 channels you actually use, fill in each link, and Save.
6. 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-...-oc2x.ocmod.zip file.
5. You must go to Extensions > Modifications and click Refresh.

============================================================
MANUAL FTP INSTALLATION / UPDATING
============================================================
If the standard installer gives FTP errors, use this method:
1. Extract the contents of the `upload` folder from the archive directly into your store's root directory (over the `admin` and `catalog` folders) via FTP.
2. IMPORTANT: Extract the `install.xml` file from the root of the archive, rename it to `ulmer.ocmod.xml`, and upload it via Extensions > Installer. Without this step, the widget will not appear on the storefront!
3. Go to Extensions > Modifications and click the "Refresh" button.

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