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 9930e35..0c6703e 100644 Binary files a/image_optimizer_nat_OC_20_22_1_1.ocmod.zip and b/image_optimizer_nat_OC_20_22_1_1.ocmod.zip differ diff --git a/instructions.txt b/instructions.txt index bbc21d0..8b8cea4 100644 --- a/instructions.txt +++ b/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/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.