================================================================================ 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 -------------------------------------------------------------------------------- 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 (no IonCube), meaning you can modify it for your own needs. However, you may not resell, redistribute, share, or publish this extension in any form. -------------------------------------------------------------------------------- INSTALLATION -------------------------------------------------------------------------------- 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 your group (Administrator) and check both "Access" and "Modify" permissions for `extension/module/img_opti`. 4. Go to Extensions -> Extensions -> Modules. Find "Image Optimizer [NAT]" and click the "Install" (green plus) button. 5. Click the "Edit" button to access the module panel. -------------------------------------------------------------------------------- HOW TO USE (TABS & FEATURES) -------------------------------------------------------------------------------- WARNING: Always create a full backup of your `/image/catalog/` folder before running any optimizations or deletions! TAB 1: INFO & STATS - Disk Usage Chart: Renders a pie chart of folder sizes (Image Catalog, Cache, Trash). Supports manual hosting quota limit overrides and auto-update toggling on page open. - Cumulative Stats: Displays total optimized files and total disk space saved. TAB 2: OPTIMIZE & RESIZE (COMPRESSION) 1. Enter your License Key (Token) in the respective field. 2. Select the target folders inside `image/catalog/` you want to process. 3. Choose the Mode: "Create a copy" (Safest) or "Replace originals". 4. Set your maximum Width/Height and WebP/JPG/PNG quality settings. 5. Click "START OPTIMIZATION". The module will process files in batches using AJAX without overloading your server. TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL) 1. Select the folders to scan. 2. Click "FIND JUNK". The module compares physical files on disk with your Database and Theme files. 3. Review the detailed log of unused files. 4. Click "To Quarantine" to safely move the junk files to `image/catalog_trash/`, or "Delete permanently" to wipe them from the server. 5. You can easily restore files from Quarantine with one click if something goes wrong. TAB 4: WATERMARKS - Dynamic Overlay rules: Set up watermarks (image or text) to overlay on category, brand, banner, or product images on-the-fly. - Position, transparency, angle, font (TTF), size scaling, and category exclusion/inclusion filters are fully supported. TAB 5: PLACEHOLDERS - Renders fallback images for products, categories, or brands that do not have an image assigned in the database, keeping the storefront look consistent. TAB 6: IMAGE FORMATS (🧪 BETA) - WebP Support: Enable WebP on-the-fly delivery. - SVG Support: Safe SVG rendering. - Progressive Lazy Loading: Blur-up effect (loads micro-preview and fades/de-blurs smoothly as user scrolls). - Fallback Image: Set global placeholder image for broken images. TAB 7: TOOLS (PRO) (🧪 BETA) - Filename Sanitizer: Clear names of cyrillic letters, spaces, and special symbols in file and directory paths. - Broken DB Scanner: Finds and fixes database records referencing non-existent files. - Broken Files Scanner: Scans the server to clean up corrupted or 0-byte images. - Heavy Files: Find the largest images on disk and optimize them instantly. - CMYK Converter: Convert color space of JPEG files from CMYK to sRGB for Apple iOS/Safari compatibility. TAB 8: CRON (🧪 BETA) - Configure automated background directory scans and image compression schedules using a Cron token. -------------------------------------------------------------------------------- UNINSTALLATION -------------------------------------------------------------------------------- 1. Uninstall the module from the Extensions list in your OpenCart Admin. 2. Delete the module files from: - admin/controller/extension/module/img_opti.php - admin/language/*/extension/module/img_opti.php - admin/view/template/extension/module/img_opti.twig -------------------------------------------------------------------------------- 🔥 CHECK OUT OUR OTHER OPENCART MODULES: -------------------------------------------------------------------------------- Maximize your store's performance with our professional toolset: • Catalog Optimizer [NAT]: Hide empty categories/brands, clear unused attributes/options. • Domain Scanner [NAT]: Find and clean external links and images. • Promo Top Bar [NAT]: Create interactive promo bars, marquees and header slideshows. 👉 View all our extensions here: https://www.opencart.com/index.php?route=marketplace/extension&filter_member=nat.odua ================================================================================ Support info@nat.od.ua | All rights reserved.