=== Adbear Alt Text Generator ===
Contributors: secilkars
Tags: image seo, alt text, image title, media library, woocommerce seo
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find missing image alt text and titles, generate smart SEO suggestions, and optimize your WordPress media library from one dashboard.

== Description ==

**Adbear Alt Text Generator** helps you audit and fix image metadata across your WordPress site. It scans your media library, finds images that are missing alt text or titles, and suggests readable values based on each file name. You review every suggestion before applying it—nothing is changed automatically without your approval.

This plugin is built for site owners, SEO specialists, and store managers who need a practical workflow to improve image accessibility and search visibility without editing attachments one by one in the Media Library.

= Key features =

* **Media library scan** — Batch-scans all image attachments and lists only those missing alt text, a title, or both.
* **Smart suggestions** — Converts file names (for example `blue-running-shoes.jpg`) into human-readable alt text and title suggestions.
* **Review before apply** — Edit suggestions inline and apply changes per image with a single click.
* **Usage context** — Shows where each image is used, including posts, pages, Elementor content, ACF fields, and WooCommerce products.
* **WooCommerce optimization** — One-click bulk update for product featured and gallery images using the product name when metadata is missing.
* **CSV export** — Download scan results for reporting or offline review.
* **Media Library column** — See at a glance which images still need SEO metadata directly in **Media → Library**.

= Who is this for? =

* Blogs and business sites with large media libraries and incomplete image metadata.
* WooCommerce stores that need consistent alt text on product images.
* Teams using Elementor or Advanced Custom Fields who want to see which uploaded images are referenced in page builder or custom field content.

= How it works =

1. Install and activate the plugin.
2. Open **Alt Text Generator** in the WordPress admin sidebar.
3. Click **Start Scan** to analyze your media library in batches (safe for large libraries).
4. Review the results table: current values, suggested alt/title, and where each image is used.
5. Edit suggestions if needed, then click **Apply** on each row to save changes.
6. Optionally export results as CSV or use **Optimize WooCommerce Images** if WooCommerce is active.

The plugin does not call external APIs and does not use AI services. Suggestions are generated locally from file names and, for WooCommerce images, from product titles.

= Permissions =

Users who can upload files (`upload_files` capability) can access the plugin settings and apply changes.

== Installation ==

= Automatic installation =

1. In your WordPress admin, go to **Plugins → Add New**.
2. Search for **Adbear Alt Text Generator**.
3. Click **Install Now**, then **Activate**.

= Manual installation =

1. Upload the `adbear-alt-text-generator` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Alt Text Generator** in the admin menu to run your first scan.

No additional configuration or API keys are required.

== Frequently Asked Questions ==

= Does this plugin change images automatically? =

No. The scan only reports missing metadata and shows suggestions. You choose what to apply, row by row. The WooCommerce optimizer only fills empty alt text and titles using the product name—it does not overwrite existing values.

= Do I need an API key or external service? =

No. All scanning and suggestion logic runs on your server.

= Will this work with large media libraries? =

Yes. The scan runs in batches of 50 images at a time so it stays responsive on sites with thousands of attachments.

= Does it support WooCommerce? =

Yes. When WooCommerce is active, the plugin detects product images, shows WooCommerce usage in scan results, and provides an **Optimize WooCommerce Images** action for bulk fixes.

= Does it detect Elementor or ACF usage? =

Yes. During a scan, the plugin checks whether images appear in Elementor post meta or ACF field data and includes that context in the **Used In** column.

= What user role can use this plugin? =

Any user with the `upload_files` capability (typically Authors and above, depending on your site configuration).

== Screenshots ==

1. Dashboard with scan statistics and missing image results.
2. Per-image suggestions with apply controls and usage context.
3. Alt Text Status column in the Media Library.

== Changelog ==

= 0.3.0 =
* Added Turkish (tr_TR) translation.
* Expanded plugin readme with installation, usage, and FAQ sections.
* Improved i18n coverage for usage labels and CSV export headers.
* Removed redundant load_plugin_textdomain() call for WordPress.org compatibility.

= 0.2.0 =
* Added WooCommerce product image optimization.
* Added Elementor and ACF usage detection in scan results.
* Added CSV export and Media Library status column.
* Improved batch scanning for large media libraries.

= 0.1.0 =
* Initial release with media library scan and filename-based suggestions.

== Upgrade Notice ==

= 0.3.0 =
Adds Turkish language support and improves documentation and translations.

= 0.2.0 =
Adds WooCommerce bulk optimization, usage detection for Elementor and ACF, CSV export, and a Media Library status column.
