=== Kashida Image Optimizer ===
Contributors: mrwanbg
Tags: image optimization, webp, avif, images, performance
Requires at least: 5.5
Requires PHP: 8.0
Tested up to: 7.1
Stable tag: 5.1.27
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Optimize WordPress images with WebP and AVIF support, flexible quality settings, batch processing, and original-image preservation.

== Description ==

Kashida Image Optimizer helps you manage image optimization directly from your WordPress dashboard. It can create optimized WebP and AVIF versions of supported images while preserving the original JPG, JPEG, and PNG files.

Large image files can take up unnecessary storage and increase the amount of data a website needs to deliver. Kashida Image Optimizer provides practical tools to optimize new uploads and process images already stored in your Media Library, with settings that let you balance file size and visual quality.

= Key Features =

* **Automatic optimization:** Process supported images when they are uploaded to WordPress.
* **WebP and AVIF support:** Generate modern image formats with separate quality settings, subject to server capabilities and plugin settings.
* **Original image preservation:** Keep original JPG, JPEG, and PNG files unchanged.
* **Smart PNG handling:** Handle transparent artwork with PNG-focused optimization behavior.
* **Smart Content Detection:** Detect image content such as photos and graphics to help apply suitable processing.
* **Large-image safeguards:** Skip images over the automatic-processing limits to help avoid resource-intensive operations.
* **Batch processing:** Convert or regenerate supported images already in the Media Library.
* **Media Library actions:** Run available optimization actions on individual images.
* **Optimization statistics:** Review optimization information provided by the plugin.
* **Orphan-file cleanup:** Access tools for cleaning up orphaned optimized files.
* **Local processing:** Image optimization runs on your WordPress server rather than sending images to an external optimization service.
* **Translation-ready interface:** Uses WordPress internationalization functions and supports WordPress.org language packs.

= Designed for a practical workflow =

Kashida Image Optimizer brings image optimization tools into the WordPress admin area, so you can manage supported uploads and existing media without relying on a separate external service. Available formats and processing behavior depend on your configuration and your hosting environment.

= Who is it for? =

* WordPress site owners who want to optimize their media library.
* Designers and developers managing image-heavy websites.
* Website administrators who need control over image quality and output formats.
* Users who prefer to preserve their original image files while generating optimized versions.

== العربية ==

إضافة **Kashida Image Optimizer** تساعدك على تحسين الصور مباشرة من لوحة تحكم ووردبريس، مع دعم إنشاء نسخ محسّنة بصيغتي WebP وAVIF للصور المدعومة، مع الحفاظ على ملفات JPG وJPEG وPNG الأصلية دون تعديلها.

قد تشغل الصور الكبيرة مساحة تخزين إضافية وتزيد حجم البيانات التي يحتاج الموقع إلى تحميلها. توفر الإضافة أدوات لتحسين الصور الجديدة عند رفعها، وكذلك معالجة الصور الموجودة مسبقًا في مكتبة الوسائط، مع إعدادات تساعدك على الموازنة بين حجم الملف وجودة الصورة.

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

* **التحسين التلقائي:** معالجة الصور المدعومة عند رفعها إلى ووردبريس.
* **دعم WebP وAVIF:** إنشاء نسخ بصيغ الصور الحديثة مع إعدادات مستقلة للجودة، بحسب إعدادات الإضافة وإمكانيات الخادم.
* **الحفاظ على الصور الأصلية:** الاحتفاظ بملفات JPG وJPEG وPNG الأصلية دون تعديلها.
* **التعامل مع صور PNG:** خيارات معالجة تراعي الصور التي تحتوي على خلفيات شفافة.
* **التعرّف الذكي على المحتوى:** التمييز بين أنواع المحتوى مثل الصور الفوتوغرافية والرسومات للمساعدة في اختيار المعالجة المناسبة.
* **التعامل الآمن مع الصور الكبيرة:** تخطي الصور التي تتجاوز حدود المعالجة التلقائية لتقليل العمليات التي تستهلك موارد الخادم.
* **المعالجة الجماعية:** تحويل الصور المدعومة أو إعادة إنشائها للصور الموجودة في مكتبة الوسائط.
* **إجراءات من مكتبة الوسائط:** تنفيذ عمليات التحسين المتاحة على الصور الفردية.
* **إحصائيات التحسين:** مراجعة معلومات التحسين التي توفرها الإضافة.
* **تنظيف الملفات المتبقية:** أدوات للتعامل مع ملفات التحسين اليتيمة.
* **معالجة محلية:** تتم معالجة الصور على خادم ووردبريس، دون إرسالها إلى خدمة تحسين خارجية.
* **دعم الترجمة:** تعتمد الإضافة على نظام الترجمة القياسي في ووردبريس وتدعم حزم اللغات من WordPress.org.

= لمن تناسب الإضافة؟ =

* أصحاب مواقع ووردبريس الذين يريدون تحسين مكتبة الصور.
* المصممون والمطورون الذين يديرون مواقع تعتمد على الصور.
* مسؤولو المواقع الذين يحتاجون إلى التحكم في جودة الصور وصيغ الإخراج.
* المستخدمون الذين يرغبون في إنشاء نسخ محسّنة مع الاحتفاظ بالصور الأصلية.

== Installation ==

1. Upload the `kashida-image-optimizer` folder to the `/wp-content/plugins/` directory, or install the ZIP file from **Plugins > Add New > Upload Plugin**.
2. Activate Kashida Image Optimizer through the **Plugins** screen in WordPress.
3. Open Kashida Image Optimizer from the WordPress admin menu.
4. Configure the available optimization and quality settings, then save your changes.
5. Upload new images or use the available tools to process supported images already in the Media Library.

== Frequently Asked Questions ==

= Are original images modified? =

No. The plugin is designed to preserve original JPG, JPEG, and PNG files while creating optimized versions.

= Does the plugin optimize large images automatically? =

Images larger than 10 MB or wider or taller than 6000 pixels are skipped during automatic optimization. These images can still be processed manually from the Media Library, subject to available server resources.

= Does AVIF work on every server? =

No. AVIF generation requires server-side image-processing support for AVIF encoding. WebP is available independently when the server supports the required processing.

= Can I optimize images that are already in my Media Library? =

Yes. The plugin provides batch conversion or regeneration tools and actions for individual media items. Available actions depend on the image and the current configuration.

= Does the plugin send images to an external service? =

No. Image optimization is performed locally on your WordPress server. The plugin does not send images or personal data to an external optimization service.

= Does the plugin support translation? =

Yes. The plugin uses the `kashida-image-optimizer` text domain and standard WordPress internationalization functions. Translations can be delivered through WordPress.org language packs.

= Where can I get help or report a problem? =

Please use the Support section on the plugin's WordPress.org page to ask questions or report issues. When reporting a problem, include your WordPress version, PHP version, relevant server image-processing capabilities, and the steps needed to reproduce the issue. Do not include passwords or other sensitive information.

== Privacy ==

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

== Changelog ==

= 5.1.27 =
* Fixed Media Library Re-optimize and Delete optimized actions by defining their JavaScript translation strings on the Media Library screen.

= 5.1.26 =
* Improved unique prefixes for plugin functions, constants, settings, and AJAX actions.
* Updated contributor metadata and removed bundled translation files for WordPress.org language-pack delivery.
* Added migration for existing settings saved under the legacy option key.

= 5.1.25 =
* No changelog entry provided.

= 5.1.24 =
* Improved WordPress Plugin Check compatibility.
* Improved output escaping for translated admin markup.
* Replaced direct writability checks with the WordPress filesystem helper.
* Improved internationalization comments and translatable help strings.
* Removed unnecessary manual text-domain loading for WordPress.org language packs.
* Updated plugin version metadata to 5.1.24.

= 5.1.23 =
* WordPress.org submission preparation and compliance updates.

= 5.1.22 =
* WordPress.org compliance improvements.
* Added GPL-2.0-or-later licensing metadata.
* Added production readme documentation.
* Improved gettext compatibility by making translatable strings statically discoverable.
* Added POT, PO, and MO translation files, including Arabic.
* Deferred local text-domain loading to the `init` hook.
* Maintained existing optimization, delivery, and admin functionality.

= 5.1.21 =
* Added bundled translation resources and Arabic localization support.

= 5.1.20 =
* Added translation support for the plugin interface.
