=== Bulk Alt-Text from Filename ===
Contributors: snehalpancholi
Tags: alt text, accessibility, bulk, media, images
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Populate empty image alt text from the cleaned filename in bulk, with a before/after preview and selective apply.

== Description ==

Bulk Alt-Text from Filename scans your media library for images missing alt text, derives a human-readable suggestion from each filename, and lets you review and selectively apply the suggestions without writing a single SQL query.

**Features:**

* Lists all images with an empty `_wp_attachment_image_alt` field
* Generates a suggestion by: stripping the extension, removing WordPress size suffixes (-300x200, -scaled), replacing hyphens/underscores with spaces, and applying Title Case
* Editable suggestion field — change the text before applying
* Select/deselect individual images or use Select All
* Saves via AJAX — no page reload required
* Paginated results (50 per page)
* Thumbnail preview for visual confirmation
* Saved indicator per row after applying
* Located at **Media → Bulk Alt-Text**
* Automatic updates from AddonLogic update server

== Installation ==

1. Upload the `bulk-alt-text-filename` folder to `/wp-content/plugins/`
2. Activate the plugin through the **Plugins** menu
3. Go to **Media → Bulk Alt-Text**

== Frequently Asked Questions ==

= Will this overwrite existing alt text? =
No. Only images where the alt text is empty or not set are shown on this page.

= Can I edit the suggested alt text before saving? =
Yes. Each row has an editable input field pre-filled with the suggestion. Modify it before clicking Apply Selected.

= How is the alt text generated from the filename? =
1. Remove the file extension
2. Remove WordPress size suffixes (`-300x200`, `-scaled`, `-rotated`)
3. Replace `-`, `_`, `.`, and `+` with spaces
4. Collapse multiple spaces
5. Apply Title Case

Example: `my-product-photo-1200x800.jpg` → `My Product Photo`

= Will deactivating the plugin remove the alt text I set? =
No. Alt text is stored as standard WordPress post meta (`_wp_attachment_image_alt`) and persists after deactivation.

== Changelog ==

= 1.0.0 =
* Initial release.

== Screenshots ==

1. Bulk Alt-Text screen showing image previews, filenames, and editable suggestions.
2. After applying — green "Saved" indicator on each updated row.
