=== NA Image ALT Helper ===
Contributors: najir29
Requires at least: 6.0
Tested up to: 6.8
Stable tag: trunk
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight plugin to automatically generate alternative text (ALT text) for images during upload and in bulk.


== Description ==

**100% Free Auto ALT Text Generator** is a powerful image accessibility and SEO optimization plugin for WordPress.

It automatically generates clean, context-aware ALT text for:

- Media Library images  
- WooCommerce product images  
- Attached & unattached images  
- Bulk existing images  
- Newly uploaded images  

This plugin improves both **SEO** and **Accessibility (WCAG)** by ensuring every image gets meaningful ALT text without any manual work.

### 🔥 Key Highlights

- 100% Free — No API, No Tokens, No Hidden Limitations  
- Auto ALT text on upload  
- Bulk ALT generation for all existing images  
- Supports WooCommerce products  
- Uses post title, product category, keywords, SEO fields, and smart tokens  
- Optional overwrite mode  
- Detects SEO focus keyword from Yoast or Rank Math  
- Auto keyword extraction from post content  
- Clean & simple UI  
- Super lightweight — No external API calls  
- No performance impact  

### 🧠 Smart Tokens You Can Use

You can customize your ALT template using tokens like:

`{title}`, `{filename}`, `{parent}`, `{parent_title}`, `{parent_category}`, `{parent_tags}`, `{product_cat}`, `{product_sku}`, `{seo_focus}`, `{auto_keywords}`, `{site}`, `{keywords}`

These tokens are automatically replaced with real post/product/context data.

### 🚀 Why This Plugin?

Most “ALT Generator” plugins are either:

❌ Paid  
❌ API-based  
❌ Limited  
❌ Slow  

This one is **fast, free, local**, and **privacy-friendly**.  
Perfect for WooCommerce shops, portfolios, blogs — basically any site with images.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin from **Plugins → Installed Plugins**.
3. Go to **Media → Auto ALT Text**.
4. Configure your template, keywords, and settings.
5. Click **Generate for All** to bulk-generate missing ALT text.

== Frequently Asked Questions ==

= Does this plugin use an external API? =  
No. 100% local processing. No API calls. No costs.

= Will it slow down my website? =  
No. It only runs during ALT generation. Nothing runs on the front-end.

= Does it work with WooCommerce? =  
Yes! Fully compatible.

= Does it support Yoast or Rank Math keywords? =  
Yes. If enabled, the SEO focus keyword is used in ALT text.

= Can I overwrite existing ALT text? =  
Yes — there is an option for that.

= Does it generate ALT text automatically on upload? =  
Yes.

== Screenshots ==

1. Plugin settings screen  
2. Bulk ALT generator tools  
3. Token list and template editor  
4. WooCommerce compatibility  

== Changelog ==

= 1.0.0 =
* Initial release  
* Auto ALT generation  
* WooCommerce support  
* Bulk tools  
* SEO keyword extraction  
* New upload auto ALT  
* Improved UI  
* Smart token system  

== Upgrade Notice ==

= 1.0.0 =
First stable release. Fully optimized and recommended for all users.
