diff --git a/docs/instruction.html b/docs/instruction.html index 7f374cf..e60362d 100644 --- a/docs/instruction.html +++ b/docs/instruction.html @@ -2636,7 +2636,7 @@ -
+
@@ -2644,7 +2644,9 @@ - + + + @@ -2656,15 +2658,17 @@ - + + + @@ -2672,15 +2676,17 @@ - + + + @@ -2688,15 +2694,17 @@ - + + + @@ -2704,15 +2712,17 @@ - + + + @@ -2720,15 +2730,17 @@ - + + + @@ -2736,15 +2748,251 @@ - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -3614,3 +3862,4 @@ + diff --git a/docs/instructions.txt b/docs/instructions.txt index 8b8cea4..b8680a2 100644 --- a/docs/instructions.txt +++ b/docs/instructions.txt @@ -6,7 +6,7 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- -🇺АКРАЇНСЬКА МОВА (UKRAINIAN) +🇺🇦 УКРАЇНСЬКА МОВА (UKRAINIAN) -------------------------------------------------------------------------------- ВСТАНОВЛЕННЯ ТА ОНОВЛЕННЯ: 1. Розпакуйте архів. @@ -15,15 +15,34 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html 4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати". ПОВНИЙ ОГЛЯД ВСІХ 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]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції. +- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з маркуванням дій), накопичувальна статистика з бази даних сайту з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції. +- Вкладка 2 (Стиснення та Ресайз): Вибір папок, режим безпечної копії або заміни оригіналів, макс. розміри, якість (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень в БД та коді тем (.tpl, .twig, .php, .css, .js), Карантин з відновленням в 1 клік або видалення. +- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань. +- Вкладка 5 (Інструменти Pro - 19 утиліт): + 1. broken_db - Пошук записів БД з відсутніми файлами на диску. + 2. broken_files - Пошук битих/корумпованих файлів (0 байт). + 3. empty_folders - Видалення порожніх папок в image/catalog. + 4. folder_tree - Аналіз розмірів та кількості файлів по папках. + 5. html_broken - Пошук битих 404 посилань на фото в HTML-описах. + 6. small_photos - Виявлення занадто малих фотографій. + 7. duplicates - Пошук точних дублікатів фото по хешу MD5. + 8. heavy_files - Знаходження надважких оригіналів (>500KB). + 9. cmyk - Сканування CMYK фото з автопереведенням у sRGB. + 10. svg_security - Очищення SVG-файлів від XSS та скриптів. + 11. black_bg - Відновлення білого фону (Edge-only floodfill) на фото з чорними рамками. + 12. watermark - Пакетне накладення водяних знаків. + 13. placeholders - Пакетне призначення заглушок. + 14. png_jpg - Конвертація важких PNG у компактний JPG/WebP. + 15. exif - Видалення EXIF-метаданих (GPS, камера) для економії 10-15%. + 16. smart_cache - Розумне очищення кешу зображень OpenCart. + 17. sanitizer - Очищення імен файлів від кирилиці, пропусків та спецсимволів. + 18. translit - Транслітерація кириличних назв фото у латиницю. + 19. cache_restore - Відновлення видалених оригіналів з кешу високої роздільної здатності. +- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту. +- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок. +- Вкладка 8 (Крон-завдання): Фоновий запуск стиснення, очищення та інструментів за розкладом. +- Вкладка 9 (Інфо & Екосистема): Графік диска, контакти та кнопка Інструкції. -------------------------------------------------------------------------------- @@ -35,16 +54,16 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html 3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2). 4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать". -ПОЛНЫЙ ОБЗОР ВСЕХ 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]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. +ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА (19 УТИЛИТ): +- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick, накопительная статистика из базы данных с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции. +- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим копии или замены оригиналов, наглядные 50/50 кнопки [ПАУЗА] и [ЗУПИНИТИ]. +- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых фото в БД и файлах тем (.tpl, .twig, .php, .css, .js), безопасный Карантин или удаление. +- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load (blur-up), редирект битых ссылок. +- Вкладка 5 (Инструменты Pro - 19 утилит): broken_db, broken_files, empty_folders, folder_tree, html_broken, small_photos, duplicates (MD5), heavy_files, cmyk (sRGB), svg_security, black_bg (floodfill), watermark, placeholders, png_jpg, exif, smart_cache, sanitizer, translit, cache_restore. +- Вкладка 6 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету. +- Вкладка 7 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов. +- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск по расписанию (ежедневно, еженедельно, ежемесячно). +- Вкладка 9 (Инфо & Экосистема): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. -------------------------------------------------------------------------------- @@ -52,17 +71,17 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- 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. +2. Upload upload/ to your OpenCart root directory via FTP. +3. Set permissions for extension/module/img_opti (or module/img_opti for OC 2.0-2.2). +4. Install "Image Optimizer [NAT]" under Extensions -> Modules. -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. +EXHAUSTIVE 9-TAB OVERVIEW (INCLUDING 19 PRO UTILITIES): +- Tab 1 (Settings & Stats): GD / Imagick engine choice, persistent DB stats with reset button, 100% full JSON export/import, folder rules, online instruction button. +- Tab 2 (Compression): Folder tree selection, Safe Copy vs Replace, dimensions, qualities, 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. +- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard, WebP on-the-fly, SVG, Lazy Load (blur-up), broken image fallback. +- Tab 5 (Tools Pro - 19 Utilities): broken_db, broken_files, empty_folders, folder_tree, html_broken, small_photos, duplicates (MD5), heavy_files, cmyk (sRGB), svg_security, black_bg (edge floodfill), watermark, placeholders, png_jpg, exif, smart_cache, sanitizer, translit, cache_restore. +- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays. +- Tab 7 (Placeholders): Fallback placeholder replacement. - 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. +- Tab 9 (Info & Ecosystem): Disk space chart, support contacts, online instruction button. diff --git a/docs/readme.txt b/docs/readme.txt index 6266161..19205e6 100644 --- a/docs/readme.txt +++ b/docs/readme.txt @@ -61,11 +61,26 @@ TAB 4: IMAGE FORMATS & PROTECTION - 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: 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 5: TOOLS (PRO) & VISUAL PREVIEW (19 SPECIALIZED UTILITIES) +1. broken_db: Finds DB entries with missing physical files. +2. broken_files: Scans for binary-corrupted or zero-byte truncated images. +3. empty_folders: Scans and purges empty catalog subdirectories. +4. folder_tree: Deep size and file count analysis per subfolder. +5. html_broken: Scans product/category HTML for 404 image links. +6. small_photos: Identifies low-res photos under dimension limits. +7. duplicates: Finds exact duplicate images using MD5 content hashes. +8. heavy_files: Flags raw oversized images exceeding KB limits. +9. cmyk: Detects CMYK color space images and auto-converts to sRGB. +10. svg_security: Strips malicious JS scripts and XSS from SVG files. +11. black_bg: Edge-only floodfill repair of black background borders. +12. watermark: Batch watermarking utility. +13. placeholders: Batch placeholder assignment for missing assets. +14. png_jpg: Mass converts heavy PNGs to JPG/WebP and updates DB. +15. exif: Strips camera/GPS metadata for 10-15% size reduction. +16. smart_cache: Selective expired image cache purger. +17. sanitizer: Cleans file paths of spaces, Cyrillic, and illegal chars. +18. translit: Transliterates Cyrillic filenames to SEO Latin. +19. cache_restore: Recovers deleted original photos from high-res cache. TAB 6: WATERMARKS - Dynamic On-the-Fly Overlays: Apply image or text watermarks dynamically on products, categories, brands, or banners. 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 8fd36b2..3bdaf0b 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 8b8cea4..b8680a2 100644 --- a/instructions.txt +++ b/instructions.txt @@ -6,7 +6,7 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- -🇺АКРАЇНСЬКА МОВА (UKRAINIAN) +🇺🇦 УКРАЇНСЬКА МОВА (UKRAINIAN) -------------------------------------------------------------------------------- ВСТАНОВЛЕННЯ ТА ОНОВЛЕННЯ: 1. Розпакуйте архів. @@ -15,15 +15,34 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html 4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати". ПОВНИЙ ОГЛЯД ВСІХ 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]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції. +- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з маркуванням дій), накопичувальна статистика з бази даних сайту з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції. +- Вкладка 2 (Стиснення та Ресайз): Вибір папок, режим безпечної копії або заміни оригіналів, макс. розміри, якість (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50. +- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень в БД та коді тем (.tpl, .twig, .php, .css, .js), Карантин з відновленням в 1 клік або видалення. +- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань. +- Вкладка 5 (Інструменти Pro - 19 утиліт): + 1. broken_db - Пошук записів БД з відсутніми файлами на диску. + 2. broken_files - Пошук битих/корумпованих файлів (0 байт). + 3. empty_folders - Видалення порожніх папок в image/catalog. + 4. folder_tree - Аналіз розмірів та кількості файлів по папках. + 5. html_broken - Пошук битих 404 посилань на фото в HTML-описах. + 6. small_photos - Виявлення занадто малих фотографій. + 7. duplicates - Пошук точних дублікатів фото по хешу MD5. + 8. heavy_files - Знаходження надважких оригіналів (>500KB). + 9. cmyk - Сканування CMYK фото з автопереведенням у sRGB. + 10. svg_security - Очищення SVG-файлів від XSS та скриптів. + 11. black_bg - Відновлення білого фону (Edge-only floodfill) на фото з чорними рамками. + 12. watermark - Пакетне накладення водяних знаків. + 13. placeholders - Пакетне призначення заглушок. + 14. png_jpg - Конвертація важких PNG у компактний JPG/WebP. + 15. exif - Видалення EXIF-метаданих (GPS, камера) для економії 10-15%. + 16. smart_cache - Розумне очищення кешу зображень OpenCart. + 17. sanitizer - Очищення імен файлів від кирилиці, пропусків та спецсимволів. + 18. translit - Транслітерація кириличних назв фото у латиницю. + 19. cache_restore - Відновлення видалених оригіналів з кешу високої роздільної здатності. +- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту. +- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок. +- Вкладка 8 (Крон-завдання): Фоновий запуск стиснення, очищення та інструментів за розкладом. +- Вкладка 9 (Інфо & Екосистема): Графік диска, контакти та кнопка Інструкції. -------------------------------------------------------------------------------- @@ -35,16 +54,16 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html 3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2). 4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать". -ПОЛНЫЙ ОБЗОР ВСЕХ 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]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. +ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА (19 УТИЛИТ): +- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick, накопительная статистика из базы данных с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции. +- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим копии или замены оригиналов, наглядные 50/50 кнопки [ПАУЗА] и [ЗУПИНИТИ]. +- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых фото в БД и файлах тем (.tpl, .twig, .php, .css, .js), безопасный Карантин или удаление. +- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load (blur-up), редирект битых ссылок. +- Вкладка 5 (Инструменты Pro - 19 утилит): broken_db, broken_files, empty_folders, folder_tree, html_broken, small_photos, duplicates (MD5), heavy_files, cmyk (sRGB), svg_security, black_bg (floodfill), watermark, placeholders, png_jpg, exif, smart_cache, sanitizer, translit, cache_restore. +- Вкладка 6 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету. +- Вкладка 7 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов. +- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск по расписанию (ежедневно, еженедельно, ежемесячно). +- Вкладка 9 (Инфо & Экосистема): График использования диска, контакты поддержки и кнопка Онлайн Инструкции. -------------------------------------------------------------------------------- @@ -52,17 +71,17 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html -------------------------------------------------------------------------------- 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. +2. Upload upload/ to your OpenCart root directory via FTP. +3. Set permissions for extension/module/img_opti (or module/img_opti for OC 2.0-2.2). +4. Install "Image Optimizer [NAT]" under Extensions -> Modules. -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. +EXHAUSTIVE 9-TAB OVERVIEW (INCLUDING 19 PRO UTILITIES): +- Tab 1 (Settings & Stats): GD / Imagick engine choice, persistent DB stats with reset button, 100% full JSON export/import, folder rules, online instruction button. +- Tab 2 (Compression): Folder tree selection, Safe Copy vs Replace, dimensions, qualities, 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. +- Tab 4 (Formats & Guard): On-the-Fly Fake JPG Guard, WebP on-the-fly, SVG, Lazy Load (blur-up), broken image fallback. +- Tab 5 (Tools Pro - 19 Utilities): broken_db, broken_files, empty_folders, folder_tree, html_broken, small_photos, duplicates (MD5), heavy_files, cmyk (sRGB), svg_security, black_bg (edge floodfill), watermark, placeholders, png_jpg, exif, smart_cache, sanitizer, translit, cache_restore. +- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays. +- Tab 7 (Placeholders): Fallback placeholder replacement. - 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. +- Tab 9 (Info & Ecosystem): Disk space chart, support contacts, online instruction button. diff --git a/readme.txt b/readme.txt index 6266161..19205e6 100644 --- a/readme.txt +++ b/readme.txt @@ -61,11 +61,26 @@ TAB 4: IMAGE FORMATS & PROTECTION - 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: 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 5: TOOLS (PRO) & VISUAL PREVIEW (19 SPECIALIZED UTILITIES) +1. broken_db: Finds DB entries with missing physical files. +2. broken_files: Scans for binary-corrupted or zero-byte truncated images. +3. empty_folders: Scans and purges empty catalog subdirectories. +4. folder_tree: Deep size and file count analysis per subfolder. +5. html_broken: Scans product/category HTML for 404 image links. +6. small_photos: Identifies low-res photos under dimension limits. +7. duplicates: Finds exact duplicate images using MD5 content hashes. +8. heavy_files: Flags raw oversized images exceeding KB limits. +9. cmyk: Detects CMYK color space images and auto-converts to sRGB. +10. svg_security: Strips malicious JS scripts and XSS from SVG files. +11. black_bg: Edge-only floodfill repair of black background borders. +12. watermark: Batch watermarking utility. +13. placeholders: Batch placeholder assignment for missing assets. +14. png_jpg: Mass converts heavy PNGs to JPG/WebP and updates DB. +15. exif: Strips camera/GPS metadata for 10-15% size reduction. +16. smart_cache: Selective expired image cache purger. +17. sanitizer: Cleans file paths of spaces, Cyrillic, and illegal chars. +18. translit: Transliterates Cyrillic filenames to SEO Latin. +19. cache_restore: Recovers deleted original photos from high-res cache. TAB 6: WATERMARKS - Dynamic On-the-Fly Overlays: Apply image or text watermarks dynamically on products, categories, brands, or banners.
Назва інструментуНазва інструментуКатегорія Опис та функціонал
PNG to JPG Converterbroken_dbСканер - Знаходить великі важкі файли PNG (наприклад, фото товарів на білому фоні) та конвертує їх у JPG. Зменшує розмір файлу на 70-80%, автоматично оновлюючи шляхи в БД. + Пошук записів у БД (товари, доп. фото, категорії, бренди), для яких відсутній фізичний файл на диску. Дозволяє очистити биті записи або встановити заглушку. - Находит тяжелые файлы PNG (без прозрачности) и конвертирует их в JPG. Уменьшает размер файлов на 70-80% и обновляет БД. + Поиск записей в БД (товары, доп. фото, категории, бренды), для которых отсутствует физический файл на диске. Позволяет очистить битые записи или поставить заглушку. - Detects large PNG images lacking alpha transparency channels and translates them to JPEGs, reducing file size by 70-80% while updating database references automatically. + Finds database records referencing missing image files on disk. Allows clearing broken DB records or assigning fallback placeholders.
Duplicates Cleanerbroken_filesСканер - Порівнює MD5-хеші зображень на сервері. Якщо знайдено повні копії з різними іменами, залишає лише один файл, а всі посилання в БД перенаправляє на нього. + Сканування диску на наявність бінарно пошкоджених чи неповних файлів зображень (0 байт, корумповані заголовочні блоки). - Находит полные дубликаты файлов по MD5-хешу, удаляет лишние файлы и обновляет пути в базе данных на единый файл. + Сканирование диска на наличие бинарно поврежденных или неполных файлов изображений (0 байт, битые заголовки). - Compares MD5 checksums of files on server. Merges exact byte duplicates, deletes duplicates, and rewires DB records to point to a single original image file. + Scans disk for binary-corrupted or zero-byte truncated image files that fail GD/Imagick headers.
Watermarks Rulesempty_foldersСканер - Створення динамічних правил накладання водяних знаків (текст чи зображення) на кеш картинок товарів, брендів чи категорій. Підтримує налаштування прозорості, кута нахилу та фільтрацію. + Пошук та автоматичне видалення порожніх директорій всередині image/catalog/ для підтримки чистоти файлового дерева. - Создание правил наложения водяных знаков (текст или картинка) на кэш. Поддерживает прозрачность, угол наклона, скругление и фильтрацию категорий/брендов. + Поиск и автоматическое удаление пустых директорий внутри image/catalog/ для поддержания чистоты файлового дерева. - Manages dynamic watermarks overlay (text/image) on catalog cache. Supports opacity sliders, rotation angles, TTF font rendering, and category inclusion/exclusion limits. + Finds and safely deletes empty nested folders inside image/catalog/ to maintain a clean directory structure.
Broken DB Scannerfolder_treeСканер - Знаходить записи в БД, які посилаються на видалені файли. Дозволяє очистити лінки, вимкнути товари або підставити заглушки. + Повний аналіз об'єму та кількості файлів у кожній окремій підпапці каталогу. Допомагає знайти найважчі папки сайту. - Находит в базе данных ссылки на отсутствующие файлы. Позволяет убрать ссылки, отключить товары или установить заглушки. + Полный анализ объема и количества файлов в каждой отдельной подпапке каталога. Помогает найти самые тяжелые папки сайта. - Finds database entries referencing missing files. Offers batch actions to clean references, disable products, or link placeholder placeholders. + Deep directory tree breakdown showing total filesize and file counts for every nested catalog folder.
Transliteration & Translithtml_brokenСканер - Перейменовує файли з кирилицею або пробілами в іменах на безпечну транслітерацію, що запобігає збоям кодування на деяких хостингах. + Пошук битих посилань на зображення в HTML-описах товарів, категорій та статей блогу, які віддають помилку 404. - Переименовывает файлы, содержащие кириллицу или пробелы, переводя их в транслит, и обновляет пути к ним в базе данных. + Поиск битых ссылок на изображения в HTML-описаниях товаров, категорий и статей блога, отдающих 404. - Finds and sanitizes filenames containing cyrillic or spaces. Renames them using safe transliteration and maps changes to the database. + Parses product and category HTML descriptions to locate broken <img> src paths returning 404.
CMYK Convertersmall_photosСканер - Швидко конвертує колірний простір CMYK у sRGB, що попереджає ситуації, коли фото товарів не завантажуються або відображаються некоректно на iPhone чи Safari. + Пошук занадто малих/неякісних фотографій товарів (менше заданої ширини/висоти у пікселях, наприклад < 300px). - Переводит изображения из цветового профиля CMYK в sRGB для корректного отображения картинок на устройствах Apple (iPhone, Safari). + Поиск слишком маленьких/некачественных фотографий товаров (меньше заданной ширины/высоты в пикселях, например < 300px). - Converts files from CMYK to sRGB, preventing display failures on Safari browsers and Apple iOS devices. + Filters catalog images below configurable pixel dimension thresholds (e.g. height/width under 300px). + +
duplicatesСканер + + Пошук дублікатів фотографій на сервері за хеш-сумами вмісту (MD5), незалежно від імені файлу. Дозволяє вивільнити гігабайти дубльованих фото. + + Поиск дубликатов фотографий на сервере по хэш-суммам содержимого (MD5), независимо от имени файла. Позволяет освободить гигабайты дубликатов. + + Identifies exact duplicate images across catalog directories via content MD5 hashing, regardless of filename. + +
heavy_filesСканер + + Пошук надзвичайно "важких" оригінальних фотографій (понад вказаний ліміт у КБ, наприклад > 500 КБ або > 2 МБ). + + Поиск чрезвычайно "тяжелых" оригинальных фотографий (свыше указанного лимита в КБ, например > 500 КБ или > 2 МБ). + + Highlights oversized original images exceeding KB file size thresholds (e.g. raw 5MB+ photo uploads). + +
cmykСканер + + Виявлення фотографій у друкарському колірному просторі CMYK (які виглядають инвертованими або не відображаються у Safari/iOS) з автоматичним переведенням у sRGB. + + Обнаружение фотографий в типографском цветовом пространстве CMYK (выглядящих инвертированными или не открывающихся в Safari/iOS) с автоматическим переводом в sRGB. + + Scans for CMYK printing color space images causing discolored/inverted rendering on iOS/Safari, with automated sRGB conversion. + +
svg_securityСканер + + Сканування та очищення SVG-файлів від потенційно шкідливих JavaScript-скриптів та XSS-ін'єкцій. + + Сканирование и очистка SVG-файлов от потенциально вредоносных JavaScript-скриптов и XSS-инъекций. + + Audit and sanitization of uploaded SVG files to strip malicious embedded JavaScript and XSS payload tags. + +
black_bgСканер + + Сканування фотографій з чорними фоновими рамками після некоректної конвертації PNG у JPG. Включає утиліту Edge-Only Floodfill для відновлення білого фону або збереження прозорого PNG. + + Сканирование фотографий с черными фоновыми рамками после некорректной конвертации PNG в JPG. Включает утилиту Edge-Only Floodfill для восстановления белого фона или сохранения прозрачного PNG. + + Scans for black background border artifacts from improper PNG-to-JPG conversions. Includes Edge-Only Floodfill to replace borders with white or restore transparent PNG. + +
watermarkГенератор + + Пакетне накладення водяних знаків (текст або зображення) на вибіркову групу фотографій товарів або категорій. + + Пакетное наложение водяных знаков (текст или изображение) на выборочную группу фотографий товаров или категорий. + + Batch watermarking utility for selected catalog image paths using text or graphics overlays. + +
placeholdersГенератор + + Пакетне встановлення зображень-заглушок для відсутніх або битих фото товарів у БД. + + Пакетная установка изображений-заглушек для отсутствующих или битых фото товаров в БД. + + Batch assignment of fallback placeholder images for catalog items missing a physical asset. + +
png_jpgГенератор + + Масове конвертування важких непрозорих PNG-зображень у компактні JPG або WebP файли із заміною посилань в БД. + + Массовое конвертирование тяжелых непрозрачных PNG-изображений в компактные JPG или WebP файлы с заменой ссылок в БД. + + Converts heavy non-transparent PNG files into lightweight JPG/WebP assets and updates DB table references. + +
exifГенератор + + Очищення службових EXIF-метаданих (геолокація GPS, модель камери, авторство) для додаткового зменшення ваги файлів на 10-15%. + + Очистка служебных EXIF-метаданных (геолокация GPS, модель камеры, авторство) для дополнительного уменьшения веса файлов на 10-15%. + + Strips technical EXIF metadata (GPS location, camera parameters) to shave an extra 10-15% off file weights. + +
smart_cacheГенератор + + Розумне очищення кешу OpenCart image/cache/ з можливістю вибіркового вилучення застарілих мініатюр. + + Умная очистка кэша OpenCart image/cache/ с возможностью выборочного удаления устаревших миниатюр. + + Selective purger for expired OpenCart thumbnail cache inside image/cache/ without affecting active assets. + +
sanitizerЕкспериментальний + + Санітайзер імен файлів: автоматичне очищення шляхів від кирилиці, спецсимволів, пропусків та дублюючих підкреслень з синхронізацією в БД. + + Санитайзер имен файлов: автоматическая очистка путей от кириллицы, спецсимволов, пробелов и дублирующих подчеркиваний с синхронизацией в БД. + + Filename sanitizer: strips spaces, Cyrillic, and illegal special characters from file paths while auto-updating DB tables. + +
translitЕкспериментальний + + Автоматична транслітерація кириличних назв фото у латиницю за стандартом SEO URL. + + Автоматическая транслитерация кириллических названий фото в латиницу по стандарту SEO URL. + + Automated transliteration of Cyrillic filename strings into clean SEO-friendly Latin characters. + +
cache_restoreЕкспериментальний + + Відновлення втрачених оригіналів з вищих за роздільною здатністю знімків кешу при випадковому видаленні. + + Восстановление утерянных оригиналов из снимков кэша с высоким разрешением при случайном удалении. + + Recovery tool for accidentally deleted original files by analyzing and extracting high-resolution cached thumbnails.