71 lines
5.2 KiB
Plaintext
71 lines
5.2 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
|
|
Online 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
|
|
--------------------------------------------------------------------------------
|
|
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 (or module/img_opti on OC 2.0-2.2).
|
|
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 Database Stats: Displays total optimized files, total saved MB, and average savings percentage stored safely in site DB (accumulates across Optimization, Cleaner, Tools & Cron). Includes [Reset Statistics] button.
|
|
- Full Export / Import (JSON): Export and restore 100% of module settings (Cron tasks, watermark rules, placeholders, folder limits, format guards).
|
|
- Online Web-Instruction Button: Direct link to the complete web documentation at http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html.
|
|
|
|
TAB 2: OPTIMIZE & RESIZE (COMPRESSION)
|
|
1. Enter your License Key (Token) in the respective field.
|
|
2. Select target processing engine: GD (Standard) or Imagick (Advanced). Actions are explicitly labelled (GD / Imagick).
|
|
3. Select target folders inside image/catalog/.
|
|
4. Choose Mode: "Create a copy" (Safest) or "Replace originals".
|
|
5. Set maximum Width/Height and WebP/JPG/PNG quality settings.
|
|
6. Click "START OPTIMIZATION". Balanced 50/50 Pause & Stop UI controls allow full control during batch execution.
|
|
|
|
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 junk files to image/catalog_trash/, or "Delete permanently" to wipe them from the server.
|
|
|
|
TAB 4: FORMATS (WEBP & FAKE JPG GUARD)
|
|
- On-the-Fly Fake JPG Guard: Detects PNG binary headers inside .jpg extensions and auto-converts or replaces them on-the-fly to eliminate black background glitches on the storefront.
|
|
- WebP "on-the-fly", SVG support, and progressive Lazy Load with blur-up.
|
|
|
|
TAB 5: WATERMARKS
|
|
- Dynamic Overlay rules: Set up watermarks (image or text) on-the-fly with position, transparency, angle, font, and category filters.
|
|
|
|
TAB 6: PLACEHOLDERS
|
|
- Renders fallback images for products, categories, or brands without images.
|
|
|
|
TAB 7: TOOLS (PRO) & CRON SCHEDULER
|
|
- Name Sanitizer, CMYK to sRGB Converter, Black Background Fixer.
|
|
- Cron background scheduler for continuous automated store optimization.
|