================================================================================
Image Optimizer [NAT]: Compress originals & remove unused images v1.2.0
================================================================================

Thank you for purchasing our extension! 
If you have any questions, feel free to contact us: info@nat.od.ua
Online Web Documentation: http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html


--------------------------------------------------------------------------------
TERMS & CONDITIONS (License & Support Policy)
--------------------------------------------------------------------------------
By purchasing and downloading this extension, you strictly agree to the following terms:

1. Single Domain License: One purchase allows you to install and use the extension on exactly one (1) live domain and one (1) local/test environment. You need a separate License Key for each additional live project.
2. License Activation: The module requires a License Key to function. Please email info@nat.od.ua with your Order ID and Domain Name after purchase to receive your key.
3. Support: We provide free technical support for bugs and standard installation issues. Support is available via email (info@nat.od.ua). Please allow up to 24-48 hours for a response.
4. Compatibility: The module is guaranteed to work on standard OpenCart / ocStore installations. We cannot guarantee out-of-the-box compatibility with heavily customized core files or third-party checkout/theme modules, though we will do our best to assist you.
5. Refund Policy: We offer a 100% refund if the extension is completely non-functional on a standard OpenCart setup and our support team is unable to fix it. We do not issue refunds for "change of mind" or if you have already requested and received a domain license key.
6. Distribution: The code is open-source, meaning you can modify it for your own needs. However, you may not resell, redistribute, share, or publish this extension in any form.


--------------------------------------------------------------------------------
INSTALLATION & UPGRADE
--------------------------------------------------------------------------------
1. Extract the archive.
2. Upload the contents of the upload/ folder to your OpenCart root directory via FTP (no core files will be overwritten).
3. Go to OpenCart Admin -> System -> Users -> User Groups. Select Administrator and check both "Access" and "Modify" permissions for extension/module/img_opti (or module/img_opti on OC 2.0-2.2).
4. Go to Extensions -> Extensions -> Modules. Find "Image Optimizer [NAT]" and click "Install", then "Edit".


--------------------------------------------------------------------------------
EXHAUSTIVE TAB-BY-TAB MODULE GUIDE
--------------------------------------------------------------------------------
WARNING: Always create a full backup of your /image/catalog/ folder before running any optimizations or deletions!

TAB 1: MODULE SETTINGS & SYSTEM STATUS
- Engine Selection: GD (Standard) or Imagick (Advanced) with explicit GD/Imagick action labelling across all scanning tools.
- Individual Folder Rules: Set per-folder custom JPG/WebP quality and max width/height overrides.
- Disk Usage Chart: Renders a pie chart of folder sizes (Catalog, Cache, Trash) with manual quota limit override.
- Server-side Persistent DB Statistics: Stores total processed files, saved MB, and average savings percentage in site database (oc_setting) with a [Reset Statistics] button.
- Full Settings Export / Import (JSON): Backup and restore 100% of module settings (cron tasks, watermark rules, placeholders, folder rules, formats, limits).
- Online Web-Instruction Button: Direct link to complete web documentation.

TAB 2: OPTIMIZE & RESIZE (COMPRESSION)
- Multi-folder Tree Selection: Select specific subfolders inside image/catalog/.
- Safe Copy vs Replace Originals: Choose between creating a backup copy (catalog_new) or replacing originals directly.
- Dimension Limits & Quality Controls: Max width/height, JPG quality (0-100), PNG quality (0-9), WebP quality (0-100).
- Performance & Multi-threading: Batch chunk size, log screen lines, and multi-threading execution controls.
- Savings Replacement Thresholds: Minimum byte/percent savings required to replace files.
- Interactive Controls: Balanced 50/50 Pause & Stop controls during active processing, plus cache clear button.

TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL)
- Deep DB & Theme File Scanning: Scans product, category, manufacturer, banner images, and checks theme files (.tpl, .twig, .php, .css, .js) to prevent accidental deletion of active graphics.
- Safe Quarantine & permanent deletion: Move unused files to image/catalog_trash/ with one-click restore capability, or delete permanently.

TAB 4: IMAGE FORMATS & PROTECTION
- Support SVG & WebP: Enable native SVG uploading and WebP conversion (including TrueFileManager integration).
- WebP "On-the-Fly": Generates WebP images dynamically when requested by storefront browsers.
- Progressive Lazy Load: Applies blur-up progressive image loading on product lists.
- On-the-Fly Fake JPG Guard: Binary PNG header detection inside .jpg extension to eliminate black background glitches on the storefront. Mode dropdown toggle: Convert to white JPG vs save as transparent PNG.
- Fallback Image: Global placeholder image override for broken image links.

TAB 5: TOOLS (PRO) & VISUAL PREVIEW (19 SPECIALIZED UTILITIES)
1. broken_db: Finds DB entries with missing physical files.
2. broken_files: Scans for binary-corrupted or zero-byte truncated images.
3. empty_folders: Scans and purges empty catalog subdirectories.
4. folder_tree: Deep size and file count analysis per subfolder.
5. html_broken: Scans product/category HTML for 404 image links.
6. small_photos: Identifies low-res photos under dimension limits.
7. duplicates: Finds exact duplicate images using MD5 content hashes.
8. heavy_files: Flags raw oversized images exceeding KB limits.
9. cmyk: Detects CMYK color space images and auto-converts to sRGB.
10. svg_security: Strips malicious JS scripts and XSS from SVG files.
11. black_bg: Edge-only floodfill repair of black background borders.
12. watermark: Batch watermarking utility.
13. placeholders: Batch placeholder assignment for missing assets.
14. png_jpg: Mass converts heavy PNGs to JPG/WebP and updates DB.
15. exif: Strips camera/GPS metadata for 10-15% size reduction.
16. smart_cache: Selective expired image cache purger.
17. sanitizer: Cleans file paths of spaces, Cyrillic, and illegal chars.
18. translit: Transliterates Cyrillic filenames to SEO Latin.
19. cache_restore: Recovers deleted original photos from high-res cache.

TAB 6: WATERMARKS
- Dynamic On-the-Fly Overlays: Apply image or text watermarks dynamically on products, categories, brands, or banners.
- Customization: Position, opacity, angle, TTF font, size scaling, and category exclusion/inclusion rules.

TAB 7: PLACEHOLDERS
- Automatic fallback image replacement for products, categories, and brands without an assigned image.

TAB 8: CRON BACKGROUND SCHEDULER
- Automated Background Runner: Set up scheduled cron tasks (daily, weekly, monthly) for compression, junk cleaning, name sanitizing, and black background fixing without manual admin interaction.

TAB 9: INFO & ECOSYSTEM [NAT]
- Module suite promotion, support contact info, and online web documentation button.