# GistMag Alt Text Generator - WordPress Plugin

AI-powered alt text generation for WordPress media library.

## Installation

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings > GistMag ATG to configure your API key

## Features

- Auto-generate alt text on image upload
- Manual alt text generation for existing images
- Bulk alt text generation for media library
- Support for short, long, and SEO-optimized alt text modes
- Usage statistics display
- WooCommerce product image support

## Configuration

1. Get your API key from the [GistMag dashboard](https://gistmag.co.uk/dashboard/api-key)
2. Enter the API key in Settings > GistMag ATG
3. Configure auto-generation and default mode settings
4. Verify your API key to ensure it's working

## Usage

### Auto-generation
Enable "Auto-generate on Upload" in settings to automatically generate alt text when images are uploaded.

### Manual Generation
1. Go to Media Library
2. Click on an image
3. Click "Generate Alt Text" button in the sidebar

### Bulk Generation
1. Go to Media Library
2. Select multiple images
3. Choose "Generate Alt Text" from bulk actions
4. Select mode and click Apply

## Requirements

- WordPress 5.0 or higher
- PHP 7.4 or higher
- Valid GistMag API key

## API Endpoints

The plugin uses the GistMag public API endpoints:
- `POST /generate-public` - Generate alt text
- `POST /usage-public` - Get usage statistics
- `POST /verify-key-public` - Verify API key

All requests include `source: 'wordpress'` for tracking purposes.

## Support

For support, visit [GistMag.co.uk](https://gistmag.co.uk) or check the [documentation](https://gistmag.co.uk/dashboard/api-docs).