From cbf05b88b0b6354d390a9ec22d591663c2d0f087 Mon Sep 17 00:00:00 2001 From: nertyog Date: Fri, 7 Aug 2026 04:29:18 +0300 Subject: [PATCH] docs: expand documentation to cover all 9 tabs, nuances, and rebuild release packages v1.2.0 --- docs/instructions.txt | 62 +++++++++-------- docs/readme.txt | 73 ++++++++++++--------- image_optimizer_nat_OC_20_22_1_1.ocmod.zip | Bin 784802 -> 786729 bytes instructions.txt | 62 +++++++++-------- readme.txt | 73 ++++++++++++--------- 5 files changed, 152 insertions(+), 118 deletions(-) diff --git a/docs/instructions.txt b/docs/instructions.txt index bbc21d0..8b8cea4 100644 --- a/docs/instructions.txt +++ b/docs/instructions.txt @@ -6,57 +6,63 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- -🇺🇦 УКРАЇНСЬКА МОВА (UKRAINIAN) +🇺АКРАЇНСЬКА МОВА (UKRAINIAN) -------------------------------------------------------------------------------- -ВСТАНОВЛЕННЯ МОДУЛЯ: +ВСТАНОВЛЕННЯ ТА ОНОВЛЕННЯ: 1. Розпакуйте архів. 2. Завантажте вміст папки upload/ у корінь вашого сайту по FTP. 3. Перейдіть в "Система" -> "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2). 4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати". -ФУНКЦІОНАЛ ТА ВКТАДКИ: -- Вкладка 1 (Інфо та статистика): Графік диска, накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON та кнопка переходу до Онлайн Інструкції. -- Вкладка 2 (Стиснення та Ресайз): Вибір движка (GD або Imagick з маркуванням дій), розмірів, якості WebP/JPG/PNG та вибір папок. -- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень, відправка у Карантин або остаточне видалення. -- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard), WebP на льоту, SVG, Lazy Load. -- Вкладка 5 (Водяні знаки): Накладання водяних знаків (текст/фото) на льоту. -- Вкладка 6 (Заглушки): Автозаміна відсутніх фото товарів, категорій та брендів. -- Вкладка 7 (Інструменти & Крон): Санітайзер імен, конвертер CMYK у sRGB, виправлення чорних фонів, планувальник Cron. +ПОВНИЙ ОГЛЯД ВСІХ 9 ВКЛАДОК ТА ФУНКЦІОНАЛУ: +- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з явним маркуванням дій), накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції. +- Вкладка 2 (Стиснення та Ресайз): Вибір папок каталогу, режим безпечної копії (catalog_new) або заміни оригіналів, налаштування макс. ширини/висоти, якості (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очищення від сміття): Глибоке сканування БД та файлів шаблону (.tpl, .twig, .php, .css, .js), безпечний Карантин (image/catalog_trash/) з відновленням в один клік або остаточне видалення. +- Вкладка 4 (Формати & Захист): Автоматичний захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань. +- Вкладка 5 (Інструменти Pro & Попередній перегляд): Санітайзер імен (очищення кирилиці й спецсимволів), конвертер колірного простору CMYK у sRGB, виправлення чорного фону (Edge-only floodfill) та порядковий візуальний порівняльний перегляд. +- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту з прозорістю, кутом, шрифтом TTF та фільтрацією за категоріями. +- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок для товарів, категорій та брендів без фото. +- Вкладка 8 (Крон-завдання): Автоматичний фоновий запуск стиснення, очищення, санітайзера та виправлення чорних фонів за розкладом (щодня, щотижня, щомісяця). +- Вкладка 9 (Інфо & Екосистема [NAT]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції. -------------------------------------------------------------------------------- 🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN) -------------------------------------------------------------------------------- -УСТАНОВКА МОДУЛЯ: +УСТАНОВКА И ОБНОВЛЕНИЕ: 1. Распакуйте архив. 2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP. 3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2). 4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать". -ФУНКЦИОНАЛ И ВКЛАДКИ: -- Вкладка 1 (Инфо и статистика): График диска, накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON и кнопка перехода к Онлайн Инструкции. -- Вкладка 2 (Сжатие и Ресайз): Выбор движка (GD или Imagick с маркировкой действий), размеров, качества WebP/JPG/PNG и выбор папок. -- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых изображений, отправка в Карантин или окончательное удаление. -- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load. -- Вкладка 5 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету. -- Вкладка 6 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов. -- Вкладка 7 (Инструменты & Крон): Санитайзер имен, конвертер CMYK в sRGB, исправление черных фонов, планировщик Cron. +ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА: +- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick (с четкой маркировкой действий), накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции. +- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим безопасной копии (catalog_new) или замены оригиналов, настройки макс. ширины/высоты, качества (WebP/JPG/PNG), многопоточность, пороги экономии и симметричные кнопки [ПАУЗА] и [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очистка от мусора): Глубокое сканирование БД и файлов шаблона (.tpl, .twig, .php, .css, .js), безопасный Карантин (image/catalog_trash/) с восстановлением в один клик или окончательное удаление. +- Вкладка 4 (Форматы & Защита): Автоматическая защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard с выбором режима белый JPG / прозрачный PNG), WebP на лету, SVG, Lazy Load (blur-up) и заглушка для битых ссылок. +- Вкладка 5 (Инструменты Pro & Предпросмотр): Санитайзер имен (очистка кириллицы и спецсимволов), конвертер цветового пространства CMYK в sRGB, исправление черного фона (Edge-only floodfill) и построчный визуальный сравнительный предпросмотр. +- Вкладка 6 (Водяные знаки): Динамическое наложение водяных знаков (изображение или текст) на лету с прозрачностью, углом, шрифтом TTF и фильтрацией по категориям. +- Вкладка 7 (Заглушки): Автоподстановка изображений-заглушек для товаров, категорий и брендов без фото. +- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск сжатия, очистки, санитайзера и исправления черных фонов по расписанию (ежедневно, еженедельно, ежемесячно). +- Вкладка 9 (Инфо & Экосистема [NAT]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. -------------------------------------------------------------------------------- 🇬🇧 ENGLISH -------------------------------------------------------------------------------- -INSTALLATION: +INSTALLATION & UPGRADE: 1. Extract the archive. 2. Upload the contents of upload/ to your OpenCart root directory via FTP. 3. Go to System -> Users -> User Groups. Select Administrator and set Access/Modify permissions for extension/module/img_opti (or module/img_opti for OC 2.0-2.2). 4. Go to Extensions -> Modules, install "Image Optimizer [NAT]", and click Edit. -FEATURES & TABS: -- Tab 1 (Info & Stats): Disk chart, persistent DB stats with reset button, 100% full JSON settings export/import, online instruction link button. -- Tab 2 (Compression): GD / Imagick engine selection with labelled actions, batch resizing, WebP/JPG/PNG quality controls. -- Tab 3 (Cleaner): Smart search for unused catalog photos, safe quarantine and permanent deletion. -- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard protection, WebP on-the-fly, SVG, Lazy Load. -- Tab 5 (Watermarks): On-the-fly image and text watermarks with position and opacity rules. -- Tab 6 (Placeholders): Fallback images for missing photos. -- Tab 7 (Tools & Cron): Name Sanitizer, CMYK to sRGB converter, Black BG repair, Cron background runner. +EXHAUSTIVE 9-TAB MODULE OVERVIEW: +- Tab 1 (Settings & Stats): GD / Imagick engine choice with labelled actions, persistent DB stats with [Reset Statistics] button, 100% full JSON settings export/import, individual folder rules, online instruction button. +- Tab 2 (Compression): Catalog folder tree, Safe Copy vs Replace mode, max width/height limits, WebP/JPG/PNG quality, multi-threading, savings replacement thresholds, 50/50 Pause & Stop controls. +- Tab 3 (Cleaner): Deep scanning of DB tables and theme files (.tpl, .twig, .php, .css, .js), safe Quarantine with 1-click restore, or permanent deletion. +- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard (white JPG vs transparent PNG toggle), WebP on-the-fly, SVG, Lazy Load (blur-up), fallback image override. +- Tab 5 (Tools Pro & Preview): Name Sanitizer, CMYK to sRGB converter, Black Background Fixer (Edge-only floodfill), and per-row side-by-side comparison modal. +- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays with opacity, angle, TTF font, and category filtering. +- Tab 7 (Placeholders): Fallback placeholder replacement for products, categories, and brands. +- Tab 8 (Cron Scheduler): Automated background runner for daily, weekly, or monthly scheduled jobs. +- Tab 9 (Info & Ecosystem): Disk space pie chart, support contacts, and online instruction button. diff --git a/docs/readme.txt b/docs/readme.txt index 58548e3..6266161 100644 --- a/docs/readme.txt +++ b/docs/readme.txt @@ -4,7 +4,7 @@ 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 +Online Web Documentation: http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- @@ -21,50 +21,61 @@ By purchasing and downloading this extension, you strictly agree to the followin -------------------------------------------------------------------------------- -INSTALLATION +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 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. +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". -------------------------------------------------------------------------------- -HOW TO USE (TABS & FEATURES) +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: 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 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) -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. +- 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) -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. +- 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: 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 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: WATERMARKS -- Dynamic Overlay rules: Set up watermarks (image or text) on-the-fly with position, transparency, angle, font, and category filters. +TAB 5: TOOLS (PRO) & VISUAL PREVIEW +- File & Folder Name Sanitizer: Cleans Cyrillic characters, spaces, and special symbols from filenames. +- CMYK to sRGB Converter: Converts CMYK printing colorspace to sRGB web colorspace. +- Black Background Fixer: Edge-only perimeter floodfill replacement of black borders from transparent PNGs converted improperly to JPG. +- Per-row Visual Preview: Compare original vs processed image side-by-side in modal dialog before applying changes. -TAB 6: PLACEHOLDERS -- Renders fallback images for products, categories, or brands without images. +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: TOOLS (PRO) & CRON SCHEDULER -- Name Sanitizer, CMYK to sRGB Converter, Black Background Fixer. -- Cron background scheduler for continuous automated store optimization. +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. diff --git a/image_optimizer_nat_OC_20_22_1_1.ocmod.zip b/image_optimizer_nat_OC_20_22_1_1.ocmod.zip index 9930e35ca67ec036aabb37210ca7f51074f41fd1..0c6703e63569935f22a8c4b8fce2a32183a49110 100644 GIT binary patch delta 7572 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 YJ3DEq "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2). 4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати". -ФУНКЦІОНАЛ ТА ВКТАДКИ: -- Вкладка 1 (Інфо та статистика): Графік диска, накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON та кнопка переходу до Онлайн Інструкції. -- Вкладка 2 (Стиснення та Ресайз): Вибір движка (GD або Imagick з маркуванням дій), розмірів, якості WebP/JPG/PNG та вибір папок. -- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень, відправка у Карантин або остаточне видалення. -- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard), WebP на льоту, SVG, Lazy Load. -- Вкладка 5 (Водяні знаки): Накладання водяних знаків (текст/фото) на льоту. -- Вкладка 6 (Заглушки): Автозаміна відсутніх фото товарів, категорій та брендів. -- Вкладка 7 (Інструменти & Крон): Санітайзер імен, конвертер CMYK у sRGB, виправлення чорних фонів, планувальник Cron. +ПОВНИЙ ОГЛЯД ВСІХ 9 ВКЛАДОК ТА ФУНКЦІОНАЛУ: +- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з явним маркуванням дій), накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції. +- Вкладка 2 (Стиснення та Ресайз): Вибір папок каталогу, режим безпечної копії (catalog_new) або заміни оригіналів, налаштування макс. ширини/висоти, якості (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очищення від сміття): Глибоке сканування БД та файлів шаблону (.tpl, .twig, .php, .css, .js), безпечний Карантин (image/catalog_trash/) з відновленням в один клік або остаточне видалення. +- Вкладка 4 (Формати & Захист): Автоматичний захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань. +- Вкладка 5 (Інструменти Pro & Попередній перегляд): Санітайзер імен (очищення кирилиці й спецсимволів), конвертер колірного простору CMYK у sRGB, виправлення чорного фону (Edge-only floodfill) та порядковий візуальний порівняльний перегляд. +- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту з прозорістю, кутом, шрифтом TTF та фільтрацією за категоріями. +- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок для товарів, категорій та брендів без фото. +- Вкладка 8 (Крон-завдання): Автоматичний фоновий запуск стиснення, очищення, санітайзера та виправлення чорних фонів за розкладом (щодня, щотижня, щомісяця). +- Вкладка 9 (Інфо & Екосистема [NAT]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції. -------------------------------------------------------------------------------- 🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN) -------------------------------------------------------------------------------- -УСТАНОВКА МОДУЛЯ: +УСТАНОВКА И ОБНОВЛЕНИЕ: 1. Распакуйте архив. 2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP. 3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2). 4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать". -ФУНКЦИОНАЛ И ВКЛАДКИ: -- Вкладка 1 (Инфо и статистика): График диска, накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON и кнопка перехода к Онлайн Инструкции. -- Вкладка 2 (Сжатие и Ресайз): Выбор движка (GD или Imagick с маркировкой действий), размеров, качества WebP/JPG/PNG и выбор папок. -- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых изображений, отправка в Карантин или окончательное удаление. -- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load. -- Вкладка 5 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету. -- Вкладка 6 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов. -- Вкладка 7 (Инструменты & Крон): Санитайзер имен, конвертер CMYK в sRGB, исправление черных фонов, планировщик Cron. +ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА: +- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick (с четкой маркировкой действий), накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции. +- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим безопасной копии (catalog_new) или замены оригиналов, настройки макс. ширины/высоты, качества (WebP/JPG/PNG), многопоточность, пороги экономии и симметричные кнопки [ПАУЗА] и [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очистка от мусора): Глубокое сканирование БД и файлов шаблона (.tpl, .twig, .php, .css, .js), безопасный Карантин (image/catalog_trash/) с восстановлением в один клик или окончательное удаление. +- Вкладка 4 (Форматы & Защита): Автоматическая защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard с выбором режима белый JPG / прозрачный PNG), WebP на лету, SVG, Lazy Load (blur-up) и заглушка для битых ссылок. +- Вкладка 5 (Инструменты Pro & Предпросмотр): Санитайзер имен (очистка кириллицы и спецсимволов), конвертер цветового пространства CMYK в sRGB, исправление черного фона (Edge-only floodfill) и построчный визуальный сравнительный предпросмотр. +- Вкладка 6 (Водяные знаки): Динамическое наложение водяных знаков (изображение или текст) на лету с прозрачностью, углом, шрифтом TTF и фильтрацией по категориям. +- Вкладка 7 (Заглушки): Автоподстановка изображений-заглушек для товаров, категорий и брендов без фото. +- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск сжатия, очистки, санитайзера и исправления черных фонов по расписанию (ежедневно, еженедельно, ежемесячно). +- Вкладка 9 (Инфо & Экосистема [NAT]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. -------------------------------------------------------------------------------- 🇬🇧 ENGLISH -------------------------------------------------------------------------------- -INSTALLATION: +INSTALLATION & UPGRADE: 1. Extract the archive. 2. Upload the contents of upload/ to your OpenCart root directory via FTP. 3. Go to System -> Users -> User Groups. Select Administrator and set Access/Modify permissions for extension/module/img_opti (or module/img_opti for OC 2.0-2.2). 4. Go to Extensions -> Modules, install "Image Optimizer [NAT]", and click Edit. -FEATURES & TABS: -- Tab 1 (Info & Stats): Disk chart, persistent DB stats with reset button, 100% full JSON settings export/import, online instruction link button. -- Tab 2 (Compression): GD / Imagick engine selection with labelled actions, batch resizing, WebP/JPG/PNG quality controls. -- Tab 3 (Cleaner): Smart search for unused catalog photos, safe quarantine and permanent deletion. -- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard protection, WebP on-the-fly, SVG, Lazy Load. -- Tab 5 (Watermarks): On-the-fly image and text watermarks with position and opacity rules. -- Tab 6 (Placeholders): Fallback images for missing photos. -- Tab 7 (Tools & Cron): Name Sanitizer, CMYK to sRGB converter, Black BG repair, Cron background runner. +EXHAUSTIVE 9-TAB MODULE OVERVIEW: +- Tab 1 (Settings & Stats): GD / Imagick engine choice with labelled actions, persistent DB stats with [Reset Statistics] button, 100% full JSON settings export/import, individual folder rules, online instruction button. +- Tab 2 (Compression): Catalog folder tree, Safe Copy vs Replace mode, max width/height limits, WebP/JPG/PNG quality, multi-threading, savings replacement thresholds, 50/50 Pause & Stop controls. +- Tab 3 (Cleaner): Deep scanning of DB tables and theme files (.tpl, .twig, .php, .css, .js), safe Quarantine with 1-click restore, or permanent deletion. +- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard (white JPG vs transparent PNG toggle), WebP on-the-fly, SVG, Lazy Load (blur-up), fallback image override. +- Tab 5 (Tools Pro & Preview): Name Sanitizer, CMYK to sRGB converter, Black Background Fixer (Edge-only floodfill), and per-row side-by-side comparison modal. +- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays with opacity, angle, TTF font, and category filtering. +- Tab 7 (Placeholders): Fallback placeholder replacement for products, categories, and brands. +- Tab 8 (Cron Scheduler): Automated background runner for daily, weekly, or monthly scheduled jobs. +- Tab 9 (Info & Ecosystem): Disk space pie chart, support contacts, and online instruction button. diff --git a/readme.txt b/readme.txt index 58548e3..6266161 100644 --- a/readme.txt +++ b/readme.txt @@ -4,7 +4,7 @@ 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 +Online Web Documentation: http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- @@ -21,50 +21,61 @@ By purchasing and downloading this extension, you strictly agree to the followin -------------------------------------------------------------------------------- -INSTALLATION +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 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. +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". -------------------------------------------------------------------------------- -HOW TO USE (TABS & FEATURES) +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: 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 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) -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. +- 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) -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. +- 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: 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 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: WATERMARKS -- Dynamic Overlay rules: Set up watermarks (image or text) on-the-fly with position, transparency, angle, font, and category filters. +TAB 5: TOOLS (PRO) & VISUAL PREVIEW +- File & Folder Name Sanitizer: Cleans Cyrillic characters, spaces, and special symbols from filenames. +- CMYK to sRGB Converter: Converts CMYK printing colorspace to sRGB web colorspace. +- Black Background Fixer: Edge-only perimeter floodfill replacement of black borders from transparent PNGs converted improperly to JPG. +- Per-row Visual Preview: Compare original vs processed image side-by-side in modal dialog before applying changes. -TAB 6: PLACEHOLDERS -- Renders fallback images for products, categories, or brands without images. +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: TOOLS (PRO) & CRON SCHEDULER -- Name Sanitizer, CMYK to sRGB Converter, Black Background Fixer. -- Cron background scheduler for continuous automated store optimization. +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.