=== Simpli Auto Alt Text ===
Contributors: simpli
Tags: alt text, accessibility, seo, images, media
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generates accessible alt text from image filenames when media is uploaded to WordPress.

== Description ==

Simpli Auto Alt Text improves SEO and accessibility by converting messy uploaded filenames into readable alt text during the standard WordPress media ingestion workflow.

When an image is uploaded, the plugin hooks into `wp_generate_attachment_metadata` and:

* Reads the attachment using its media ID
* Extracts the core filename (without extension)
* Strips hyphens, dots, and underscores
* Applies title-case normalization with `ucwords()`
* Saves the result to the `_wp_attachment_image_alt` post meta field

**Example**

`summer-beach_vacation.2024.jpg` becomes `Summer Beach Vacation 2024`

The plugin only sets alt text when none already exists, so manually entered alt text is never overwritten.

== Installation ==

1. Upload the `simpli-auto-alt-text` folder to the `/wp-content/plugins/` directory, or install through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Upload an image — alt text is generated automatically from the filename.

== Frequently Asked Questions ==

= Does this overwrite existing alt text? =

No. Alt text is only generated when the `_wp_attachment_image_alt` field is empty.

= Does this work for non-image attachments? =

No. The plugin only processes image attachments.

= Does this run on existing media library items? =

No. Alt text is set during the upload metadata generation process only.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
