Product Review Summarizer for WooCommerce

$39.00

Description

Generate AI-powered review summaries for WooCommerce products using OpenAI, displayed in an Amazon-style “Customers say” block.

🚀 Features

Core Features

  • 🤖 AI-Powered Summaries: Uses OpenAI’s GPT-4o and GPT-3.5-turbo models to generate natural, contextual summaries
  • Background Processing: All AI generation happens in the background – no impact on page load speed
  • 🎯 Amazon-Style Display: Clean, professional “Customers say” block that matches modern e-commerce design
  • 🔧 Admin Controls: Easy settings page under WooCommerce menu with API key management and quota monitoring
  • 📝 Manual Override: Edit summaries manually and prevent automatic regeneration
  • 🔄 Bulk Operations: Regenerate summaries for multiple products at once
  • 📊 Logging System: Comprehensive logging for debugging and monitoring
  • 📱 Responsive Design: Works perfectly on all devices
  • 🎨 Customizable: Extensive filter hooks for developers

Technical Features

  • Background Processing: WordPress cron jobs for non-blocking operations
  • Review Validation: Quality checks to ensure meaningful summaries
  • Error Handling: Graceful handling of API failures and edge cases
  • Security: Proper nonce verification, input sanitization, and capability checks
  • Performance: Efficient review querying and caching

📋 Requirements

  • WordPress: 5.0 or higher
  • WooCommerce: 5.0 or higher
  • PHP: 7.4 or higher
  • OpenAI API Key: Required for AI functionality
  • cURL: Must be enabled on your server

🛠️ Installation

Method 1: WordPress Admin (Recommended)

  1. Go to Plugins → Add New in your WordPress admin
  2. Search for “AI Review Summarizer for WooCommerce”
  3. Click Install Now and then Activate
  4. Go to WooCommerce → AI Review Summary to configure your OpenAI API key

Method 2: Manual Installation

  1. Download the plugin files
  2. Upload to /wp-content/plugins/ai-review-summarizer/
  3. Activate the plugin through the Plugins screen
  4. Configure your OpenAI API key in WooCommerce → AI Review Summary

⚙️ Configuration

1. Get OpenAI API Key

  1. Visit OpenAI Platform
  2. Create an account or sign in
  3. Generate a new API key
  4. Copy the key (you won’t be able to see it again)

2. Configure Plugin

  1. Go to WooCommerce → AI Review Summary
  2. Enter your OpenAI API key
  3. Choose your preferred model (GPT-4o or GPT-3.5-turbo)
  4. Test the connection
  5. Save settings

3. Add Reviews

  1. Add customer reviews to your products
  2. The plugin will automatically generate summaries
  3. Summaries appear on product pages in a “Customers say” block

💰 Pricing

The cost depends on your OpenAI usage:

  • GPT-3.5-turbo: ~$0.002 per 1K tokens (very affordable)
  • GPT-4o: ~$0.005 per 1K tokens (higher quality)
  • Typical cost: Less than $0.01 per summary generation

🔧 Usage

Automatic Generation

  • Summaries are generated automatically when new reviews are added
  • Background processing ensures no impact on site performance
  • Quality validation ensures meaningful summaries

Manual Control

  • Edit Summaries: Go to any product’s edit page and find the “AI Review Summary” metabox
  • Prevent Regeneration: Check “Disable AI Summary” to prevent automatic updates
  • Manual Regeneration: Use the “Regenerate AI Summary” button for immediate updates
  • Bulk Operations: Use bulk actions on the products page for mass regeneration

Shortcode Usage

Display summaries anywhere using shortcodes:

// Display summary for current product
[ai_review_summary]

// Display summary for specific product
[ai_review_summary product_id="123"]

🎨 Customization

Developer Hooks

The plugin provides extensive filter hooks for customization:

ai_review_summarizer_prompt

Filter the prompt sent to OpenAI.

add_filter('ai_review_summarizer_prompt', function($prompt, $reviews_text, $product_id) {
    return "Create a friendly summary of these customer reviews: " . $reviews_text;
}, 10, 3);

ai_review_summarizer_model

Override the selected model before API call.

add_filter('ai_review_summarizer_model', function($model, $product_id) {
    return 'gpt-4o'; // Always use GPT-4o
}, 10, 2);

ai_review_summarizer_output_html

Customize the final summary HTML output.

add_filter('ai_review_summarizer_output_html', function($html, $product_id) {
    return '<div class="my-custom-summary">' . $html . '</div>';
}, 10, 2);

ai_review_summarizer_review_count

Change how many recent reviews are summarized.

add_filter('ai_review_summarizer_review_count', function($count, $product_id) {
    return 15; // Use 15 reviews instead of 10
}, 10, 2);

ai_review_summarizer_trim_length

Change character limit for each review before processing.

add_filter('ai_review_summarizer_trim_length', function($length, $product_id) {
    return 300; // Limit to 300 characters per review
}, 10, 2);

ai_review_summarizer_max_tokens

Modify the max tokens sent to OpenAI.

add_filter('ai_review_summarizer_max_tokens', function($tokens, $product_id) {
    return 300; // Allow longer summaries
}, 10, 2);

ai_review_summarizer_temperature

Modify the temperature setting for OpenAI.

add_filter('ai_review_summarizer_temperature', function($temperature, $product_id) {
    return 0.7; // More creative summaries
}, 10, 2);

ai_review_summarizer_batch_token_limit

Modify token batching threshold for OpenAI requests.

add_filter('ai_review_summarizer_batch_token_limit', function($limit, $product_id) {
    return 4000; // Higher token limit
}, 10, 2);

ai_review_summarizer_summary_content

Filter the summary content before display.

add_filter('ai_review_summarizer_summary_content', function($summary, $product_id) {
    return strtoupper($summary); // Convert to uppercase
}, 10, 2);

🔍 Troubleshooting

Common Issues

Q: Summary not generating?

  • Check that you have at least 3 meaningful reviews (5+ words each)
  • Verify your OpenAI API key is valid and has sufficient credits
  • Check the logs page for detailed error information

Q: API errors?

  • Ensure your OpenAI API key is correct
  • Check your OpenAI account has sufficient credits
  • Verify your server has cURL enabled

Q: Summaries not appearing on frontend?

  • Check that WooCommerce is properly configured
  • Verify the product has reviews
  • Check your theme compatibility

Q: Performance issues?

  • All processing happens in the background
  • Check your WordPress cron is working properly
  • Monitor the logs for any bottlenecks

Logs and Debugging

The plugin includes a comprehensive logging system:

  1. Go to WooCommerce → AI Review Summary
  2. Scroll down to the Logs section
  3. View recent log entries for debugging
  4. Download logs for detailed analysis

🔒 Security

Security Features

  • Nonce Verification: All AJAX calls use proper nonce verification
  • Input Sanitization: All user inputs are properly sanitized
  • Capability Checks: Admin functions require proper permissions
  • Secure Storage: API keys are stored securely in WordPress options
  • Error Handling: Sensitive information is not exposed in error messages

Best Practices

  • Keep your OpenAI API key secure
  • Regularly monitor your API usage
  • Use HTTPS for all communications
  • Keep WordPress and plugins updated

📊 Performance

Performance Features

  • Background Processing: No impact on page load times
  • Efficient Queries: Optimized database queries with limits
  • Caching: Generated summaries are cached in post meta
  • Validation: Quality checks prevent unnecessary API calls
  • Batching: Efficient token management for API requests

Optimization Tips

  • Monitor your OpenAI API usage
  • Use appropriate model for your needs (GPT-3.5-turbo is faster and cheaper)
  • Regularly clear old logs if not needed
  • Consider using bulk operations for large catalogs

🤝 Support

Getting Help

  • Documentation: Check this README and the plugin’s help sections
  • Logs: Use the built-in logging system for debugging
  • WordPress.org: Visit the plugin page for community support
  • Developer: Contact us through our website for premium support

Contributing

We welcome contributions! Please:

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

📝 Changelog

Version 1.0.0

  • Initial Release
  • OpenAI API integration with GPT-4o and GPT-3.5-turbo support
  • Background processing with WordPress cron
  • Admin settings page with API key management
  • Frontend display with Amazon-style “Customers say” block
  • Manual override functionality with metabox
  • Regenerate button for individual products
  • Bulk actions for mass regeneration
  • Comprehensive logging system
  • Shortcode support
  • Developer hooks and filters
  • Quota monitoring and alerts
  • Review validation and quality checks

📄 License

This plugin is licensed under the GPL v2 or later.

Copyright (C) 2024 Simpull

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

🙏 Credits

  • OpenAI: For providing the AI models and API
  • WordPress: For the amazing platform
  • WooCommerce: For the e-commerce framework
  • Community: For feedback and contributions

Made with ❤️ by Simpull

Reviews

There are no reviews yet.

Be the first to review “Product Review Summarizer for WooCommerce”

Your email address will not be published. Required fields are marked *