104 lines
6.5 KiB
Plaintext
104 lines
6.5 KiB
Plaintext
================================================================================
|
|
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. |