Your cart is currently empty!
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)
- Go to Plugins → Add New in your WordPress admin
- Search for “AI Review Summarizer for WooCommerce”
- Click Install Now and then Activate
- Go to WooCommerce → AI Review Summary to configure your OpenAI API key
Method 2: Manual Installation
- Download the plugin files
- Upload to
/wp-content/plugins/ai-review-summarizer/
- Activate the plugin through the Plugins screen
- Configure your OpenAI API key in WooCommerce → AI Review Summary
⚙️ Configuration
1. Get OpenAI API Key
- Visit OpenAI Platform
- Create an account or sign in
- Generate a new API key
- Copy the key (you won’t be able to see it again)
2. Configure Plugin
- Go to WooCommerce → AI Review Summary
- Enter your OpenAI API key
- Choose your preferred model (GPT-4o or GPT-3.5-turbo)
- Test the connection
- Save settings
3. Add Reviews
- Add customer reviews to your products
- The plugin will automatically generate summaries
- 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:
- Go to WooCommerce → AI Review Summary
- Scroll down to the Logs section
- View recent log entries for debugging
- 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:
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- 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.