DataFirefly Product FAQ AI for WooCommerce — Documentation

DataFirefly Product FAQ AI automatically generates contextual FAQs for your WooCommerce product pages using OpenAI or Anthropic Claude, and injects Schema.org FAQPage rich snippets in the head for Google rich results. This guide covers installation, full configuration and day-to-day usage.

Requirements

• WordPress 6.0 or later (tested up to 6.6)
• WooCommerce 7.0 or later (tested up to 9.4), HPOS-compatible
• PHP 7.4 to 8.3
• An OpenAI API key (platform.openai.com/api-keys) or an Anthropic key (console.anthropic.com)
• Optional: Polylang or WPML for multilingual stores

Installation

1. Download dffaqai-1.0.0.zip from your DataFirefly account.
2. In the WordPress admin: Plugins → Add New → Upload Plugin, select the ZIP and click Install Now.
3. Click Activate. The plugin creates its FAQ storage table and default settings.

AI provider configuration

Go to FAQ AI → Settings → Provider tab.

Choosing OpenAI or Anthropic Claude

• OpenAI: paste your API key, then pick a model — gpt-4o-mini (cheapest, recommended), gpt-4o, gpt-4-turbo or gpt-3.5-turbo.
• Anthropic Claude: paste your API key, then pick — claude-haiku-4-5 (economical, recommended), claude-sonnet-4-6 or claude-opus-4-7.

The plugin automatically routes to the correct API based on the selected provider. You can switch at any time: already-generated FAQs are preserved.

Generation parameters

• Number of questions per product: 1 to 15 (default 5).
• Temperature: 0 (deterministic) to 2 (very creative). Default 0.7.
• Max tokens: maximum length of the AI response. Default 2000.

Prompt tab — customising the generated content

Voice tone

Six preconfigured styles: professional, friendly, casual, technical, enthusiastic, reassuring. The tone reshapes the answers without any code.

Target audience

Free text, e.g. “medical professionals (B2B)”, “first-time buyers” or “DIY enthusiasts”. The AI adapts vocabulary, references and depth.

Custom system prompt

Leave empty to use the default prompt built from tone and audience. When filled in, it completely replaces the default instructions — useful for stores with strict editorial guidelines.

Additional directives

Instructions appended to every prompt, e.g. “always mention the 2-year warranty”, “avoid superlatives”, “do not compare to competitors”.

Product context to include

Three checkboxes enrich the context sent to the AI: primary category, brand (the product_brand, pwb-brand and yith_product_brand taxonomies are auto-detected) and WooCommerce attributes. On technical products, including attributes greatly improves question relevance.

Display & SEO tab

Display position

Five WooCommerce hooks to choose from:

• woocommerce_after_single_product_summary — below the tabs (default)
• woocommerce_single_product_summary — inside the product summary
• woocommerce_product_meta_end — end of the product meta
• woocommerce_after_single_product — after the whole product area
• woocommerce_before_single_product — before the whole product area

The hook priority (default 15) is configurable to coexist with other plugins.

Display mode

Accordion (first question open, ARIA keyboard navigation) or all answers expanded.

FAQPage rich snippets

When enabled, the plugin injects the Schema.org FAQPage JSON-LD in the head of every product page with at least one active FAQ. The encoding uses JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS and JSON_HEX_QUOT and passes Google’s Rich Results Test.

FAQ title per language

One title field per active site language, with defaults shipped for FR, EN, ES, DE, IT, PT and NL.

Excluded categories

A comma-separated list of WooCommerce category IDs. Products in those categories are skipped in bulk generation and auto-generation (virtual products, gift cards, etc.).

The FAQ meta box on the product screen

On every product edit screen, the FAQ AI meta box gives full control:

• Generate with AI: creates a Q&A set for the selected language.
• Add a manual question at any time.
• Edit a question or answer: the row auto-saves on blur.
• Reorder by drag-and-drop using the handle on the left of each row.
• Enable/disable an entry without deleting it.
• Delete an entry permanently.

A language selector at the top of the meta box switches instantly between the Polylang or WPML translations of the product — each translation has its own FAQ set.

Bulk generation

Menu FAQ AI → Bulk generation:

1. Pick the target language: default language, a specific language, or all active languages.
2. Optionally tick Force regenerate to overwrite existing FAQs (useful after changing the tone or provider).
3. Click Start.

Processing is sequential (about one product per second depending on API latency) with a live progress bar, a processed-products counter and a per-product error log. The Stop button aborts cleanly between two products. Only published products are processed; excluded categories are skipped.

Auto-generation on product creation

An option in the Provider tab: when enabled, the plugin automatically generates a FAQ in the default language every time a product without one is saved. Existing FAQs are never overwritten by this mechanism.

Multilingual with Polylang & WPML

The plugin auto-detects Polylang (pll_languages_list, pll_get_post_translations) and WPML (wpml_active_languages, wpml_object_id). Each translation of a product receives its own FAQ set, generated natively in the target language — not a translation of the original. The “all languages” bulk mode iterates over every translation of every product.

Verifying the rich snippets

1. Open a product page with at least one active FAQ.
2. View the page source and search for application/ld+json: a "@type":"FAQPage" block must be present.
3. Test the URL in Google’s Rich Results Test: the “FAQ” detection must be valid.

Troubleshooting

“AI provider API key is not configured”

Enter the key for the active provider in the Provider tab. Check there is no leading/trailing whitespace in the key.

API error during generation

Go to WooCommerce → Status → Logs and select the dffaqai source: every API error is logged there with the HTTP code and the provider’s message (invalid key, quota exceeded, unknown model…).

The FAQ block does not show

Check that the product has at least one active FAQ in the displayed language, and that your theme runs the chosen hook. If in doubt, go back to the default hook woocommerce_after_single_product_summary, present in all standard WooCommerce themes.

Generated questions are in the wrong language

The generation language follows the product’s translation (Polylang/WPML) or the site locale on single-language sites. Check the meta box language selector before generating.

Uninstall

Deactivation keeps all data. Deleting the plugin runs uninstall.php: the FAQ SQL table and every dffaqai_* option are permanently removed.

Support

Support is provided by email with a reply within 24 working hours (FR/EN). If possible, attach the dffaqai log and your WordPress/WooCommerce/PHP versions.