docs: add exhaustive documentation table for all 19 pro tools across instruction.html, instructions.txt, and readme.txt

This commit is contained in:
nertyog 2026-08-07 04:32:44 +03:00
parent 7ba8d48fc4
commit b7b476e472
6 changed files with 417 additions and 100 deletions

View File

@ -2644,7 +2644,9 @@
<tr>
<th style="width: 250px;"><span class="lang-text" data-ua="Назва інструменту" data-ru="Название инструмента" data-en="Utility Name">Назва інструменту</span></th>
<th style="width: 220px;"><span class="lang-text" data-ua="Назва інструменту" data-ru="Название инструмента" data-en="Utility Name">Назва інструменту</span></th>
<th style="width: 140px;"><span class="lang-text" data-ua="Категорія" data-ru="Категория" data-en="Category">Категорія</span></th>
<th><span class="lang-text" data-ua="Опис та функціонал" data-ru="Описание и функционал" data-en="Description & Features">Опис та функціонал</span></th>
@ -2656,15 +2658,17 @@
<tr>
<td><b>PNG to JPG Converter</b></td>
<td><b>broken_db</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Знаходить великі важкі файли PNG (наприклад, фото товарів на білому фоні) та конвертує їх у JPG. Зменшує розмір файлу на 70-80%, автоматично оновлюючи шляхи в БД.</span>
<span class="ua-only">Пошук записів у БД (товари, доп. фото, категорії, бренди), для яких відсутній фізичний файл на диску. Дозволяє очистити биті записи або встановити заглушку.</span>
<span class="ru-only">Находит тяжелые файлы PNG (без прозрачности) и конвертирует их в JPG. Уменьшает размер файлов на 70-80% и обновляет БД.</span>
<span class="ru-only">Поиск записей в БД (товары, доп. фото, категории, бренды), для которых отсутствует физический файл на диске. Позволяет очистить битые записи или поставить заглушку.</span>
<span class="en-only">Detects large PNG images lacking alpha transparency channels and translates them to JPEGs, reducing file size by 70-80% while updating database references automatically.</span>
<span class="en-only">Finds database records referencing missing image files on disk. Allows clearing broken DB records or assigning fallback placeholders.</span>
</td>
@ -2672,15 +2676,17 @@
<tr>
<td><b>Duplicates Cleaner</b></td>
<td><b>broken_files</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Порівнює MD5-хеші зображень на сервері. Якщо знайдено повні копії з різними іменами, залишає лише один файл, а всі посилання в БД перенаправляє на нього.</span>
<span class="ua-only">Сканування диску на наявність бінарно пошкоджених чи неповних файлів зображень (0 байт, корумповані заголовочні блоки).</span>
<span class="ru-only">Находит полные дубликаты файлов по MD5-хешу, удаляет лишние файлы и обновляет пути в базе данных на единый файл.</span>
<span class="ru-only">Сканирование диска на наличие бинарно поврежденных или неполных файлов изображений (0 байт, битые заголовки).</span>
<span class="en-only">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.</span>
<span class="en-only">Scans disk for binary-corrupted or zero-byte truncated image files that fail GD/Imagick headers.</span>
</td>
@ -2688,15 +2694,17 @@
<tr>
<td><b>Watermarks Rules</b></td>
<td><b>empty_folders</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Створення динамічних правил накладання водяних знаків (текст чи зображення) на кеш картинок товарів, брендів чи категорій. Підтримує налаштування прозорості, кута нахилу та фільтрацію.</span>
<span class="ua-only">Пошук та автоматичне видалення порожніх директорій всередині <code>image/catalog/</code> для підтримки чистоти файлового дерева.</span>
<span class="ru-only">Создание правил наложения водяных знаков (текст или картинка) на кэш. Поддерживает прозрачность, угол наклона, скругление и фильтрацию категорий/брендов.</span>
<span class="ru-only">Поиск и автоматическое удаление пустых директорий внутри <code>image/catalog/</code> для поддержания чистоты файлового дерева.</span>
<span class="en-only">Manages dynamic watermarks overlay (text/image) on catalog cache. Supports opacity sliders, rotation angles, TTF font rendering, and category inclusion/exclusion limits.</span>
<span class="en-only">Finds and safely deletes empty nested folders inside <code>image/catalog/</code> to maintain a clean directory structure.</span>
</td>
@ -2704,15 +2712,17 @@
<tr>
<td><b>Broken DB Scanner</b></td>
<td><b>folder_tree</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Знаходить записи в БД, які посилаються на видалені файли. Дозволяє очистити лінки, вимкнути товари або підставити заглушки.</span>
<span class="ua-only">Повний аналіз об'єму та кількості файлів у кожній окремій підпапці каталогу. Допомагає знайти найважчі папки сайту.</span>
<span class="ru-only">Находит в базе данных ссылки на отсутствующие файлы. Позволяет убрать ссылки, отключить товары или установить заглушки.</span>
<span class="ru-only">Полный анализ объема и количества файлов в каждой отдельной подпапке каталога. Помогает найти самые тяжелые папки сайта.</span>
<span class="en-only">Finds database entries referencing missing files. Offers batch actions to clean references, disable products, or link placeholder placeholders.</span>
<span class="en-only">Deep directory tree breakdown showing total filesize and file counts for every nested catalog folder.</span>
</td>
@ -2720,15 +2730,17 @@
<tr>
<td><b>Transliteration & Translit</b></td>
<td><b>html_broken</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Перейменовує файли з кирилицею або пробілами в іменах на безпечну транслітерацію, що запобігає збоям кодування на деяких хостингах.</span>
<span class="ua-only">Пошук битих посилань на зображення в HTML-описах товарів, категорій та статей блогу, які віддають помилку 404.</span>
<span class="ru-only">Переименовывает файлы, содержащие кириллицу или пробелы, переводя их в транслит, и обновляет пути к ним в базе данных.</span>
<span class="ru-only">Поиск битых ссылок на изображения в HTML-описаниях товаров, категорий и статей блога, отдающих 404.</span>
<span class="en-only">Finds and sanitizes filenames containing cyrillic or spaces. Renames them using safe transliteration and maps changes to the database.</span>
<span class="en-only">Parses product and category HTML descriptions to locate broken <code>&lt;img&gt;</code> src paths returning 404.</span>
</td>
@ -2736,15 +2748,251 @@
<tr>
<td><b>CMYK Converter</b></td>
<td><b>small_photos</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Швидко конвертує колірний простір CMYK у sRGB, що попереджає ситуації, коли фото товарів не завантажуються або відображаються некоректно на iPhone чи Safari.</span>
<span class="ua-only">Пошук занадто малих/неякісних фотографій товарів (менше заданої ширини/висоти у пікселях, наприклад &lt; 300px).</span>
<span class="ru-only">Переводит изображения из цветового профиля CMYK в sRGB для корректного отображения картинок на устройствах Apple (iPhone, Safari).</span>
<span class="ru-only">Поиск слишком маленьких/некачественных фотографий товаров (меньше заданной ширины/высоты в пикселях, например &lt; 300px).</span>
<span class="en-only">Converts files from CMYK to sRGB, preventing display failures on Safari browsers and Apple iOS devices.</span>
<span class="en-only">Filters catalog images below configurable pixel dimension thresholds (e.g. height/width under 300px).</span>
</td>
</tr>
<tr>
<td><b>duplicates</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Пошук дублікатів фотографій на сервері за хеш-сумами вмісту (MD5), незалежно від імені файлу. Дозволяє вивільнити гігабайти дубльованих фото.</span>
<span class="ru-only">Поиск дубликатов фотографий на сервере по хэш-суммам содержимого (MD5), независимо от имени файла. Позволяет освободить гигабайты дубликатов.</span>
<span class="en-only">Identifies exact duplicate images across catalog directories via content MD5 hashing, regardless of filename.</span>
</td>
</tr>
<tr>
<td><b>heavy_files</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Пошук надзвичайно "важких" оригінальних фотографій (понад вказаний ліміт у КБ, наприклад &gt; 500 КБ або &gt; 2 МБ).</span>
<span class="ru-only">Поиск чрезвычайно "тяжелых" оригинальных фотографий (свыше указанного лимита в КБ, например &gt; 500 КБ или &gt; 2 МБ).</span>
<span class="en-only">Highlights oversized original images exceeding KB file size thresholds (e.g. raw 5MB+ photo uploads).</span>
</td>
</tr>
<tr>
<td><b>cmyk</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Виявлення фотографій у друкарському колірному просторі CMYK (які виглядають инвертованими або не відображаються у Safari/iOS) з автоматичним переведенням у sRGB.</span>
<span class="ru-only">Обнаружение фотографий в типографском цветовом пространстве CMYK (выглядящих инвертированными или не открывающихся в Safari/iOS) с автоматическим переводом в sRGB.</span>
<span class="en-only">Scans for CMYK printing color space images causing discolored/inverted rendering on iOS/Safari, with automated sRGB conversion.</span>
</td>
</tr>
<tr>
<td><b>svg_security</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Сканування та очищення SVG-файлів від потенційно шкідливих JavaScript-скриптів та XSS-ін'єкцій.</span>
<span class="ru-only">Сканирование и очистка SVG-файлов от потенциально вредоносных JavaScript-скриптов и XSS-инъекций.</span>
<span class="en-only">Audit and sanitization of uploaded SVG files to strip malicious embedded JavaScript and XSS payload tags.</span>
</td>
</tr>
<tr>
<td><b>black_bg</b></td>
<td><span class="badge" style="background:#3b82f6;">Сканер</span></td>
<td>
<span class="ua-only">Сканування фотографій з чорними фоновими рамками після некоректної конвертації PNG у JPG. Включає утиліту Edge-Only Floodfill для відновлення білого фону або збереження прозорого PNG.</span>
<span class="ru-only">Сканирование фотографий с черными фоновыми рамками после некорректной конвертации PNG в JPG. Включает утилиту Edge-Only Floodfill для восстановления белого фона или сохранения прозрачного PNG.</span>
<span class="en-only">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.</span>
</td>
</tr>
<tr>
<td><b>watermark</b></td>
<td><span class="badge" style="background:#10b981;">Генератор</span></td>
<td>
<span class="ua-only">Пакетне накладення водяних знаків (текст або зображення) на вибіркову групу фотографій товарів або категорій.</span>
<span class="ru-only">Пакетное наложение водяных знаков (текст или изображение) на выборочную группу фотографий товаров или категорий.</span>
<span class="en-only">Batch watermarking utility for selected catalog image paths using text or graphics overlays.</span>
</td>
</tr>
<tr>
<td><b>placeholders</b></td>
<td><span class="badge" style="background:#10b981;">Генератор</span></td>
<td>
<span class="ua-only">Пакетне встановлення зображень-заглушок для відсутніх або битих фото товарів у БД.</span>
<span class="ru-only">Пакетная установка изображений-заглушек для отсутствующих или битых фото товаров в БД.</span>
<span class="en-only">Batch assignment of fallback placeholder images for catalog items missing a physical asset.</span>
</td>
</tr>
<tr>
<td><b>png_jpg</b></td>
<td><span class="badge" style="background:#10b981;">Генератор</span></td>
<td>
<span class="ua-only">Масове конвертування важких непрозорих PNG-зображень у компактні JPG або WebP файли із заміною посилань в БД.</span>
<span class="ru-only">Массовое конвертирование тяжелых непрозрачных PNG-изображений в компактные JPG или WebP файлы с заменой ссылок в БД.</span>
<span class="en-only">Converts heavy non-transparent PNG files into lightweight JPG/WebP assets and updates DB table references.</span>
</td>
</tr>
<tr>
<td><b>exif</b></td>
<td><span class="badge" style="background:#10b981;">Генератор</span></td>
<td>
<span class="ua-only">Очищення службових EXIF-метаданих (геолокація GPS, модель камери, авторство) для додаткового зменшення ваги файлів на 10-15%.</span>
<span class="ru-only">Очистка служебных EXIF-метаданных (геолокация GPS, модель камеры, авторство) для дополнительного уменьшения веса файлов на 10-15%.</span>
<span class="en-only">Strips technical EXIF metadata (GPS location, camera parameters) to shave an extra 10-15% off file weights.</span>
</td>
</tr>
<tr>
<td><b>smart_cache</b></td>
<td><span class="badge" style="background:#10b981;">Генератор</span></td>
<td>
<span class="ua-only">Розумне очищення кешу OpenCart <code>image/cache/</code> з можливістю вибіркового вилучення застарілих мініатюр.</span>
<span class="ru-only">Умная очистка кэша OpenCart <code>image/cache/</code> с возможностью выборочного удаления устаревших миниатюр.</span>
<span class="en-only">Selective purger for expired OpenCart thumbnail cache inside <code>image/cache/</code> without affecting active assets.</span>
</td>
</tr>
<tr>
<td><b>sanitizer</b></td>
<td><span class="badge" style="background:#ef4444;">Експериментальний</span></td>
<td>
<span class="ua-only">Санітайзер імен файлів: автоматичне очищення шляхів від кирилиці, спецсимволів, пропусків та дублюючих підкреслень з синхронізацією в БД.</span>
<span class="ru-only">Санитайзер имен файлов: автоматическая очистка путей от кириллицы, спецсимволов, пробелов и дублирующих подчеркиваний с синхронизацией в БД.</span>
<span class="en-only">Filename sanitizer: strips spaces, Cyrillic, and illegal special characters from file paths while auto-updating DB tables.</span>
</td>
</tr>
<tr>
<td><b>translit</b></td>
<td><span class="badge" style="background:#ef4444;">Експериментальний</span></td>
<td>
<span class="ua-only">Автоматична транслітерація кириличних назв фото у латиницю за стандартом SEO URL.</span>
<span class="ru-only">Автоматическая транслитерация кириллических названий фото в латиницу по стандарту SEO URL.</span>
<span class="en-only">Automated transliteration of Cyrillic filename strings into clean SEO-friendly Latin characters.</span>
</td>
</tr>
<tr>
<td><b>cache_restore</b></td>
<td><span class="badge" style="background:#ef4444;">Експериментальний</span></td>
<td>
<span class="ua-only">Відновлення втрачених оригіналів з вищих за роздільною здатністю знімків кешу при випадковому видаленні.</span>
<span class="ru-only">Восстановление утерянных оригиналов из снимков кэша с высоким разрешением при случайном удалении.</span>
<span class="en-only">Recovery tool for accidentally deleted original files by analyzing and extracting high-resolution cached thumbnails.</span>
</td>
@ -3614,3 +3862,4 @@
</body>
</html>

View File

@ -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.

View File

@ -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.

View File

@ -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.

View File

@ -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.