Advanced AI SEO for WooCommerce - Documentation

Advanced AI SEO for WooCommerce

Version: 2.0 | Author: Creative Side | Last Updated: March 2025

Table of Contents

1. Introduction

Advanced AI SEO for WooCommerce is a powerful WordPress plugin that leverages artificial intelligence to optimize your online store's SEO automatically. This plugin helps you boost your online visibility, improve product rankings, and increase organic traffic with minimal effort.

Our plugin uses advanced AI models to generate and optimize:

  • Product titles, descriptions, and meta tags
  • Category descriptions and metadata
  • Image ALT tags and descriptions
  • Complete blog articles with proper SEO structure

Note: This plugin requires an OpenAI API key to function. You can obtain an API key at https://openai.com/api/. GPT-4 is recommended for best results.

2. Installation

System Requirements

  • WordPress 5.0 or higher
  • WooCommerce 5.0 or higher
  • PHP 7.2 or higher
  • OpenAI API key (GPT-4 recommended)

Installation Steps

  1. Download the plugin ZIP file from your CodeCanyon downloads area.
  2. Log in to your WordPress admin panel.
  3. Go to Plugins → Add New → Upload Plugin.
  4. Choose the ZIP file you downloaded and click "Install Now".
  5. After installation is complete, click "Activate Plugin".
  6. You should now see "AI SEO" in your WordPress admin menu.

Warning: Before activating the plugin on your live site, we recommend testing it on a staging environment first to ensure compatibility with your theme and other plugins.

3. Configuration

3.1 API Setup

To use Advanced AI SEO, you'll need to connect it with your OpenAI API key:

  1. Go to AI SEO → Settings in your WordPress admin menu.
  2. Click on the "API Settings" tab.
  3. Enter your OpenAI API key in the designated field.
  4. Select your preferred AI model (GPT-4 recommended for best results).
  5. Click "Save Changes".

The plugin will test your API connection automatically. If successful, you'll see a green checkmark indicating that the API is properly configured.

3.2 General Settings

Configure the general behavior of the plugin:

  1. Go to AI SEO → Settings → General.
  2. Language: Choose your preferred language for content generation.
  3. Cost per hour: Set your hourly rate for ROI calculations.
  4. Time per task: Estimate the time saved per optimization task.
  5. Click "Save Changes".

3.3 Optimization Settings

Customize how the AI optimizes different content types:

  1. Go to AI SEO → Settings → Content Optimization.
  2. For each content type (Products, Categories, Images, Blog), you can customize:
    • Default AI prompts used for generation
    • Content tone (conversational, formal, friendly, etc.)
    • Character limits and formatting options
  3. Click "Save Changes" after making your selections.

4. Features & Usage

4.1 Bulk Products Optimization

Optimize multiple product titles, descriptions, and meta tags at once:

  1. Go to AI SEO → Bulk Products in your WordPress admin menu.
  2. You'll see a list of your WooCommerce products with their optimization status.
  3. Select the products you want to optimize, or use the "Select All Non-Optimized" button.
  4. Click the "Generate Bulk" button to start the optimization process.
  5. The plugin will process each product, generating optimized titles, descriptions, and meta tags.
  6. Review the generated content and click "Apply All" to save the changes, or edit individual items before applying.

Note: Bulk optimization can take some time depending on the number of products and your API plan limits. The plugin processes items in batches to prevent API timeouts.

4.2 Category Optimization

Create SEO-friendly category descriptions:

  1. Go to AI SEO → Categories in your WordPress admin menu.
  2. You'll see a list of your WooCommerce categories with their optimization status.
  3. Click the "Optimize" button next to any category to generate SEO-friendly content.
  4. The plugin will analyze the category and generate an optimized description.
  5. Review the generated content and click "Apply" to save the changes, or edit it before applying.

4.3 Image Optimization

Generate ALT tags and descriptions for product images:

  1. Go to AI SEO → Images in your WordPress admin menu.
  2. You'll see a list of your media library images with their optimization status.
  3. Select the images you want to optimize, or use the "Select All Non-Optimized" button.
  4. Click the "Generate Bulk" button to start the optimization process.
  5. The plugin will analyze each image and generate ALT text and descriptions.
  6. Review the generated content and click "Apply All" to save the changes, or edit individual items before applying.

Note: The AI will attempt to analyze the visual content of images through their context in your products, but may not always accurately describe what's in the image itself.

4.4 Blog Post Generator

Create fully optimized blog content:

  1. Go to AI SEO → Blog Generator in your WordPress admin menu.
  2. Enter your article topic in the "Article Topic" field.
  3. Add context, keywords, and choose the desired tone and length.
  4. Click the "Generate Article" button.
  5. The plugin will create a complete, SEO-optimized blog post with proper headings, paragraphs, and formatting.
  6. Review the generated content and click "Publish as Draft" to create a new draft post, or "Copy Content" to use it elsewhere.

5. Dashboard & Analytics

The plugin dashboard provides an overview of your SEO optimization efforts:

  1. Go to AI SEO → Dashboard in your WordPress admin menu.
  2. Here you'll find:
    • API status and usage statistics
    • Optimization progress for products, categories, images, and blog posts
    • Estimated time and cost savings
    • Recent optimization activities
    • Quick action buttons for common tasks

The dashboard is updated in real-time as you optimize your content, providing valuable insights into your SEO progress.

6. Troubleshooting

Common Issues and Solutions

API Connection Errors

  • Issue: "Invalid API key" or "API connection failed" error.
  • Solution: Verify your API key is correctly entered without extra spaces. Ensure your OpenAI account has sufficient credits.

Content Generation Failures

  • Issue: AI generates irrelevant or poor-quality content.
  • Solution: Try adjusting the AI prompts in Settings → Content Optimization. Provide more context in the product descriptions or category names.

Performance Issues

  • Issue: Bulk optimization is very slow.
  • Solution: Reduce the batch size in Settings → General. Consider upgrading your OpenAI API plan for higher rate limits.

Plugin Conflicts

  • Issue: Plugin functionality interferes with other SEO plugins.
  • Solution: While the plugin is designed to work alongside other SEO tools, try temporarily disabling other SEO plugins to identify conflicts.

Debug Logs

For advanced troubleshooting, you can enable debug logs:

  1. Go to AI SEO → Settings → Advanced.
  2. Toggle "Enable Debug Mode" to ON.
  3. Perform the action that's causing issues.
  4. Go to AI SEO → Logs to view the debug information.

Note: When contacting support, please include these logs to help us diagnose your issue more effectively.

7. Frequently Asked Questions

General Questions

Do I need technical knowledge to use this plugin?

No, the plugin is designed to be user-friendly. Just install, configure your API key, and start optimizing. The interface is intuitive and doesn't require coding knowledge.

How does the AI generate content?

The plugin uses OpenAI's language models to analyze your products and generate SEO-optimized content based on your data, industry standards, and search engine best practices.

Is there a limit to how many items I can optimize?

The plugin itself has no limits, but optimization is subject to your OpenAI API plan limits. We recommend starting with your most important products first.

Technical Questions

Can I edit the AI-generated content?

Yes, all content generated by the plugin can be edited before being applied to your store. The plugin provides a preview and edit option for all generated content.

Is this compatible with other SEO plugins?

Yes, Advanced AI SEO works alongside popular SEO plugins like Yoast SEO, Rank Math, and All-in-One SEO. It enhances their functionality by providing AI-generated content.

Will this plugin slow down my website?

No, the AI processing happens on OpenAI's servers, not on your website. Once content is generated and applied, it becomes regular text content that doesn't affect site performance.

Billing Questions

Does the plugin include OpenAI API credits?

No, you need to obtain your own OpenAI API key and handle the billing directly with OpenAI. The plugin itself doesn't charge any additional fees beyond your initial purchase.

How much will I spend on the OpenAI API?

API costs depend on how many items you optimize and the AI model you choose. GPT-4 offers better results but is more expensive than older models. A typical product optimization might cost a few cents in API fees.

8. Changelog

Version 2.0 (Current)

  • Added Blog Post Generator feature
  • Improved dashboard with savings calculator
  • Added support for GPT-4 model
  • Enhanced image optimization capabilities
  • Added activity tracking for all optimizations
  • Improved bulk processing with batch support
  • Added customizable AI prompts for all content types

Version 1.5

  • Added category optimization feature
  • Improved API connection reliability
  • Added support for multi-language stores
  • Enhanced product analysis for better content generation
  • Various bug fixes and performance improvements

Version 1.0

  • Initial release
  • Product title and description optimization
  • Basic image ALT tag generation
  • Simple dashboard with statistics

9. Credits & Resources

Third-Party Libraries

  • Chart.js - Used for dashboard charts and graphs
  • Select2 - Enhanced dropdowns for product selection

Icons

All icons used in the plugin are from WordPress Dashicons or created specifically for this plugin.

10. Support

Getting Help

If you need assistance with the plugin, there are several ways to get help:

  1. Documentation: First, please read through this documentation thoroughly.
  2. Email Support: You can reach us at office@creative-side.ro.

Support Policy

Our support includes:

  • Installation assistance
  • Bug fixes and troubleshooting
  • Guidance on using features
  • Compatibility issues with WordPress and WooCommerce

Support does not include:

  • Customizations or modifications beyond the plugin's intended functionality
  • Server or hosting issues not directly related to the plugin
  • Issues with third-party themes or plugins not caused by our plugin

Support Hours

Our support team is available Monday to Friday, 9 AM to 5 PM EST. We typically respond to all inquiries within 24-48 business hours.

© 2025 Advanced AI SEO for WooCommerce. All Rights Reserved.

This documentation is protected by intellectual property laws and may not be copied, modified, or distributed without permission.