# AI Image Alt Text Generator – User Documentation
## Table of Contents
1. [Introduction](#introduction)
2. [Installation](#installation)
3. [Getting Started](#getting-started)
4. [Dashboard Overview](#dashboard-overview)
5. [Bulk Alt Text Optimization](#bulk-alt-text-optimization)
6. [Settings Configuration](#settings-configuration)
7. [WooCommerce Integration](#woocommerce-integration)
8. [Troubleshooting](#troubleshooting)
9. [Frequently Asked Questions](#frequently-asked-questions)
10. [Support](#support)
## Introduction
AI Image Alt Text Generator enhances your WordPress website’s accessibility and SEO by automatically generating descriptive alternative text for your images using advanced artificial intelligence. This plugin helps you:
– Improve your website’s accessibility for visually impaired users
– Boost your SEO rankings with keyword-rich, contextually relevant alt text
– Save time by automating a tedious manual process
– Ensure compliance with web accessibility standards (WCAG)
## Installation
### System Requirements
– WordPress 5.0 or higher
– PHP 7.4 or higher
– Active internet connection (for API communication)
### Installation Steps
1. **Via WordPress Admin Panel (Recommended)**:
– Go to Plugins > Add New in your WordPress admin panel
– Search for “AI Image Alt Text Generator”
– Click “Install Now” and then “Activate”
2. **Manual Installation**:
– Download the plugin ZIP file from WordPress.org
– Go to Plugins > Add New > Upload Plugin
– Choose the downloaded ZIP file and click “Install Now”
– After installation, click “Activate Plugin”
## Getting Started
### API Key Configuration
Before you can generate alt text, you’ll need to configure your API key:
1. After activation, you’ll see a notice prompting you to configure your API key
2. Navigate to AI Image Alt Text Generator > Settings in your WordPress admin menu
3. Enter your API key in the “API Key” field
4. Click “Save Changes”
If you don’t have an API key yet:
1. Visit [alttext.axilweb.com](https://alttext.axilweb.com) to create an account
2. Follow the instructions to obtain your API key
3. Copy the key and paste it into your plugin settings
## Dashboard Overview
The Dashboard provides a comprehensive overview of your website’s alt text status:
– **Total Images**: The total number of images on your website
– **Images With Alt Text**: The number of images that already have alt text
– **Images Missing Alt Text**: The number of images without alt text
– **Alt Text Coverage**: The percentage of images with alt text
### Priority Actions
The dashboard highlights areas that need immediate attention:
– **Content Images**: Regular images within your posts and pages
– **Product Images**: Images associated with your WooCommerce products (if applicable)
Each section offers a quick action button to generate alt text for the corresponding images.
## Bulk Alt Text Optimization
The Bulk Optimization page allows you to generate alt text for multiple images at once:
1. Navigate to AI Image Alt Text Generator > Bulk Optimization
2. You’ll see a list of all images missing alt text
3. Select the images you want to process
4. Click “Generate Alt Text” to start the process
5. View the generated alt text and make any manual adjustments if needed
6. Click “Save All Changes” to update your images
### Filtering Options
– Filter by image type (post, page, or product)
– Sort by date, size, or filename
– Search for specific images
## Settings Configuration
### API Settings
– **API Key**: Your authentication key for accessing the alt text generation service
– **API Connection Status**: Indicates whether your connection is active
### Integration Settings
– **Auto Generate Alt Text**: Enable/disable automatic alt text generation for newly uploaded images
– **Apply to Products**: Enable/disable alt text generation for WooCommerce product images
## WooCommerce Integration
AI Image Alt Text Generator seamlessly integrates with WooCommerce to optimize product images:
– Automatically generates alt text for product featured images and galleries
– Includes product-specific context in the generated descriptions
– Supports bulk optimization for all product images
**Note**: WooCommerce must be installed and activated for product image optimization features to be available.
## Troubleshooting
### Common Issues
**API Connection Errors**
– Ensure your API key is entered correctly
– Check your internet connection
– Verify your web server can make outbound connections
**Alt Text Not Generating**
– Check if you’ve reached your API usage limit
– Ensure the image formats are supported (JPG, PNG, WebP)
– Check server PHP memory limits if processing many images
**WooCommerce Products Not Showing**
– Verify that WooCommerce is activated
– Ensure you have proper permissions to edit products
### Debug Logging
If you’re experiencing issues, you can enable debug logging:
1. Add the following code to your wp-config.php file:
“`php
define(‘ATG_DEBUG_MODE’, true);
“`
2. Check the debug log at wp-content/alt-text-generator.log
## Frequently Asked Questions
**Q: How accurate is the generated alt text?**
A: The AI model provides highly accurate and contextually relevant descriptions for most images. However, we recommend reviewing the generated text for mission-critical images.
**Q: Will this slow down my website?**
A: No. The alt text generation happens asynchronously in the background and does not affect your website’s loading speed.
**Q: Are there usage limits?**
A: The free version includes a limited number of alt text generations per month. Premium plans offer higher or unlimited usage tiers.
**Q: Can I edit the generated alt text?**
A: Yes. You can manually edit any generated alt text through the WordPress media library or the plugin’s Bulk Optimization interface.
**Q: Does it work with page builders like Elementor or Divi?**
A: Yes. The plugin works with all major page builders and any plugin that uses WordPress’s standard media handling.
## Support
If you need assistance with the AI Image Alt Text Generator:
– Email us at support@axilweb.com
—
Thank you for choosing AI Image Alt Text Generator to improve your website’s accessibility and SEO performance!
Support Us - Your Contribution Matters
At Axilweb, we are dedicated to creating high-quality products and services that help businesses and individuals achieve their goals. We’re proud of the work we do, and we need your help to continue innovating and delivering top-notch solutions.
Your donation will go a long way in supporting our ongoing projects and helping us build better, more robust software solutions for everyone.
Why Donate?
By supporting us, you enable us to:
-
- Develop More Features: With your help, we can improve and add new features to our existing products.
-
- Provide Support and Updates: Donations help fund continuous support and regular updates, ensuring our tools stay up-to-date and secure.
-
- Expand Our Reach: Your generosity will allow us to reach more users, spread our solutions, and make a greater impact.
How Your Contribution Helps
Whether you contribute a small or large amount, every donation makes a difference. Here’s how your donation will be used:
-
- Research and Development: To create new software tools and improve existing ones.
-
- Customer Support: To provide quicker and more efficient support to all users.
-
- Operational Costs: Cover server costs, hosting, and other necessary resources.
Ways to Donate
We offer multiple donation methods for your convenience:
-
- PayPal: You can donate securely using PayPal.
-
- Credit/Debit Card: Direct card payments are accepted through our payment gateway.
-
- Bank Transfer: For larger donations or corporate contributions, please reach out to us.
Thank You for Your Support!
Every donation, no matter the size, means the world to us. We sincerely appreciate your support and promise to continue working hard to deliver the best products and services.
