AI Review Summary

Generate AI-powered review summaries and category opinions for your Voxel listings using ChatGPT.

Overview

The AI Review Summary feature uses OpenAI’s ChatGPT API to automatically generate intelligent summaries of your Voxel listing reviews. Similar to TripAdvisor’s review summaries, this feature analyzes all reviews for a listing and produces:

• Review Summaries: A concise paragraph highlighting the main strengths and weaknesses mentioned by reviewers
• Category Opinions: One-word sentiment indicators for specific aspects like Food, Service, Atmosphere, Value, etc.

How it works

When a visitor views a page with the shortcode, the system fetches all reviews from the Voxel timeline, sends them to ChatGPT for analysis, and displays the AI-generated summary. Results are cached to minimize API costs.

Setup & Configuration

Step 1: Enable the Feature

1. Navigate to Voxel Toolkit Settings Go to WordPress Admin → Voxel Toolkit → Functions and find the “AI Review Summary” function in the list.

2. Enable the Toggle Click the toggle switch to enable the AI Review Summary feature.

Step 2: Configure Your OpenAI API Key

3. Get an OpenAI API Key Visit platform.openai.com/api-keys to create an API key. You’ll need an OpenAI account with billing set up.

4. Enter Your API Key Paste your OpenAI API key (starts with sk-proj-...) into the “OpenAI API Key” field in the AI Review Summary settings.

5. Select Output Language Choose the language you want the AI to generate summaries in. Over 35 languages are supported.

6. Save Settings Click “Save Changes” to activate the feature.

Important

OpenAI API usage costs apply. Each summary generation uses the GPT-3.5-turbo model. Summaries are cached to minimize API calls, but clearing the cache or adding new reviews will trigger new API requests.

Available Shortcodes

[review_summary]

Generates an AI-powered summary of all reviews for a post. The summary focuses on main strengths and weaknesses mentioned by users, similar to TripAdvisor summaries.

Parameters

Parameter	Default	Description
post_id	Current post	The ID of the post to summarize reviews for. If not specified, uses the current post.

Examples

Basic usage (uses current post):

[review_summary]

Specific post:

[review_summary post_id="123"]

[category_opinions]

Creates a 2-column grid of category opinion boxes. Each box displays a category name and a one-word AI-generated sentiment summary based on what reviewers say about that aspect.

Parameters

Parameter	Default	Description
post_id	Current post	The ID of the post to analyze reviews for.
categories	Food, Atmosphere, Service, Value	Comma-separated list of categories to analyze. Customize based on your listing type.

Examples

Default categories (Food, Atmosphere, Service, Value):

[category_opinions]

Custom categories for a hotel:

[category_opinions categories="Cleanliness, Location, Staff, Comfort"]

Custom categories for a product:

[category_opinions categories="Quality, Price, Shipping, Support"]

Specific post with custom categories:

[category_opinions post_id="456" categories="Teaching, Facilities, Value, Location"]

Using with Elementor

You can easily add AI Review Summaries to your Voxel single listing templates using Elementor:

Method 1: Shortcode Widget

1. Edit your single listing template in Elementor
2. Search for the Shortcode widget and drag it to your layout
3. Enter [review_summary] or [category_opinions]
4. The shortcode will automatically use the current listing’s ID

Method 2: Text Editor Widget

1. Add a Text Editor widget to your template
2. Switch to the Text/HTML view
3. Paste your shortcode

Tip

When using shortcodes in single listing templates, you don’t need to specify post_id – the system automatically detects the current listing.

Caching & Performance

To minimize API costs and improve performance, all AI-generated content is cached:

How Caching Works

• Automatic caching: Summaries are stored as post meta after the first generation
• Smart invalidation: Cache automatically refreshes when new reviews are added
• Per-category caching: Each category opinion is cached separately

Cache Refresh

The cache is automatically invalidated when:

• The number of reviews for a post changes
• You manually clear the cache from the settings page

Manual Cache Refresh

To regenerate all AI summaries:

1. Go to Voxel Toolkit → Settings
2. Find the AI Review Summary settings
3. Click “Refresh All Cached Summaries”
4. Confirm the action

Note

Refreshing the cache will delete all stored summaries. New API calls will be made when users next visit pages containing the shortcodes.

Language Support

The AI can generate summaries in over 35 languages. The language setting affects the output language of all AI-generated content.

Supported Languages

• English

• Italian

• Spanish

• French

• German

• Portuguese

• Dutch

• Russian

• Chinese

• Japanese

• Korean

• Arabic

• Hindi

• Turkish

• Polish

• Swedish

• Danish

• Norwegian

• Finnish

• Czech

• Hungarian

• Romanian

• Bulgarian

• Croatian

• Slovak

• Slovenian

• Estonian

• Latvian

• Lithuanian

• Greek

• Hebrew

• Thai

• Vietnamese

• Indonesian

• Malay

• Ukrainian

Note

The AI will generate summaries in the selected language regardless of the original review language. Reviews in any language will be analyzed and summarized in your chosen output language.

Troubleshooting

Common Issues

“No reviews available for this post”

This message appears when:

• The post has no reviews in the Voxel timeline
• The post_id parameter points to an invalid post
• Reviews exist but don’t contain rating data

Solution: Ensure the listing has published reviews with ratings.

“ChatGPT API key is not configured”

The OpenAI API key hasn’t been saved in the settings.

Solution: Go to Voxel Toolkit Settings and enter your OpenAI API key.

“Error contacting ChatGPT API”

The API request failed. Possible causes:

• Invalid or expired API key
• OpenAI API rate limits exceeded
• Network connectivity issues
• OpenAI service outage

Solution: Verify your API key is valid and has available credits at platform.openai.com.

Summaries not updating after new reviews

The cache might not have detected the new review count.

Solution: Use the “Refresh All Cached Summaries” button in the settings to force regeneration.

API Cost Optimization Tips

• Use fewer categories in [category_opinions] to reduce API calls
• Avoid clearing the cache frequently
• Consider only displaying summaries on high-traffic listings
• The GPT-3.5-turbo model is used for cost efficiency

Best Practice

Place the shortcodes in your single listing Elementor template so summaries are automatically shown for all listings that have reviews.

AI Review Summary feature developed by Miguel Gomes Part of the Voxel Toolkit plugin