docs: expand documentation to cover all 9 tabs, nuances, and rebuild release packages v1.2.0
This commit is contained in:
nertyog
parent
57d6bac47c
commit
cbf05b88b0
|
|
@ -6,57 +6,63 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇺🇦 УКРАЇНСЬКА МОВА (UKRAINIAN)
|
🇺АКРАЇНСЬКА МОВА (UKRAINIAN)
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
ВСТАНОВЛЕННЯ МОДУЛЯ:
|
ВСТАНОВЛЕННЯ ТА ОНОВЛЕННЯ:
|
||||||
1. Розпакуйте архів.
|
1. Розпакуйте архів.
|
||||||
2. Завантажте вміст папки upload/ у корінь вашого сайту по FTP.
|
2. Завантажте вміст папки upload/ у корінь вашого сайту по FTP.
|
||||||
3. Перейдіть в "Система" -> "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2).
|
3. Перейдіть в "Система" -> "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2).
|
||||||
4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати".
|
4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати".
|
||||||
|
|
||||||
ФУНКЦІОНАЛ ТА ВКТАДКИ:
|
ПОВНИЙ ОГЛЯД ВСІХ 9 ВКЛАДОК ТА ФУНКЦІОНАЛУ:
|
||||||
- Вкладка 1 (Інфо та статистика): Графік диска, накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON та кнопка переходу до Онлайн Інструкції.
|
- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з явним маркуванням дій), накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції.
|
||||||
- Вкладка 2 (Стиснення та Ресайз): Вибір движка (GD або Imagick з маркуванням дій), розмірів, якості WebP/JPG/PNG та вибір папок.
|
- Вкладка 2 (Стиснення та Ресайз): Вибір папок каталогу, режим безпечної копії (catalog_new) або заміни оригіналів, налаштування макс. ширини/висоти, якості (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50.
|
||||||
- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень, відправка у Карантин або остаточне видалення.
|
- Вкладка 3 (Очищення від сміття): Глибоке сканування БД та файлів шаблону (.tpl, .twig, .php, .css, .js), безпечний Карантин (image/catalog_trash/) з відновленням в один клік або остаточне видалення.
|
||||||
- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard), WebP на льоту, SVG, Lazy Load.
|
- Вкладка 4 (Формати & Захист): Автоматичний захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань.
|
||||||
- Вкладка 5 (Водяні знаки): Накладання водяних знаків (текст/фото) на льоту.
|
- Вкладка 5 (Інструменти Pro & Попередній перегляд): Санітайзер імен (очищення кирилиці й спецсимволів), конвертер колірного простору CMYK у sRGB, виправлення чорного фону (Edge-only floodfill) та порядковий візуальний порівняльний перегляд.
|
||||||
- Вкладка 6 (Заглушки): Автозаміна відсутніх фото товарів, категорій та брендів.
|
- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту з прозорістю, кутом, шрифтом TTF та фільтрацією за категоріями.
|
||||||
- Вкладка 7 (Інструменти & Крон): Санітайзер імен, конвертер CMYK у sRGB, виправлення чорних фонів, планувальник Cron.
|
- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок для товарів, категорій та брендів без фото.
|
||||||
|
- Вкладка 8 (Крон-завдання): Автоматичний фоновий запуск стиснення, очищення, санітайзера та виправлення чорних фонів за розкладом (щодня, щотижня, щомісяця).
|
||||||
|
- Вкладка 9 (Інфо & Екосистема [NAT]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції.
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN)
|
🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN)
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
УСТАНОВКА МОДУЛЯ:
|
УСТАНОВКА И ОБНОВЛЕНИЕ:
|
||||||
1. Распакуйте архив.
|
1. Распакуйте архив.
|
||||||
2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP.
|
2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP.
|
||||||
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2).
|
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2).
|
||||||
4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать".
|
4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать".
|
||||||
|
|
||||||
ФУНКЦИОНАЛ И ВКЛАДКИ:
|
ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА:
|
||||||
- Вкладка 1 (Инфо и статистика): График диска, накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON и кнопка перехода к Онлайн Инструкции.
|
- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick (с четкой маркировкой действий), накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции.
|
||||||
- Вкладка 2 (Сжатие и Ресайз): Выбор движка (GD или Imagick с маркировкой действий), размеров, качества WebP/JPG/PNG и выбор папок.
|
- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим безопасной копии (catalog_new) или замены оригиналов, настройки макс. ширины/высоты, качества (WebP/JPG/PNG), многопоточность, пороги экономии и симметричные кнопки [ПАУЗА] и [ЗУПИНИТИ] 50/50.
|
||||||
- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых изображений, отправка в Карантин или окончательное удаление.
|
- Вкладка 3 (Очистка от мусора): Глубокое сканирование БД и файлов шаблона (.tpl, .twig, .php, .css, .js), безопасный Карантин (image/catalog_trash/) с восстановлением в один клик или окончательное удаление.
|
||||||
- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load.
|
- Вкладка 4 (Форматы & Защита): Автоматическая защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard с выбором режима белый JPG / прозрачный PNG), WebP на лету, SVG, Lazy Load (blur-up) и заглушка для битых ссылок.
|
||||||
- Вкладка 5 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету.
|
- Вкладка 5 (Инструменты Pro & Предпросмотр): Санитайзер имен (очистка кириллицы и спецсимволов), конвертер цветового пространства CMYK в sRGB, исправление черного фона (Edge-only floodfill) и построчный визуальный сравнительный предпросмотр.
|
||||||
- Вкладка 6 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов.
|
- Вкладка 6 (Водяные знаки): Динамическое наложение водяных знаков (изображение или текст) на лету с прозрачностью, углом, шрифтом TTF и фильтрацией по категориям.
|
||||||
- Вкладка 7 (Инструменты & Крон): Санитайзер имен, конвертер CMYK в sRGB, исправление черных фонов, планировщик Cron.
|
- Вкладка 7 (Заглушки): Автоподстановка изображений-заглушек для товаров, категорий и брендов без фото.
|
||||||
|
- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск сжатия, очистки, санитайзера и исправления черных фонов по расписанию (ежедневно, еженедельно, ежемесячно).
|
||||||
|
- Вкладка 9 (Инфо & Экосистема [NAT]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции.
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇬🇧 ENGLISH
|
🇬🇧 ENGLISH
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
INSTALLATION:
|
INSTALLATION & UPGRADE:
|
||||||
1. Extract the archive.
|
1. Extract the archive.
|
||||||
2. Upload the contents of upload/ to your OpenCart root directory via FTP.
|
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).
|
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.
|
4. Go to Extensions -> Modules, install "Image Optimizer [NAT]", and click Edit.
|
||||||
|
|
||||||
FEATURES & TABS:
|
EXHAUSTIVE 9-TAB MODULE OVERVIEW:
|
||||||
- Tab 1 (Info & Stats): Disk chart, persistent DB stats with reset button, 100% full JSON settings export/import, online instruction link button.
|
- 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): GD / Imagick engine selection with labelled actions, batch resizing, WebP/JPG/PNG quality controls.
|
- 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): Smart search for unused catalog photos, safe quarantine and permanent deletion.
|
- 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 protection, WebP on-the-fly, SVG, Lazy Load.
|
- 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 (Watermarks): On-the-fly image and text watermarks with position and opacity rules.
|
- 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 (Placeholders): Fallback images for missing photos.
|
- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays with opacity, angle, TTF font, and category filtering.
|
||||||
- Tab 7 (Tools & Cron): Name Sanitizer, CMYK to sRGB converter, Black BG repair, Cron background runner.
|
- 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.
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@ Image Optimizer [NAT]: Compress originals & remove unused images v1.2.0
|
||||||
|
|
||||||
Thank you for purchasing our extension!
|
Thank you for purchasing our extension!
|
||||||
If you have any questions, feel free to contact us: info@nat.od.ua
|
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.
|
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).
|
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).
|
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 the "Install" (green plus) button.
|
4. Go to Extensions -> Extensions -> Modules. Find "Image Optimizer [NAT]" and click "Install", then "Edit".
|
||||||
5. Click the "Edit" button to access the module panel.
|
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
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!
|
WARNING: Always create a full backup of your /image/catalog/ folder before running any optimizations or deletions!
|
||||||
|
|
||||||
TAB 1: INFO & STATS
|
TAB 1: MODULE SETTINGS & SYSTEM STATUS
|
||||||
- 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.
|
- Engine Selection: GD (Standard) or Imagick (Advanced) with explicit GD/Imagick action labelling across all scanning tools.
|
||||||
- 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.
|
- Individual Folder Rules: Set per-folder custom JPG/WebP quality and max width/height overrides.
|
||||||
- Full Export / Import (JSON): Export and restore 100% of module settings (Cron tasks, watermark rules, placeholders, folder limits, format guards).
|
- Disk Usage Chart: Renders a pie chart of folder sizes (Catalog, Cache, Trash) with manual quota limit override.
|
||||||
- Online Web-Instruction Button: Direct link to the complete web documentation at http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html.
|
- 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)
|
TAB 2: OPTIMIZE & RESIZE (COMPRESSION)
|
||||||
1. Enter your License Key (Token) in the respective field.
|
- Multi-folder Tree Selection: Select specific subfolders inside image/catalog/.
|
||||||
2. Select target processing engine: GD (Standard) or Imagick (Advanced). Actions are explicitly labelled (GD / Imagick).
|
- Safe Copy vs Replace Originals: Choose between creating a backup copy (catalog_new) or replacing originals directly.
|
||||||
3. Select target folders inside image/catalog/.
|
- Dimension Limits & Quality Controls: Max width/height, JPG quality (0-100), PNG quality (0-9), WebP quality (0-100).
|
||||||
4. Choose Mode: "Create a copy" (Safest) or "Replace originals".
|
- Performance & Multi-threading: Batch chunk size, log screen lines, and multi-threading execution controls.
|
||||||
5. Set maximum Width/Height and WebP/JPG/PNG quality settings.
|
- Savings Replacement Thresholds: Minimum byte/percent savings required to replace files.
|
||||||
6. Click "START OPTIMIZATION". Balanced 50/50 Pause & Stop UI controls allow full control during batch execution.
|
- Interactive Controls: Balanced 50/50 Pause & Stop controls during active processing, plus cache clear button.
|
||||||
|
|
||||||
TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL)
|
TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL)
|
||||||
1. Select the folders to scan.
|
- 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.
|
||||||
2. Click "FIND JUNK". The module compares physical files on disk with your Database and Theme files.
|
- Safe Quarantine & permanent deletion: Move unused files to image/catalog_trash/ with one-click restore capability, or delete permanently.
|
||||||
3. Review the detailed log of unused files.
|
|
||||||
4. Click "To Quarantine" to safely move junk files to image/catalog_trash/, or "Delete permanently" to wipe them from the server.
|
|
||||||
|
|
||||||
TAB 4: FORMATS (WEBP & FAKE JPG GUARD)
|
TAB 4: IMAGE FORMATS & PROTECTION
|
||||||
- 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.
|
- Support SVG & WebP: Enable native SVG uploading and WebP conversion (including TrueFileManager integration).
|
||||||
- WebP "on-the-fly", SVG support, and progressive Lazy Load with blur-up.
|
- 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
|
TAB 5: TOOLS (PRO) & VISUAL PREVIEW
|
||||||
- Dynamic Overlay rules: Set up watermarks (image or text) on-the-fly with position, transparency, angle, font, and category filters.
|
- 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
|
TAB 6: WATERMARKS
|
||||||
- Renders fallback images for products, categories, or brands without images.
|
- 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
|
TAB 7: PLACEHOLDERS
|
||||||
- Name Sanitizer, CMYK to sRGB Converter, Black Background Fixer.
|
- Automatic fallback image replacement for products, categories, and brands without an assigned image.
|
||||||
- Cron background scheduler for continuous automated store optimization.
|
|
||||||
|
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.
|
||||||
|
|
|
||||||
Binary file not shown.
|
|
@ -6,57 +6,63 @@ http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇺🇦 УКРАЇНСЬКА МОВА (UKRAINIAN)
|
🇺АКРАЇНСЬКА МОВА (UKRAINIAN)
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
ВСТАНОВЛЕННЯ МОДУЛЯ:
|
ВСТАНОВЛЕННЯ ТА ОНОВЛЕННЯ:
|
||||||
1. Розпакуйте архів.
|
1. Розпакуйте архів.
|
||||||
2. Завантажте вміст папки upload/ у корінь вашого сайту по FTP.
|
2. Завантажте вміст папки upload/ у корінь вашого сайту по FTP.
|
||||||
3. Перейдіть в "Система" -> "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2).
|
3. Перейдіть в "Система" -> "Користувачі" -> "Групи користувачів", виберіть группу (Administrator) та встановіть галочки прав для: extension/module/img_opti (або module/img_opti для OC 2.0-2.2).
|
||||||
4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати".
|
4. Перейдіть у "Модулі / Розширення", знайдіть "Image Optimizer [NAT]" та натисніть "Встановити", потім "Редагувати".
|
||||||
|
|
||||||
ФУНКЦІОНАЛ ТА ВКТАДКИ:
|
ПОВНИЙ ОГЛЯД ВСІХ 9 ВКЛАДОК ТА ФУНКЦІОНАЛУ:
|
||||||
- Вкладка 1 (Інфо та статистика): Графік диска, накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON та кнопка переходу до Онлайн Інструкції.
|
- Вкладка 1 (Налаштування & Статистика): Вибір движка GD або Imagick (з явним маркуванням дій), накопичувальна статистика з бази даних сайту (враховує Оптимізацію, Очищення, Інструменти та Крон) з кнопкою [Скинути статистику], 100% експорт/імпорт налаштувань у JSON, правила для окремих папок та кнопка Онлайн Інструкції.
|
||||||
- Вкладка 2 (Стиснення та Ресайз): Вибір движка (GD або Imagick з маркуванням дій), розмірів, якості WebP/JPG/PNG та вибір папок.
|
- Вкладка 2 (Стиснення та Ресайз): Вибір папок каталогу, режим безпечної копії (catalog_new) або заміни оригіналів, налаштування макс. ширини/висоти, якості (WebP/JPG/PNG), багатопотоковість, пороги економії та симетричні кнопки [ПАУЗА] і [ЗУПИНИТИ] 50/50.
|
||||||
- Вкладка 3 (Очищення від сміття): Пошук невикористовуваних зображень, відправка у Карантин або остаточне видалення.
|
- Вкладка 3 (Очищення від сміття): Глибоке сканування БД та файлів шаблону (.tpl, .twig, .php, .css, .js), безпечний Карантин (image/catalog_trash/) з відновленням в один клік або остаточне видалення.
|
||||||
- Вкладка 4 (Формати & Захист): Захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard), WebP на льоту, SVG, Lazy Load.
|
- Вкладка 4 (Формати & Захист): Автоматичний захист від фейкових JPG на льоту (On-the-Fly Fake JPG Guard з вибором режиму білий JPG / прозорий PNG), WebP на льоту, SVG, Lazy Load (blur-up) та заглушка для битих посилань.
|
||||||
- Вкладка 5 (Водяні знаки): Накладання водяних знаків (текст/фото) на льоту.
|
- Вкладка 5 (Інструменти Pro & Попередній перегляд): Санітайзер імен (очищення кирилиці й спецсимволів), конвертер колірного простору CMYK у sRGB, виправлення чорного фону (Edge-only floodfill) та порядковий візуальний порівняльний перегляд.
|
||||||
- Вкладка 6 (Заглушки): Автозаміна відсутніх фото товарів, категорій та брендів.
|
- Вкладка 6 (Водяні знаки): Динамічне накладання водяних знаків (зображення або текст) на льоту з прозорістю, кутом, шрифтом TTF та фільтрацією за категоріями.
|
||||||
- Вкладка 7 (Інструменти & Крон): Санітайзер імен, конвертер CMYK у sRGB, виправлення чорних фонів, планувальник Cron.
|
- Вкладка 7 (Заглушки): Автопідстановка зображень-заглушок для товарів, категорій та брендів без фото.
|
||||||
|
- Вкладка 8 (Крон-завдання): Автоматичний фоновий запуск стиснення, очищення, санітайзера та виправлення чорних фонів за розкладом (щодня, щотижня, щомісяця).
|
||||||
|
- Вкладка 9 (Інфо & Екосистема [NAT]): Графік використання диска, контакти підтримки та кнопка Онлайн Інструкції.
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN)
|
🇷🇺 РУССКИЙ ЯЗЫК (RUSSIAN)
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
УСТАНОВКА МОДУЛЯ:
|
УСТАНОВКА И ОБНОВЛЕНИЕ:
|
||||||
1. Распакуйте архив.
|
1. Распакуйте архив.
|
||||||
2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP.
|
2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP.
|
||||||
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2).
|
3. Перейдите в "Система" -> "Пользователи" -> "Группы пользователей", выберите группу (Administrator) и установите галочки прав для: extension/module/img_opti (или module/img_opti для OC 2.0-2.2).
|
||||||
4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать".
|
4. Перейдите в "Модули / Расширения", найдите "Image Optimizer [NAT]", нажмите "Установить", затем "Редактировать".
|
||||||
|
|
||||||
ФУНКЦИОНАЛ И ВКЛАДКИ:
|
ПОЛНЫЙ ОБЗОР ВСЕХ 9 ВКЛАДОК И ФУНКЦИОНАЛА:
|
||||||
- Вкладка 1 (Инфо и статистика): График диска, накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON и кнопка перехода к Онлайн Инструкции.
|
- Вкладка 1 (Настройки & Статистика): Выбор движка GD или Imagick (с четкой маркировкой действий), накопительная статистика из базы данных сайта (учитывает Оптимизацию, Очистку, Инструменты и Крон) с кнопкой [Сбросить статистику], 100% экспорт/импорт настроек в JSON, правила для отдельных папок и кнопка Онлайн Инструкции.
|
||||||
- Вкладка 2 (Сжатие и Ресайз): Выбор движка (GD или Imagick с маркировкой действий), размеров, качества WebP/JPG/PNG и выбор папок.
|
- Вкладка 2 (Сжатие и Ресайз): Выбор папок каталога, режим безопасной копии (catalog_new) или замены оригиналов, настройки макс. ширины/высоты, качества (WebP/JPG/PNG), многопоточность, пороги экономии и симметричные кнопки [ПАУЗА] и [ЗУПИНИТИ] 50/50.
|
||||||
- Вкладка 3 (Очистка от мусора): Поиск неиспользуемых изображений, отправка в Карантин или окончательное удаление.
|
- Вкладка 3 (Очистка от мусора): Глубокое сканирование БД и файлов шаблона (.tpl, .twig, .php, .css, .js), безопасный Карантин (image/catalog_trash/) с восстановлением в один клик или окончательное удаление.
|
||||||
- Вкладка 4 (Форматы & Защита): Защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard), WebP на лету, SVG, Lazy Load.
|
- Вкладка 4 (Форматы & Защита): Автоматическая защита от фейковых JPG на лету (On-the-Fly Fake JPG Guard с выбором режима белый JPG / прозрачный PNG), WebP на лету, SVG, Lazy Load (blur-up) и заглушка для битых ссылок.
|
||||||
- Вкладка 5 (Водяные знаки): Наложение водяных знаков (текст/фото) на лету.
|
- Вкладка 5 (Инструменты Pro & Предпросмотр): Санитайзер имен (очистка кириллицы и спецсимволов), конвертер цветового пространства CMYK в sRGB, исправление черного фона (Edge-only floodfill) и построчный визуальный сравнительный предпросмотр.
|
||||||
- Вкладка 6 (Заглушки): Автозамена отсутствующих фото товаров, категорий и брендов.
|
- Вкладка 6 (Водяные знаки): Динамическое наложение водяных знаков (изображение или текст) на лету с прозрачностью, углом, шрифтом TTF и фильтрацией по категориям.
|
||||||
- Вкладка 7 (Инструменты & Крон): Санитайзер имен, конвертер CMYK в sRGB, исправление черных фонов, планировщик Cron.
|
- Вкладка 7 (Заглушки): Автоподстановка изображений-заглушек для товаров, категорий и брендов без фото.
|
||||||
|
- Вкладка 8 (Крон-задачи): Автоматический фоновый запуск сжатия, очистки, санитайзера и исправления черных фонов по расписанию (ежедневно, еженедельно, ежемесячно).
|
||||||
|
- Вкладка 9 (Инфо & Экосистема [NAT]): График использования диска, контакты поддержки и кнопка Онлайн Инструкции.
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
🇬🇧 ENGLISH
|
🇬🇧 ENGLISH
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
INSTALLATION:
|
INSTALLATION & UPGRADE:
|
||||||
1. Extract the archive.
|
1. Extract the archive.
|
||||||
2. Upload the contents of upload/ to your OpenCart root directory via FTP.
|
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).
|
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.
|
4. Go to Extensions -> Modules, install "Image Optimizer [NAT]", and click Edit.
|
||||||
|
|
||||||
FEATURES & TABS:
|
EXHAUSTIVE 9-TAB MODULE OVERVIEW:
|
||||||
- Tab 1 (Info & Stats): Disk chart, persistent DB stats with reset button, 100% full JSON settings export/import, online instruction link button.
|
- 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): GD / Imagick engine selection with labelled actions, batch resizing, WebP/JPG/PNG quality controls.
|
- 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): Smart search for unused catalog photos, safe quarantine and permanent deletion.
|
- 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 protection, WebP on-the-fly, SVG, Lazy Load.
|
- 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 (Watermarks): On-the-fly image and text watermarks with position and opacity rules.
|
- 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 (Placeholders): Fallback images for missing photos.
|
- Tab 6 (Watermarks): Dynamic on-the-fly image and text overlays with opacity, angle, TTF font, and category filtering.
|
||||||
- Tab 7 (Tools & Cron): Name Sanitizer, CMYK to sRGB converter, Black BG repair, Cron background runner.
|
- 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.
|
||||||
|
|
|
||||||
73
readme.txt
73
readme.txt
|
|
@ -4,7 +4,7 @@ Image Optimizer [NAT]: Compress originals & remove unused images v1.2.0
|
||||||
|
|
||||||
Thank you for purchasing our extension!
|
Thank you for purchasing our extension!
|
||||||
If you have any questions, feel free to contact us: info@nat.od.ua
|
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.
|
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).
|
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).
|
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 the "Install" (green plus) button.
|
4. Go to Extensions -> Extensions -> Modules. Find "Image Optimizer [NAT]" and click "Install", then "Edit".
|
||||||
5. Click the "Edit" button to access the module panel.
|
|
||||||
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------
|
--------------------------------------------------------------------------------
|
||||||
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!
|
WARNING: Always create a full backup of your /image/catalog/ folder before running any optimizations or deletions!
|
||||||
|
|
||||||
TAB 1: INFO & STATS
|
TAB 1: MODULE SETTINGS & SYSTEM STATUS
|
||||||
- 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.
|
- Engine Selection: GD (Standard) or Imagick (Advanced) with explicit GD/Imagick action labelling across all scanning tools.
|
||||||
- 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.
|
- Individual Folder Rules: Set per-folder custom JPG/WebP quality and max width/height overrides.
|
||||||
- Full Export / Import (JSON): Export and restore 100% of module settings (Cron tasks, watermark rules, placeholders, folder limits, format guards).
|
- Disk Usage Chart: Renders a pie chart of folder sizes (Catalog, Cache, Trash) with manual quota limit override.
|
||||||
- Online Web-Instruction Button: Direct link to the complete web documentation at http://oc3-demo.nat.od.ua/instructions/image_optimizer_nat_instruction.html.
|
- 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)
|
TAB 2: OPTIMIZE & RESIZE (COMPRESSION)
|
||||||
1. Enter your License Key (Token) in the respective field.
|
- Multi-folder Tree Selection: Select specific subfolders inside image/catalog/.
|
||||||
2. Select target processing engine: GD (Standard) or Imagick (Advanced). Actions are explicitly labelled (GD / Imagick).
|
- Safe Copy vs Replace Originals: Choose between creating a backup copy (catalog_new) or replacing originals directly.
|
||||||
3. Select target folders inside image/catalog/.
|
- Dimension Limits & Quality Controls: Max width/height, JPG quality (0-100), PNG quality (0-9), WebP quality (0-100).
|
||||||
4. Choose Mode: "Create a copy" (Safest) or "Replace originals".
|
- Performance & Multi-threading: Batch chunk size, log screen lines, and multi-threading execution controls.
|
||||||
5. Set maximum Width/Height and WebP/JPG/PNG quality settings.
|
- Savings Replacement Thresholds: Minimum byte/percent savings required to replace files.
|
||||||
6. Click "START OPTIMIZATION". Balanced 50/50 Pause & Stop UI controls allow full control during batch execution.
|
- Interactive Controls: Balanced 50/50 Pause & Stop controls during active processing, plus cache clear button.
|
||||||
|
|
||||||
TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL)
|
TAB 3: UNUSED IMAGES CLEANER (JUNK REMOVAL)
|
||||||
1. Select the folders to scan.
|
- 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.
|
||||||
2. Click "FIND JUNK". The module compares physical files on disk with your Database and Theme files.
|
- Safe Quarantine & permanent deletion: Move unused files to image/catalog_trash/ with one-click restore capability, or delete permanently.
|
||||||
3. Review the detailed log of unused files.
|
|
||||||
4. Click "To Quarantine" to safely move junk files to image/catalog_trash/, or "Delete permanently" to wipe them from the server.
|
|
||||||
|
|
||||||
TAB 4: FORMATS (WEBP & FAKE JPG GUARD)
|
TAB 4: IMAGE FORMATS & PROTECTION
|
||||||
- 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.
|
- Support SVG & WebP: Enable native SVG uploading and WebP conversion (including TrueFileManager integration).
|
||||||
- WebP "on-the-fly", SVG support, and progressive Lazy Load with blur-up.
|
- 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
|
TAB 5: TOOLS (PRO) & VISUAL PREVIEW
|
||||||
- Dynamic Overlay rules: Set up watermarks (image or text) on-the-fly with position, transparency, angle, font, and category filters.
|
- 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
|
TAB 6: WATERMARKS
|
||||||
- Renders fallback images for products, categories, or brands without images.
|
- 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
|
TAB 7: PLACEHOLDERS
|
||||||
- Name Sanitizer, CMYK to sRGB Converter, Black Background Fixer.
|
- Automatic fallback image replacement for products, categories, and brands without an assigned image.
|
||||||
- Cron background scheduler for continuous automated store optimization.
|
|
||||||
|
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.
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue