=== Magnet Media Optimizer - Alt Text, Captions, Descriptions & Convert to WebP ===
Contributors: pluginmagnet, devsabbirhossain
Donate link: https://pluginmagnet.com
Tags: image optimization, alt text, webp, media library, captions
Requires at least: 6.7
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate ALT text, captions & descriptions for your images, plus WebP conversion for better SEO, speed, and accessibility.

== Description ==

**Magnet Media Optimizer** is an all-in-one WordPress image optimizer that enhances your media library by automatically filling in ALT text, captions, and descriptions — while also converting images to modern formats like **WebP** for maximum performance.

Created by **Plugin Magnet**, this plugin merges the best features of “Alt Bot” and “Upload Converter WebP” into a single, powerful image-optimization toolkit.

Improve your website’s **SEO**, **accessibility**, and **page speed** — automatically.

[**💻 Demo**](https://demo.pluginmagnet.com/magnet-media-optimizer/) | [**🚀 Get The PRO Version**](https://pluginmagnet.com/wp-plugins/magnet-media-optimizer-pro/) | [**🛠 Support**](https://pluginmagnet.com/support/) | [**📄 Documentation**](https://pluginmagnet.com/docs/magnet-media-optimizer/)

### ✨ Key Features

#### 🔹 Automatic ALT Text Generation
Automatically generate meaningful ALT text using a configurable priority chain of:
- EXIF metadata embedded in the image
- File name (cleaned up automatically)
- Post/attachment title

Supports:
- Bulk generation
- Single generation
- Auto-generation on upload
- Media Library buttons
- Missing ALT finder

#### 🔹 Automatic Captions & Descriptions
Fills in an image's caption and description whenever they are left empty, using the same source chain as ALT text, for:
- Better SEO
- Improved content clarity
- Stronger accessibility compliance

Existing captions and descriptions are never overwritten.

#### 🔹 WebP Image Conversion
Automatically convert JPEG/PNG images to WebP on upload.

Includes:
- Bulk conversion tool
- Adjustable quality slider
- Option to keep or delete the original file after conversion
- Folder exclusion list

#### 🔹 Missing ALT Text Scanner
A complete admin UI showing:
- Images without ALT text
- Status indicators
- Quick one-click fixes

#### 🔹 Centralized Settings Page
Every behavior above — sources used, auto-generation toggles, WebP quality, original-file handling, excluded folders — is configurable from one Settings screen. No editing options in the database required.

#### 🔹 Performance-Focused
- Lightweight
- No frontend bloat
- Optimized for large libraries
- Compatible with all cache plugins

#### 🔹 Works Everywhere
Fully compatible with:
- Media Library (grid & list)
- Gutenberg
- Elementor
- Divi
- Bricks
- Classic Editor

---

### 🤖 AI-Powered Generation (Coming Soon)

A future release will let you connect an OpenAI or Anthropic Claude API key and choose which model generates your ALT text, captions, and descriptions — for richer, context-aware results beyond the current EXIF/filename/title chain. A preview of this option is already visible (disabled) on the plugin's Settings page.

---

### 💎 Pro Features (Planned)

- AVIF conversion support
- Batch scheduler for huge libraries
- Custom rules per folder/category
- Cloud compression

---

== Installation ==

### Minimum Requirements

* PHP 8.0 or greater
* MySQL 5.5.5 or greater, OR MariaDB 10.1 or greater
* WordPress 6.7 or greater

### Installation from WordPress Dashboard

1. Go to **Plugins → Add New**.
2. Search for **Magnet Media Optimizer – Image Alt Text, Caption & Description Generator** or upload the ZIP file.
3. Click **Install Now**, then **Activate**.
4. After activation, go to **Dashboard → Magnet Media Optimizer** to start using the plugin.

### Manual Installation

1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Select the ZIP file and click **Install Now**.
4. Click **Activate Plugin**.

### Installation via FTP

1. Unzip the plugin ZIP file.
2. Upload the plugin folder to `/wp-content/plugins/` using an FTP client.
3. Log in to your WordPress dashboard.
4. Navigate to **Plugins → Installed Plugins**.
5. Activate **Magnet Media Optimizer – Image Alt Text, Caption & Description Generator**.

---

== Frequently Asked Questions ==

= Does this plugin use AI to generate ALT text? =
Not yet. It currently uses EXIF metadata, filenames, and post titles — depending on your settings. AI-powered generation (OpenAI and Anthropic Claude) is coming in a future release; a preview of that option is already visible on the Settings page.

= Will this overwrite my existing ALT text, caption, or description? =
No. The plugin only fills in values that are empty, whether generated automatically on upload or via the bulk tools.

= Does WebP conversion replace my original images? =
No, by default originals are kept alongside their WebP copy. If you'd rather save disk space, you can enable "Delete original after conversion" on the Settings page — but this permanently deletes the original file.

= Will this slow down my site? =
Not at all. It does not load scripts on the frontend and is optimized for performance.

= Is this compatible with page builders? =
Yes — 100% compatible with Elementor, Divi, Bricks, Gutenberg, and all modern builders.

= Can I bulk optimize my old images? =
Yes. You can bulk-generate ALT text and bulk-convert images to WebP any time.

---

== Screenshots ==
1. Dashboard - Shows All Summary Stats
2. Missing ALT Manager - Shows images without ALT text
3. Convert to WebP - Converts images to WebP


== Changelog ==

= 1.0.2 =
- Added a dedicated Settings page: choose ALT/caption/description sources, WebP quality, original-file handling, and excluded folders without touching the database.
- Added automatic caption and description generation (fills in empty fields only, same source chain as ALT text).
- Added a preview of the upcoming AI-powered generation option (OpenAI / Anthropic Claude) on the Settings page.
- Changed the default for "delete original after WebP conversion" to off, so uploads are non-destructive out of the box.
- Fixed excluded-folder matching so it only matches whole folder names, not any file path containing the same digits/text.
- Fixed a capability mismatch that could deny access to the WebP Converter page for users who could see its menu item.
- Refreshed the admin UI with a consistent color and typography system across all plugin pages.
- Various internal fixes: corrected a stale version constant, added `/vendor/` to the release exclusion list.

= 1.0.1 =
- Version bump, no functional changes.

= 1.0.0 =
- Initial release.
- Alt text, captions, and descriptions.
- WebP conversion with bulk tool.
- Missing ALT manager.
- Media Library integration.
- Performance optimizations.


== Upgrade Notice ==

= 1.0.2 =
The default for deleting original images after WebP conversion has changed to off (non-destructive). If you were relying on originals being deleted automatically, enable "Delete original after conversion" on the new Settings page.

