179 lines
13 KiB
Plaintext
179 lines
13 KiB
Plaintext
=========================================================
|
||
Image Optimizer [NAT]: Compress originals & remove unused images v1.2.0 — Инструкция / Instructions / Інструкція
|
||
=========================================================
|
||
|
||
---------------------------------------------------------
|
||
🇷🇺 РУССКИЙ ЯЗЫК
|
||
---------------------------------------------------------
|
||
УСТАНОВКА МОДУЛЯ:
|
||
1. Распакуйте архив.
|
||
2. Загрузите содержимое папки upload/ в корень вашего сайта по FTP (системные файлы не перезаписываются).
|
||
3. Перейдите в админ-панели в "Система" -> "Пользователи" -> "Группы пользователей", выберите вашу группу (Administrator) и установите галочки прав на просмотр и изменение для: extension/module/img_opti
|
||
4. Перейдите в "Модули / Расширения" -> "Модули", найдите "Image Optimizer [NAT]", нажмите "Активировать" (зеленый плюс), затем "Редактировать".
|
||
|
||
ОБНОВЛЕНИЕ:
|
||
Загрузите новые файлы поверх старых по FTP.
|
||
|
||
УДАЛЕНИЕ:
|
||
Деактивируйте модуль в списке расширений. Удалите файлы модуля:
|
||
- admin/controller/extension/module/img_opti.php
|
||
- admin/language/*/extension/module/img_opti.php
|
||
- admin/view/template/extension/module/img_opti.twig
|
||
|
||
КАК РАБОТАТЬ С МОДУЛЕМ:
|
||
ВНИМАНИЕ! Перед любыми манипуляциями ОБЯЗАТЕЛЬНО сделайте бэкап папки /image/catalog/ на сервере!
|
||
|
||
Вкладка 1 (Инфо и статистика):
|
||
- График диска: Анализирует размер папок (картинки, кэш, корзина). Можно задать лимит тарифа вручную и включить/выключить автообновление графика при входе.
|
||
- Статистика оптимизации: Отображает общее число обработанных файлов и сэкономленный дисковый объем.
|
||
|
||
Вкладка 2 (Сжатие и оптимизация):
|
||
1. Введите лицензионный токен.
|
||
2. Выберите папки для сжатия, укажите лимиты по ширине/высоте и качеству (WebP/JPG/PNG).
|
||
3. Выберите режим (Безопасное копирование в новую папку или Замена оригиналов) и нажмите "СТАРТ ОПТИМИЗАЦИИ".
|
||
|
||
Вкладка 3 (Очистка неиспользуемых):
|
||
1. Выберите папки для поиска мусора.
|
||
2. Нажмите "НАЙТИ МУСОР". Модуль сверит физические файлы с базой данных и шаблонами.
|
||
3. Проверьте найденные файлы в логе и отправьте их в "Карантин" (безопасно) или удалите навсегда.
|
||
|
||
Вкладка 4 (Водяные знаки):
|
||
- Настройка правил наложения водяных знаков (изображений или текста) для товаров, категорий, брендов и баннеров "на лету" с фильтрацией по категориям, регулировкой угла наклона, прозрачности и скругления кутов.
|
||
|
||
Вкладка 5 (Заглушки):
|
||
- Автоподстановка картинок-заглушек для товаров, категорий и производителей, у которых изображение не задано в каталоге.
|
||
|
||
Вкладка 6 (Форматы изображений 🧪 BETA):
|
||
- WebP "на лету", поддержка SVG, прогрессивный Lazy Load (эффект плавного размытия blur-up при прокрутке страницы) и переопределение глобальной заглушки для битых ссылок.
|
||
|
||
Вкладка 7 (Инструменты (pro) 🧪 BETA):
|
||
- Санитайзер имен: Очистка имен файлов и папок от кириллицы, пробелов и спецсимволов.
|
||
- Битые ссылки в БД: Поиск и очистка записей БД с отсутствующими файлами.
|
||
- Битые файлы на сервере: Поиск и удаление испорченных картинок и файлов по 0 байт.
|
||
- Поиск тяжелых файлов: Быстрое нахождение самых объемных файлов для ручного сжатия.
|
||
- Конвертер CMYK: Перекодирование изображений из CMYK в sRGB для корректного показа на iPhone/Safari.
|
||
|
||
Вкладка 8 (Крон 🧪 BETA):
|
||
- Настройка расписания автоматического фонового сжатия папок через системный планировщик задач.
|
||
|
||
|
||
|
||
---------------------------------------------------------
|
||
🇬🇧 ENGLISH
|
||
---------------------------------------------------------
|
||
INSTALLATION:
|
||
1. Extract the archive.
|
||
2. Upload the contents of the upload/ folder to your OpenCart root directory via FTP (no core files are overwritten).
|
||
3. Go to System -> Users -> User Groups, select your group (Administrator) and check Access/Modify permissions for: extension/module/img_opti
|
||
4. Go to Extensions -> Modules, find "Image Optimizer [NAT]", click "Install" (green plus), then "Edit".
|
||
|
||
UPDATING:
|
||
Upload new files over the old ones via FTP.
|
||
|
||
UNINSTALLATION:
|
||
Uninstall the module from the Extensions list. Delete the module files from:
|
||
- admin/controller/extension/module/img_opti.php
|
||
- admin/language/*/extension/module/img_opti.php
|
||
- admin/view/template/extension/module/img_opti.twig
|
||
|
||
HOW TO USE (TABS & FEATURES):
|
||
WARNING! Always create a full backup of your /image/catalog/ folder before running any optimizations or deletions!
|
||
|
||
Tab 1 (Info & Stats):
|
||
- Disk Usage Chart: Renders a pie chart of folder sizes (Image Catalog, Cache, Trash). Supports manual hosting quota limit overrides and auto-update toggling on page open.
|
||
- Cumulative Stats: Displays total optimized files and total disk space saved.
|
||
|
||
Tab 2 (Optimize & Resize):
|
||
1. Enter your license token.
|
||
2. Select target folders, adjust Max Width/Height and quality settings (WebP/JPG/PNG).
|
||
3. Select operation mode (Create a copy or Replace originals) and click "START OPTIMIZATION".
|
||
|
||
Tab 3 (Junk Cleaner):
|
||
1. Select the folders to scan.
|
||
2. Click "FIND JUNK". The module compares physical files on disk with your Database and Theme files.
|
||
3. Review the found files in the log and move them to "Quarantine" (safe) or delete them permanently.
|
||
|
||
Tab 4 (Watermarks):
|
||
- Dynamic Overlay rules: Set up watermarks (image or text) to overlay on category, brand, banner, or product images on-the-fly.
|
||
- Position, transparency, angle, font (TTF), size scaling, and category exclusion/inclusion filters are fully supported.
|
||
|
||
Tab 5 (Placeholders):
|
||
- Renders fallback images for products, categories, or brands that do not have an image assigned in the database, keeping the storefront look consistent.
|
||
|
||
Tab 6 (Image Formats 🧪 BETA):
|
||
- WebP Support: Enable WebP on-the-fly delivery.
|
||
- SVG Support: Safe SVG rendering.
|
||
- Progressive Lazy Loading: Blur-up effect (loads micro-preview and fades/de-blurs smoothly as user scrolls).
|
||
- Fallback Image: Set global placeholder image for broken images.
|
||
|
||
Tab 7 (Tools (pro) 🧪 BETA):
|
||
- Filename Sanitizer: Clear names of cyrillic letters, spaces, and special symbols in file and directory paths.
|
||
- Broken DB Scanner: Finds and fixes database records referencing non-existent files.
|
||
- Broken Files Scanner: Scans the server to clean up corrupted or 0-byte images.
|
||
- Heavy Files: Find the largest images on disk and optimize them instantly.
|
||
- CMYK Converter: Convert color space of JPEG files from CMYK to sRGB for Apple iOS/Safari compatibility.
|
||
|
||
Tab 8 (Cron 🧪 BETA):
|
||
- Configure automated background directory scans and image compression schedules using a Cron token.
|
||
|
||
|
||
|
||
---------------------------------------------------------
|
||
🇺🇦 УКРАЇНСЬКА МОВА
|
||
---------------------------------------------------------
|
||
ВСТАНОВЛЕННЯ:
|
||
1. Розпакуйте архів.
|
||
2. Завантажте вміст папки upload/ в корінь вашого сайту по FTP (системні файли не перезаписуються).
|
||
3. Перейдіть у "Система" -> "Користувачі" -> "Групи", виберіть вашу групу (Administrator) і встановіть галочки прав на перегляд і зміну для: extension/module/img_opti
|
||
4. Перейдіть у "Модулі / Розширення" -> "Модулі", знайдіть "Image Optimizer [NAT]", натисніть "Активувати" (зелений плюс), потім "Редагувати".
|
||
|
||
ОНОВЛЕННЯ:
|
||
Завантажте нові файли поверх старих по FTP.
|
||
|
||
ЯК ПРАЦЮВАТИ З МОДУЛЕМ:
|
||
УВАГА! Перед будь-якими маніпуляціями ОБОВ'ЯЗКОВО зробіть бекап папки /image/catalog/ на сервері!
|
||
|
||
Вкладка 1 (Інфо та статистика):
|
||
- Графік диска: Аналізує розмір папок (зображення, кэш, кошик). Можна задати ліміт тарифу вручну та увімкнути/вимкнути автооновлення графіка при вході.
|
||
- Статистика оптимізації: Показує загальну кількість оброблених файлів та збережений об`єм диска.
|
||
|
||
Вкладка 2 (Стиснення та оптимізація):
|
||
1. Введіть ліцензійний токен.
|
||
2. Виберіть папки для стиснення, вкажіть ліміти по ширині/висоті та якості (WebP/JPG/PNG).
|
||
3. Виберіть режим (Безпечне копіювання в нову папку або Заміна оригіналів) і натисніть "СТАРТ ОПТИМІЗАЦІЇ".
|
||
|
||
Вкладка 3 (Очищення невикористовуваних):
|
||
1. Виберіть папки для пошуку сміття.
|
||
2. Натисніть "ЗНАЙТИ СМІТТЯ". Модуль звірить фізичні файли з базой даних та шаблонами.
|
||
3. Перевірте знайдені файли в лозі та відправте їх у "Карантин" (безпечно) або видаліть назавжди.
|
||
|
||
Вкладка 4 (Водяні знаки):
|
||
- Налаштування правил накладання водяних знаків (зображень або тексту) для товарів, категорій, брендів та банерів "на льоту" з фільтрацією за категоріями, регулюванням кута нахилу, прозорості та заокруглення кутів.
|
||
|
||
Вкладка 5 (Заглушки):
|
||
- Автопідстановка картинок-заглушек для товарів, категорій та виробників, у яких зображення не задано в каталозі.
|
||
|
||
Вкладка 6 (Формати зображень 🧪 BETA):
|
||
- WebP "на льоту", підтримка SVG, прогресивний Lazy Load (ефект плавного розмиття blur-up при прокручуванні сторінки) та перевизначення глобальної заглушки для битих посилань.
|
||
|
||
Вкладка 7 (Інструменти (pro) 🧪 BETA):
|
||
- Санітайзер імен: Очищення назв файлів та папок від кирилиці, пробілів та спецсимволів.
|
||
- Биті посилання в БД: Пошук та очищення записів БД з відсутніми файлами.
|
||
- Биті файли на сервері: Пошук та вилучення зіпсованих картинок та файлів по 0 байт.
|
||
- Пошук важких файлів: Швидке знаходження найоб`ємніших файлів для стиснення.
|
||
- Конвертер CMYK: Перекодування зображень з CMYK в sRGB для коректного відображення на iPhone/Safari.
|
||
|
||
Вкладка 8 (Крон 🧪 BETA):
|
||
- Налаштування розкладу автоматичного фонового стиснення папок через системний планувальник завдань.
|
||
|
||
|
||
|
||
=========================================================
|
||
🔥 OUR OTHER OPENCART EXTENSIONS / НАШИ ДРУГИЕ МОДУЛИ / НАШІ ІНШІ МОДУЛІ:
|
||
=========================================================
|
||
• Catalog Optimizer [NAT]: Hide empty categories/brands, clear unused attributes/options.
|
||
• Domain Scanner [NAT]: Find and clean external links and images.
|
||
• Promo Top Bar [NAT]: Create interactive promo bars, marquees and header slideshows.
|
||
|
||
|
||
Support: info@nat.od.ua |