# AI Review Pros/Cons Synthesizer – Complete guide

> Installation and configuration guide for the AI Review Pros/Cons Synthesizer module: AI providers, review sources, bulk generation, multilingual cron and display.

- Page: <https://www.datafirefly.com/en/documentation/dfreviewsynth/>
- Language: en
- Last updated: 2026-06-17
- Other languages: [fr](https://www.datafirefly.com/documentation/dfreviewsynth/index.md), [es](https://www.datafirefly.com/es/documentation/dfreviewsynth/index.md), [de](https://www.datafirefly.com/de/documentation/dfreviewsynth/index.md), [it](https://www.datafirefly.com/it/documentation/dfreviewsynth/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfreviewsynth/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviewsynth/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviewsynth/index.md)
- Index: <https://www.datafirefly.com/en/documentation/llms.txt>

The **AI Review Pros/Cons Synthesizer** module reads a product's customer reviews and uses AI to generate a summary as **Pros** and **Cons** badges shown directly on the product page. Syntheses are cached per product, language and shop, and refreshed automatically via a cron.

## Overview

When a product page accumulates hundreds of reviews, few visitors actually read them. The module condenses that signal into a few clear badges, with a neutral summary line and a mention counter. Three AI providers are supported: Mistral AI, OpenAI and Anthropic (Claude). Each synthesis is produced in the language of the page, which suits multilingual catalogues.

## Requirements

- PrestaShop 8.0 to 9.x (single or multistore).
- PHP 7.4 to 8.x with the cURL extension enabled.
- A reviews source: the official _Product Comments_ module, or _DataFirefly Reviews_.
- An API key from an AI provider (Mistral, OpenAI or Anthropic).

## Installation

1. In the back office, open **Modules > Module Manager > Upload a module**.
2. Select the `dfreviewsynth.zip` archive and install it.
3. Click **Configure** to access the settings.

**Good to know.** Installation creates a dedicated cache table and a hidden admin tab used only for generation calls.

## Configuration

### AI provider and API key

Choose the **provider** (Mistral, OpenAI or Anthropic), paste your **API key** and set the desired **model**:

- Mistral: `mistral-small-latest`
- OpenAI: `gpt-4o-mini`
- Anthropic: `claude-haiku-4-5`

**Tip.** Leave the key field empty when saving again to keep the stored key: it is never displayed back for security reasons.

### Reviews source

Select where reviews come from. The _Product Comments_ adapter reads approved, non-deleted comments. The _DataFirefly Reviews_ adapter reads active reviews; adjust the column names in the data access class if your schema differs.

### Display position

Two positions are available on the product page: **below the short description** (additional information) or **in the product footer**.

### Thresholds and cache

- **Minimum reviews**: below this number, no synthesis is generated.
- **Max badges per side**: caps the number of Pros and Cons shown.
- **Max reviews sent to AI**: caps token usage (the most recent reviews are prioritized).
- **Cache TTL (days)**: used by the cron to refresh stale syntheses.

## Generating syntheses

### Admin console

On the configuration page, the console lets you load eligible products (those reaching the minimum reviews threshold), then generate syntheses one by one or in bulk, with a progress bar. Generation runs in the current back-office language.

### Multilingual cron

To keep every language up to date automatically, schedule a regular call to the cron URL shown in the configuration:

```
/index.php?fc=module&module=dfreviewsynth&controller=cron&token=YOUR_TOKEN&limit=20
```

The `limit` parameter caps how many products are processed per run (default 20, max 100). The cron iterates over each active language and only regenerates syntheses that are missing, in error or stale.

**Warning.** The cron token is confidential. If leaked, regenerate it from the configuration page: the old URL stops working immediately.

## Storefront display

On the product page, the module shows a "What customers say" block with two columns (Pros in green, Cons in orange), an optional neutral summary line, the number of reviews taken into account and a per-badge mention counter. An "AI-generated summary" notice can be displayed for transparency towards customers.

## Multilingual catalogue

Each synthesis is stored per product, language and shop. Content is generated in the language of the page, and the cron synchronizes all active languages. A synthesis is only regenerated when the reviews content changes (fingerprint detection) or when the cache expires.

## Troubleshooting

- **No badges shown.** Check that the product reaches the minimum reviews count and that a synthesis was generated (console or cron).
- **"Error" status in the console.** Verify the API key, the model name and cURL availability; the last error detail is kept in the cache.
- **Reviews not detected.** Confirm the selected source and, for DataFirefly Reviews, the column mapping in the adapter.

## Changelog

- **1.0.0** — First public release: AI Pros / Cons synthesis (Mistral, OpenAI, Anthropic), multilingual cache, admin console and refresh cron.