# Kashii Client‑Side Image Compressor - WordPress Plugin

A professional image compression and optimization tool for WordPress that works entirely client-side. Compress multiple images without storing any data in the database.

## Features

- ✅ **Multiple Image Upload**: Upload and compress multiple images at once
- ✅ **Drag & Drop Support**: Easy drag and drop interface
- ✅ **Client-Side Processing**: All compression happens in the browser - no server uploads
- ✅ **No Database Storage**: Zero data stored in WordPress database
- ✅ **Quality Control**: Adjustable compression quality (40-95%)
- ✅ **Batch Processing**: Compress all images at once or individually
- ✅ **ZIP Download**: Download all compressed images as a single ZIP file
- ✅ **Gallery & List Views**: Switch between gallery and list view modes
- ✅ **Progress Tracking**: Real-time progress indicators for each image
- ✅ **Settings Panel**: Configure max width, preserve EXIF, auto-compress
- ✅ **Elementor Compatible**: Full Elementor widget support
- ✅ **Shortcode Support**: Use `[kashiiict_compressor]` shortcode anywhere
- ✅ **Responsive Design**: Works perfectly on all devices

## Installation

1. Upload the `kashiimalik-client-side-image-compressor` folder to `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Use the shortcode `[kashiiict_compressor]` in any post or page

## Usage

### Shortcode

```
[kashiiict_compressor]
```

With custom title and description:
```
[kashiiict_compressor title="My Custom Title" description="My custom description"]
```

### Elementor Widget

1. Edit a page with Elementor
2. Search for "Kashii Client‑Side Image Compressor" widget
3. Drag and drop it to your page
4. Customize title and description in widget settings

## Requirements

- WordPress 5.0 or higher
- PHP 7.4 or higher
- Modern browser with JavaScript enabled
- jQuery (included with WordPress)

## Browser Support

- Chrome (recommended)
- Firefox
- Safari
- Edge
- Opera

## Technical Details

- **Client-Side Processing**: Uses browser-image-compression library
- **No Server Uploads**: All processing happens in the user's browser
- **Privacy First**: Images never leave the user's device
- **No Database**: Zero database queries or storage
- **CDN Libraries**: Uses jsDelivr CDN for external libraries

## Supported Image Formats

- JPEG (.jpg, .jpeg)
- PNG (.png)
- WebP (.webp)

## File Size Limits

- Maximum file size per image: 10MB
- No limit on number of images (browser performance dependent)

## Settings

- **Default Quality**: 40-95% (default: 80%)
- **Max Width/Height**: 800-3840px (default: 1920px)
- **Preserve EXIF**: Keep or remove EXIF data
- **Auto-Compress**: Automatically compress newly added images

## Changelog

### 1.0.0
- Initial release
- Multiple image upload support
- Client-side compression
- Elementor widget integration
- Shortcode support

## Support

For support, please contact the plugin author.

## License

GPL v2 or later