=== Filestack AI Image Alt Text Generator for WP ===
Contributors: ankurfstack
Tags: accessibility, seo, ALT Text, image optimization, alt tag, media library, bulk alt text, AI, Alternative Text, AI Image Optimization, Filestack
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate alt text for images using the Filestack API to improve accessibility and SEO.

== Description ==

Filestack Alt Text Generator creates descriptive alt text for your WordPress images using the Filestack Caption API. Improve your site's accessibility and SEO with AI-generated image descriptions, individually or in bulk.

Learn more: [Generate Alt Text for Every Image in One Click](https://blog.filestack.com/generate-alt-text-for-every-image-in-one-click-stop-writing-it-manually/).

= Features =

* **Bulk Processing**: Generate alt text for all images at once with a single click
* **Smart Detection**: Processes only images missing alt text. Your manual entries stay intact.
* **Real-time Progress**: Live progress bar shows exactly how many images have been processed
* **Media Library Integration**:
  * Alt text status column showing which images need attention
  * Bulk action to generate alt text for selected images
  * Generate button on individual image edit screens
* **Pause & Resume**: Ability to pause processing and resume later
* **Error Handling**: Logs errors automatically and continues processing. Get a full summary of processed, skipped, and error counts when complete.
* **Secure API Storage**: Safely stores your Filestack credentials using WordPress options API, with masked API key field
* **Test Connection**: Verify your API credentials before processing
* **WordPress.com CDN Proxy**: Optional setting to proxy image URLs through the WordPress.com CDN (i0.wp.com) for sites where images are not directly accessible by the Filestack API

= How It Works =

1. Install and activate the plugin
2. Configure your Filestack API credentials in Settings > Filestack Alt Text
3. Test your API connection to ensure everything works
4. Navigate to Media > Generate Alt Text to process images in bulk
5. Or use the bulk actions in the Media Library to process specific images

= Requirements =

* WordPress 5.8 or higher
* PHP 7.4 or higher
* Filestack API account with API Key, Policy, and Signature

== Installation ==

1. Upload the `filestack-alt-text-generator` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > Filestack Alt Text to configure your API credentials
4. Start generating alt text from Media > Generate Alt Text

== Frequently Asked Questions ==

= Where do I get my Filestack API credentials? =

You need to sign up for a Filestack account at https://www.filestack.com/signup-start/. Once you have an account, login to the Filestack DevPortal at https://dev.filestack.com/ to get your API Key and generate your Policy and Signature keys.

= Will this overwrite my existing alt text? =

The plugin only generates alt text for images missing descriptions. Existing alt text is always preserved.

= Can I pause the bulk processing? =

Yes! You can pause the processing at any time and resume it later. Your progress is maintained.

= How many images can I process at once? =

The plugin processes images in batches of 5 to avoid server timeouts. You can process as many images as you need - the plugin will handle them automatically in batches.

= What happens if the API fails? =

The plugin logs any errors and continues processing the next image automatically. When complete, you get a full summary of processed, skipped, and error counts.

== Screenshots ==

1. Settings page for configuring Filestack API credentials
2. Bulk processing page with real-time progress
3. Media Library integration showing alt text status
4. Individual image edit screen with generate button

== Changelog ==

= 1.0.3 =
* Renamed plugin to "Filestack AI Image Alt Text Generator for WP" for better discoverability
* Updated tags in readme for improved WordPress.org search visibility
* Added link to Filestack blog post on generating alt text in the plugin description

= 1.0.2 =
* Improved plugin description and feature descriptions for clarity
* Updated FAQ answers for conciseness
* Updated Filestack signup URL

= 1.0.1 =
* Added "What's Next?" guidance section on the Settings page with links to bulk processing, media library bulk actions, and single image generation

= 1.0.0 =
* Initial release
* Bulk alt text generation
* Media Library integration with status column and bulk actions
* Real-time progress tracking with pause/resume
* Test API connection feature
* Filestack branding and DevPortal link on admin pages
* API Key field masked with show/hide toggle
* Link to Filestack security policies documentation
* WordPress.com Image CDN Proxy option for restricted image access
* API credentials validation with user-friendly error messages

== Upgrade Notice ==

= 1.0.0 =
Initial release of the Filestack Alt Text Generator.

== External services ==

This plugin relies on the [Filestack](https://www.filestack.com/) Caption API to generate alt text for images.

= What data is sent and when =

* When you generate alt text (individually, in bulk, or via the "Test Connection" button), the plugin sends the public URL of each image to the Filestack Caption API.
* The API endpoint used is `https://cdn.filestackcontent.com`. Your configured API Key, Policy, and Signature are included in the request URL for authentication.
* No other user data or site data is transmitted.

= Service links =

* Filestack website: https://www.filestack.com/
* Terms of service: https://www.filestack.com/terms/
* Privacy policy: https://www.filestack.com/privacy/

== Support ==

For support, please visit the plugin's support forum on WordPress.org or contact your plugin developer.
