Troubleshooting Guide

This comprehensive guide helps you diagnose and resolve common issues with AI Product Tools. Follow the systematic approach to quickly identify and fix problems.

Quick Diagnostic Checklist

Before diving into specific troubleshooting, run through this quick checklist:

Most Frequent Issues

Installation Problems

Plugin Won't Activate

Symptoms

• Error message during activation
• Plugin appears inactive after activation attempt
• WordPress admin becomes inaccessible

Possible Causes

Solutions

Check PHP Version:

1. Go to Tools → Site Health → Info
2. Look for PHP version under Server section
3. Contact hosting provider if PHP < 7.4

Increase Memory Limit:

// Add to wp-config.php
ini_set('memory_limit', '256M');

Resolve Plugin Conflicts:

1. Deactivate all other plugins
2. Try activating AI Product Tools
3. If successful, reactivate other plugins one by one
4. Identify conflicting plugin

Fix File Permissions:

• Folders: 755 or 750
• Files: 644 or 640
• Contact hosting provider for assistance

WooCommerce Not Detected

Symptoms

• Warning message about WooCommerce requirement
• Plugin features not available
• Missing product integration

Solutions

Setup Wizard Issues

Symptoms

• Setup wizard doesn't appear
• Wizard gets stuck on a step
• Cannot complete initial configuration

Solutions

1. Clear Browser Cache: Hard refresh (Ctrl+F5)
2. Disable Browser Extensions: Try in incognito mode
3. Check JavaScript: Look for console errors
4. Manual Setup: Skip wizard and configure manually in settings

API Connection Issues

Invalid API Key Errors

Symptoms

• "Invalid API key" error messages
• Connection test failures
• Generation requests fail immediately

OpenAI API Key Issues

Solutions:

1. Verify Key Format: Ensure key starts with sk- and is complete
2. Check OpenAI Dashboard: Verify key status at platform.openai.com
3. Regenerate Key: Create new API key if needed
4. Check Billing: Ensure account has valid payment method
5. Review Usage: Check if quota limits exceeded

Gemini API Key Issues

Solutions:

1. Check Project: Verify API key project in Google AI Studio
2. Enable Service: Ensure Gemini API is enabled
3. Review Quotas: Check usage limits and restrictions
4. Regional Access: Verify service availability in your region

Network Connectivity Problems

Symptoms

• Timeout errors
• Intermittent connection failures
• Slow response times

Possible Causes

Solutions

Check Firewall Settings:

• Allow outbound HTTPS connections
• Whitelist API domains:
  • api.openai.com
  • generativelanguage.googleapis.com

Test DNS Resolution:

nslookup api.openai.com
nslookup generativelanguage.googleapis.com

Verify SSL/TLS:

• Ensure server supports TLS 1.2+
• Check SSL certificate validity
• Update cURL if necessary

Proxy Configuration:

• Configure WordPress to use proxy if required
• Add proxy settings to wp-config.php if needed

Generation Problems

Generation Fails to Start

Symptoms

• "Generate Content" button doesn't respond
• No loading indicators appear
• Process never begins

Possible Causes

Solutions

Check Browser Console:

1. Open browser developer tools (F12)
2. Look for JavaScript errors in Console tab
3. Refresh page and try generation again
4. Note any error messages

Test AJAX Functionality:

1. Try other WordPress AJAX features
2. Check if admin-ajax.php is accessible
3. Verify WordPress AJAX is working

Clear Caches:

1. Clear browser cache
2. Clear WordPress caches (if using caching plugins)
3. Clear CDN caches if applicable

Generation Stops Mid-Process

Symptoms

• Generation starts but stops partway through
• Some products processed, others remain pending
• Progress indicator freezes

Possible Causes

Solutions

Handle Rate Limits:

• Reduce batch size
• Increase generation intervals
• Use Standard mode for unlimited generation

Increase Server Limits:

// Add to wp-config.php or .htaccess
ini_set('max_execution_time', 300);
ini_set('memory_limit', '512M');

Optimize Batch Size:

• Start with smaller batches (10-20 products)
• Gradually increase if successful
• Monitor server resources during generation

Partial Generation Results

Symptoms

• Some content types generate, others don't
• Inconsistent results across products
• Missing descriptions or tags

Possible Causes

Solutions

Check Content Settings:

1. Verify length limits are reasonable
2. Adjust max_length settings if needed
3. Test with different length parameters

Validate Product Data:

1. Ensure products have required information
2. Check for special characters in product data
3. Verify custom field values are present

Test Prompt Templates:

1. Simplify prompt templates
2. Remove complex variables temporarily
3. Test with basic prompts first

Performance Issues

Slow Generation Speed

Symptoms

• Generation takes much longer than expected
• Timeouts during bulk operations
• Poor responsiveness during generation

Possible Causes

Solutions

Optimize Server Performance:

• Upgrade hosting plan if needed
• Increase PHP memory limit
• Use SSD storage for better I/O
• Optimize database queries

Reduce Batch Sizes:

• Process 20-50 products at a time
• Use smaller batches during peak hours
• Schedule bulk operations during off-peak times

Simplify Prompts:

• Remove unnecessary complexity
• Reduce prompt length
• Optimize variable usage

High Memory Usage

Symptoms

• "Fatal error: Allowed memory size exhausted"
• Server becomes unresponsive
• Other WordPress functions affected

Solutions

Increase Memory Limit:

// wp-config.php
ini_set('memory_limit', '512M');

Optimize Processing:

• Process products in smaller batches
• Clear variables between generations
• Use more efficient algorithms

Monitor Usage:

• Use server monitoring tools
• Track memory usage patterns
• Identify memory leaks

Content Quality Issues

Poor Quality Output

Symptoms

• Generated content is generic or irrelevant
• Descriptions don't match products
• Inconsistent writing style

Possible Causes

Solutions

Improve Product Data:

1. Add detailed product information
2. Include relevant attributes and categories
3. Ensure custom fields are populated
4. Add high-quality product images

Optimize Prompts:

1. Be more specific in instructions
2. Include examples of desired output
3. Add brand voice guidelines
4. Use relevant variables effectively

Try Different Models:

1. Test with higher-quality models
2. Compare outputs from different providers
3. Adjust model parameters if available

Inconsistent Results

Symptoms

• Quality varies significantly between products
• Different writing styles in same batch
• Inconsistent formatting or structure

Solutions

Standardize Prompts:

1. Use consistent prompt templates
2. Define clear style guidelines
3. Include specific formatting instructions
4. Test prompts with multiple products

Improve Data Quality:

1. Ensure consistent product data format
2. Standardize attribute naming
3. Clean up product information
4. Use consistent categorization

Use Advanced Features:

1. Leverage custom variables for consistency
2. Use Advanced mode for better control
3. Apply brand voice settings
4. Review and refine templates regularly

Common Error Messages

Error Messages and Solutions

Debug Mode

Enabling Debug Mode

// Add to wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('AIPT_DEBUG', true);

Checking Debug Logs

1. Navigate to /wp-content/debug.log
2. Look for AIPT-related entries
3. Share relevant log entries with support

Getting Support

Before Contacting Support

Gather Information

Try Basic Troubleshooting

• Deactivate other plugins temporarily
• Switch to default WordPress theme
• Clear all caches
• Test with different browser

Support Channels

Providing Effective Support Requests

Include Essential Information

1. System Information: WordPress, PHP, server details
2. Error Details: Exact error messages, when they occur
3. Steps to Reproduce: Clear steps to recreate the issue
4. Screenshots: Visual evidence of problems
5. Log Files: Relevant debug log entries

Be Specific

• Describe exactly what you expected to happen
• Explain what actually happened instead
• Provide context about your setup and usage
• Include any recent changes to your site

Related Topics