=== Image Format Converter ===
Contributors: sadathimel, themedot
Plugin URI: https://github.com/sadathimel/image-format-converter
Tags: image converter, jpg, png, webp, avif
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0.1
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Convert images between JPG, PNG, WebP, and AVIF in WordPress admin with a modern UI. Requires GD or Imagick.

== Description ==

Image Format Converter allows administrators to convert images in the WordPress Media Library between JPG/JPEG, PNG, WebP, and AVIF formats. Using server-side PHP libraries (GD or Imagick), it ensures high-quality conversions with minimal file size. Converted images are saved to the uploads folder and optionally added to the Media Library.

**Features:**
- Select images via the WordPress media uploader.
- Choose target format (JPG, PNG, WebP, AVIF).
- Configure quality/compression and Media Library integration via a "Conversion Settings" button (admin-only).
- View server library status (GD/Imagick/WebP/AVIF) with a "How to Enable GD and Imagick" button for setup instructions.
- Modern, clean interface inspired by professional design standards (e.g., TinyJPG-like cards and buttons).
- Secure, efficient, and admin-only (no frontend features).

Access all features on **Media > Image Converter**, with collapsible settings and instructions.

== Installation ==

1. Upload the `image-format-converter` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **Media > Image Converter** to convert images, adjust settings, or view GD/Imagick instructions.

== Frequently Asked Questions ==

= Where do converted images appear? =
Converted images are saved in your uploads folder (e.g., `wp-content/uploads/2025/09/`) with "_converted" appended (e.g., `image_converted.png`). If enabled (default), they appear in **Media > Library**. The success notice shows "Image convert complete" with links to the file and Media Library entry.

= Why don’t I see the converted file? =
Check the success/error notice on **Media > Image Converter**. Ensure GD or Imagick is enabled (see library status). Verify the uploads folder is writable (755/644 permissions). Check **Media > Library**.

= What do I do if I see "GD: Not Available | Imagick: Not Available"? =
Click the "How to Enable GD and Imagick" button for instructions. Summary:
- **Shared Hosting**: Enable "gd" or "imagick" in cPanel/Site Tools under PHP Extensions. Contact support if needed.
- **Local (XAMPP/WAMP/MAMP)**: Edit `php.ini` to uncomment `extension=gd` or add `extension=imagick` after installing ImageMagick.
- **VPS (Ubuntu/CentOS)**: Install `php-gd` or `php-imagick`, restart Apache.
- **Cloud (AWS, DigitalOcean)**: Install extensions or contact support.
- **Verify**: Use **Tools > Site Health > Info > Server** or create `info.php` with `<?php phpinfo(); ?>`.

= Does it support AVIF/WebP? =
Yes, if GD (PHP 8.1+ for AVIF, 7.1+ for WebP) or Imagick supports them. Check the library status on the conversion page.

= Why don’t the toggle buttons work? =
- Open Developer Tools (F12 > Console) for errors like "jQuery is not defined".
- Ensure `wp-content/plugins/image-format-converter/admin/js/imgfmt-admin.js` exists (permissions 644).
- Deactivate other plugins and switch to a default theme (e.g., Twenty Twenty-Five).
- Clear browser cache or test in incognito mode.
- Enable `WP_DEBUG` in `wp-config.php` and check `wp-content/debug.log`.
- Verify jQuery loads (F12 > Network > JS).
- In XAMPP, ensure Apache is running and file paths are correct.
- Contact support with console errors.

= Can I convert multiple images? =
Currently supports single-image conversion. Bulk conversion is planned for future updates.

== Screenshots ==

1. **Media > Image Converter** with modern conversion form, toggle buttons, and success notice.
2. **Media > Image Converter** with GD/Imagick instructions visible.

== Changelog ==

= 1.0.1 =
* Added success message "Image convert complete" after conversion.
* Added AVIF format support (requires PHP 8.1+ with GD/Imagick AVIF enabled).
* Updated library check and UI to include AVIF.
* Updated prefix to `imgfmt` for uniqueness, per WordPress.org review.
* Set Plugin URI to public GitHub repository.
* Fixed input validation for security compliance.
* Ensured compatibility with WordPress 6.8.

= 1.0.0 =
* Initial release with modern UI, collapsible settings, and GD/Imagick instructions.

== Upgrade Notice ==

= 1.0.1 =
Added AVIF support and "Image convert complete" message. Ensure AVIF is enabled in GD/Imagick (PHP 8.1+). Compatible with WordPress 6.8.
Updated to use unique `imgfmt` prefix, public GitHub URI, and improved security. Compatible with WordPress 6.8.

= 1.0.0 =
Initial release. No upgrades needed.