=== Simpli Auto Alt Text ===
Contributors: simpliplugin
Tags: alt text, accessibility, seo, images, media
Requires at least: 5.8
Tested up to: 7.1
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 is a lightweight WordPress plugin that automatically generates image alt text from filenames when images are uploaded to your website.

Adding meaningful alternative text to images is an important part of making website content more accessible. However, manually entering alt text for every uploaded image can be time-consuming.

Simpli Auto Alt Text helps simplify this process by converting image filenames into readable text and automatically saving the result in the WordPress Media Library.

The plugin works during the standard WordPress image upload process, requires no additional configuration, and preserves existing non-empty alt text.

= Key Features =

* **Automatic Alt Text Generation:** Generate alt text from image filenames during the WordPress media upload process.
* **Filename Formatting:** Convert hyphens, underscores, and periods into spaces to make filenames easier to read.
* **Readable Capitalization:** Automatically format generated text using title-case capitalization.
* **Preserves Existing Alt Text:** Existing non-empty image alt text is never overwritten.
* **Image-Only Processing:** Only image attachments are processed. Other media files are ignored.
* **No Configuration Required:** Activate the plugin and start uploading images without configuring additional settings.
* **Lightweight Functionality:** Uses built-in WordPress functions and hooks without requiring external APIs.
* **No Bulk Modifications:** Previously uploaded images remain unchanged.

= How Simpli Auto Alt Text Works =

When you upload an image, WordPress generates attachment metadata. Simpli Auto Alt Text uses this process to generate readable alt text from the uploaded filename.

The plugin:

1. Detects when WordPress generates image attachment metadata.
2. Checks whether the attachment is an image.
3. Checks whether the image already contains non-empty alt text.
4. Extracts the image filename without its extension.
5. Replaces hyphens, underscores, and periods with spaces.
6. Normalizes spacing and capitalizes the resulting words.
7. Saves the generated text in the standard WordPress image alt text field.

= Example Filename Conversions =

* `summer-beach_vacation.2024.jpg` becomes `Summer Beach Vacation 2024`
* `beautiful-mountain-view.png` becomes `Beautiful Mountain View`
* `red_sports_car.jpg` becomes `Red Sports Car`
* `my--photo___best.png` becomes `My Photo Best`

= Who Can Use This Plugin? =

Simpli Auto Alt Text can be useful for:

* Bloggers who regularly upload images to their articles.
* Website owners who want a simple starting point for image alt text.
* Content creators who manage image-heavy websites.
* WordPress developers who want automatic filename-based alt text generation.
* Site administrators who want to reduce repetitive manual image metadata entry.

= Works With the WordPress Media Library =

The plugin uses the standard WordPress attachment metadata workflow and stores generated alt text in the `_wp_attachment_image_alt` field.

Generated alt text can be viewed and manually edited through the WordPress Media Library.

The plugin does not modify image files, change attachment titles or captions, or process previously uploaded images.

= Important Accessibility Note =

Alt text generated from filenames is only a starting point. A filename does not always accurately describe an image or its purpose.

For better accessibility, review the generated text and adjust it to describe the image in its actual context. Decorative images may require intentionally empty alt text.

= Simple and Lightweight =

Simpli Auto Alt Text focuses on one task: automatically filling missing image alt text from filenames when new images are uploaded.

No external AI services, API keys, additional accounts, or complex configuration are required. 

== 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.
