Kashida Image Optimizer

Description

Kashida Image Optimizer is a lightweight WordPress plugin that creates optimized WebP and AVIF versions of supported images while preserving the original JPG, JPEG, and PNG files. It helps reduce image payloads and improve page-loading performance without sending images to an external optimization service.

Designed for both new uploads and existing media libraries, the plugin combines automatic optimization, configurable quality controls, smart handling for PNG artwork, batch processing, per-image actions, statistics, and cleanup tools in one focused interface.

Key Features

• Automatic optimization: Process eligible images when they are uploaded to WordPress.
• WebP and AVIF generation: Create modern image formats when supported by the server’s image-processing libraries.
• Independent quality settings: Configure WebP and AVIF quality separately and choose from quality presets.
• Smart PNG handling: Choose Smart, Quality, or Lossless handling for PNG-to-WebP conversion. The Smart mode preserves transparency using lossless WebP where applicable.
• Smart Content Detection: Apply separate quality settings for photos and graphics to balance file size and visual detail.
• Large-image protection: Skip automatic processing when an original image is larger than 10 MB or exceeds 6000 pixels in width or height. These images can still be processed manually.
• Batch conversion and regeneration: Process existing items in the Media Library, or regenerate optimized versions after adjusting settings.
• Resumable batch processing: If a batch is interrupted, use Continue to resume from the saved progress in the same browser and website. Clearing browser storage or switching browsers may remove the saved checkpoint.
• Server-block guidance: Provide guidance for HTTP 403 and temporary request failures that may be caused by hosting security rules, firewalls, rate limits, or related server restrictions.
• Media Library actions: View optimization status and available WebP/AVIF results, compare file sizes, and run supported actions on individual images.
• Optimized delivery: Select an available optimized version according to format support and file-size results, while retaining the original as a fallback.
• Statistics and cleanup: Review optimization results and clean up eligible orphaned generated files.
• Optional uninstall cleanup: When explicitly enabled in settings, remove generated WebP/AVIF derivatives during uninstall. Original image files are preserved.
• Translation-ready interface: Includes Arabic translation resources and a POT template for preparing additional language translations through WordPress gettext tools.

Original Images Stay Intact

The plugin creates optimized derivative files and does not replace or overwrite the original JPG, JPEG, or PNG source files. Optimization results and format availability depend on the server’s image-processing capabilities and configuration.

Recommended Workflow

1. Install and activate the plugin, then review its quality and format settings.
2. Enable automatic optimization for new uploads if desired.
3. Run batch conversion for the existing Media Library. Large libraries or hosting security limits may interrupt processing; use Continue to resume where the saved checkpoint is available.
4. Review the optimization status and file-size savings in the Media Library.
5. If you change quality settings, use the re-optimization or regeneration action to apply the new settings to existing generated files.

الوصف باللغة العربية

إضافة كشيدة لتحسين الصور هي إضافة خفيفة لووردبريس تُنشئ نسخًا محسّنة من الصور بصيغتي WebP وAVIF مع الحفاظ على ملفات الصور الأصلية JPG وJPEG وPNG دون تعديلها أو استبدالها. تهدف الإضافة إلى تقليل حجم الصور وتحسين أداء تحميل الصفحات، وتُجري معالجة الصور محليًا على خادم موقعك دون إرسالها إلى خدمات تحسين خارجية.

تجمع الإضافة بين التحسين التلقائي للصور الجديدة، ومعالجة مكتبة الوسائط الحالية، والتحكم في الجودة، والمعالجة الذكية لصور PNG، وإعادة التحسين، وإحصاءات التوفير، وأدوات التنظيف ضمن واجهة واحدة.

المميزات الرئيسية

• التحسين التلقائي: تحسين الصور المؤهلة عند رفعها إلى مكتبة وسائط ووردبريس.
• دعم WebP وAVIF: إنشاء نسخ محسّنة بالصيَغ الحديثة عندما تدعم مكتبات معالجة الصور على الخادم ذلك.
• إعدادات جودة مستقلة: ضبط جودة WebP وجودة AVIF كلٌّ على حدة، مع إعدادات مسبقة تناسب أحجام الملفات وجودة الصورة.
• المعالجة الذكية لصور PNG: اختيار الوضع الذكي أو وضع الجودة أو الوضع دون فقدان الجودة عند تحويل PNG إلى WebP. يساعد الوضع الذكي على الحفاظ على الشفافية باستخدام WebP دون فقدان الجودة عند انطباق ذلك.
• التعرّف الذكي على محتوى الصورة: استخدام إعدادات جودة مختلفة للصور الفوتوغرافية والرسومات لتحقيق توازن بين حجم الملف والتفاصيل البصرية.
• حماية الصور الكبيرة: تتجاوز الإضافة التحسين التلقائي إذا تجاوز حجم الصورة الأصلية 10 ميجابايت أو تجاوز عرضها أو ارتفاعها 6000 بكسل. ويمكن معالجة هذه الصور يدويًا.
• التحويل الجماعي وإعادة التوليد: معالجة الصور الموجودة في مكتبة الوسائط أو إعادة إنشاء النسخ المحسّنة بعد تغيير إعدادات الجودة.
• استكمال التحويل بعد الانقطاع: عند توقف التحويل الجماعي، يمكن استخدام زر متابعة (Continue) لاستكمال العمل من نقطة التوقف المحفوظة في المتصفح والموقع نفسيهما. قد يؤدي مسح بيانات التخزين في المتصفح أو استخدام متصفح آخر إلى فقدان نقطة الاستكمال.
• إرشادات أخطاء الخادم: عرض إرشادات عند ظهور HTTP 403 أو أخطاء اتصال مؤقتة قد تنتج عن جدار الحماية أو قواعد حماية الاستضافة أو حدود الطلبات.
• التكامل مع مكتبة الوسائط: عرض حالة التحسين ونتائج WebP وAVIF وأحجام الملفات، مع تنفيذ الإجراءات المتاحة لكل صورة.
• تقديم النسخة المحسّنة المناسبة: الاستفادة من الصيغ المتاحة بحسب دعم المتصفح ونتائج حجم الملفات، مع الاحتفاظ بالصورة الأصلية كخيار احتياطي.
• الإحصاءات وأدوات التنظيف: مراجعة نتائج التحسين وتنظيف الملفات المولّدة اليتيمة المؤهلة للحذف.
• تنظيف اختياري عند إزالة الإضافة: عند تفعيل الخيار المخصص، يمكن حذف ملفات WebP وAVIF المولّدة عند إلغاء تثبيت الإضافة. تبقى الصور الأصلية محفوظة.
• دعم الترجمة: تتضمن الإضافة ملفات ترجمة عربية وقالب POT للمساعدة على إعداد ترجمات بلغات إضافية باستخدام نظام الترجمة في ووردبريس.

الحفاظ على الصور الأصلية

تنشئ الإضافة ملفات محسّنة مشتقة ولا تستبدل ملفات JPG وJPEG وPNG الأصلية أو تكتب فوقها. يعتمد توفر الصيغ ونتائج التحسين على قدرات مكتبات معالجة الصور وإعدادات الخادم.

طريقة الاستخدام الموصى بها

1. ثبّت الإضافة وفعّلها، ثم راجع إعدادات الجودة والصيغ.
2. فعّل التحسين التلقائي للصور الجديدة إذا كنت ترغب في ذلك.
3. شغّل التحويل الجماعي لمعالجة الصور الموجودة. قد تتوقف العملية عند وجود مكتبة كبيرة أو قيود أمنية في الاستضافة؛ استخدم متابعة (Continue) عندما تتوفر نقطة استكمال محفوظة.
4. راجع حالة التحسين وحجم الملفات ونسبة التوفير في مكتبة الوسائط.
5. عند تغيير إعدادات الجودة، استخدم إعادة التحسين أو إعادة التوليد لتطبيق الإعدادات الجديدة على النسخ المحسّنة الموجودة.

متطلبات وملاحظات

• تتطلب الإضافة WordPress 5.5 أو أحدث وPHP 8.0 أو أحدث.
• يعتمد توليد WebP وAVIF على دعم مكتبات معالجة الصور المتاحة في الخادم؛ وقد لا يكون AVIF متاحًا في جميع البيئات.
• لا تستطيع الإضافة تجاوز الحظر الذي تفرضه الاستضافة أو جدار الحماية. عند تكرار HTTP 403، راجع سجلات الحماية أو تواصل مع مزوّد الاستضافة لتحديد قاعدة الحظر بدقة.

Privacy

Kashida Image Optimizer does not send images or personal data to an external service. Image optimization is performed locally on the WordPress server.