Precise Expressions Product Fit Assistant for WooCommerce

by preciseexpressions

Description

Precise Expressions Product Fit Assistant for WooCommerce adds a compact slide-out assistant to single product pages. It helps shoppers review fit, compatibility, product options, accessories, personalization details, and ordering checks before checkout without crowding the product page.

The assistant is rule-based by default and uses WooCommerce product data, global templates, category guidance, attribute guidance, product attributes, variations, upsells, cross-sells, and optional merchant notes. Prompt buttons are selected from product context, and merchants can add custom help prompts for individual products.

The plugin also includes Product Finder, a store-wide product discovery assistant available with the [pfwa_product_finder] shortcode. Product Finder searches the local catalog first, recommends real published WooCommerce products, and falls back to local catalog search when AI is unavailable.

The rule-based fallback works without external services, subscriptions, or complex setup. Optional AI answers are available for merchants who connect their own OpenAI API account. The plugin is translation-ready, and AI-generated answers or discovery keyword suggestions can be instructed to use the site language, shopper language where possible, English (US), or a custom language.

The assistant and Product Finder provide merchant-configured guidance and product-data reminders. They do not guarantee fit, compatibility, product suitability, availability, or return eligibility.

Features include:

Compact product-page slide-out guidance helper with context-aware prompt buttons.
Optional product-specific custom help prompts and personalization capability notes.
Product Finder shortcode for store-wide product discovery.
Local candidate product search before optional AI ranking.
Setup Guide with safe suggested global templates for common store types.
Category and attribute guidance rules to reduce per-product setup.
Global guidance templates for common reminders.
Product-level fit notes, compatibility warnings, required accessories, common questions, and return-prevention notes.
Primary, secondary, and exclude Product discovery keywords to improve Product Finder matches for natural shopper requests.
Per-product Generate discovery keywords helper with Conservative, Balanced, and Broad styles, local suggestions, and optional AI suggestions.
Optional privacy-minimal interaction logging.
Simple dashboard to find products with weak or missing guidance.
Optional AI-generated answers using a merchant-provided OpenAI API key.
Basic language controls for AI-generated answers and Product discovery keyword suggestions.
Temporary AI answer caching, usage limits, manual cache clearing, cache versioning, and scheduled cleanup.
Privacy policy suggestion text.

Product Fit Assistant Pro

Product Fit Assistant Pro is an optional paid add-on for stores that need faster setup workflows and deeper Product Finder reporting.

The free plugin includes the product-page assistant, Product Finder shortcode, local catalog matching, product discovery keywords, optional AI answers, category guidance, attribute guidance, and the guidance dashboard.

The Pro add-on extends the free plugin with:

Bulk guidance and discovery keyword generation.
Fill-empty and overwrite workflows for product guidance fields.
Product Finder Insights.
Missed-query reporting.
Product improvement opportunity reports.
Pro license and update support.

The Pro add-on is not required to use the free plugin.

Learn more:
https://software.preciseexpressions.com.au/product/precise-expressions-product-fit-assistant-pro/

Privacy

If interaction logging is enabled, Precise Expressions Product Fit Assistant for WooCommerce may store privacy-minimal assistant interaction logs. These logs may include product ID, selected prompt, optional shopper-entered question, whether guidance was available, and the interaction time.

Category guidance rules and attribute guidance rules are merchant configuration only. They do not store shopper identity or customer personal data.

The plugin does not intentionally store customer names, email addresses, billing addresses, shipping addresses, raw IP addresses, payment details, user agents, or full cart contents.

AI-generated answers are optional. The rule-based fallback can work without AI. If AI features are enabled, product context, shopper-entered questions or guided answers, Product Finder requests, limited candidate product information, one-product keyword-generation context, and configured language instructions may be sent to the selected AI provider. The plugin searches the local WooCommerce catalog first and does not intentionally send the entire catalog.

AI answers and AI Product Finder recommendations may be cached temporarily to reduce repeated API calls and improve response speed. Cached entries do not include API keys and should not intentionally include customer personal data. Store owners can clear the AI answer cache from WooCommerce > Product Fit Assistant > AI Assistant.

Store owners should review shopper-entered questions before enabling logging or AI-generated answers and update their privacy policy as appropriate.

External Services

The rule-based fallback does not require external services.

If AI-generated answers are enabled, the plugin can connect to the OpenAI API from the server side. The plugin uses https://api.openai.com/v1/responses for connection tests, optional product-page AI answers, optional AI-ranked Product Finder recommendations, and optional per-product Product discovery keyword suggestions. Product context, merchant-entered personalization capability notes, shopper-entered questions or guided answers, shopper Product Finder requests, limited candidate product information, and one-product admin keyword-generation context may be sent to OpenAI when AI features are enabled.

OpenAI terms and privacy information are available here:

AI usage is billed separately by OpenAI and is not included with this plugin.

This plugin does not require ChatGPT, Anthropic, bundled AI credits, or a bundled API key.

Installation

Upload the precise-expressions-product-fit-assistant-for-woocommerce folder to /wp-content/plugins/.
Activate the plugin from the WordPress Plugins screen.
Go to WooCommerce > Product Fit Assistant.
Review the Setup Guide and apply suggested global templates if helpful.
Add category or attribute guidance rules for reusable fit, option, accessory, ordering, or return guidance.
Edit products and add optional Product Fit Assistant notes where product-specific guidance is needed.
Add [pfwa_product_finder] to a page if you want shoppers to search the catalog with natural-language requests.

WooCommerce must be active for the assistant to initialize.

Screenshots

Product Finder storefront assistant with natural-language product discovery.
Slide-out product-page assistant with context-aware guidance prompts.
Product-level Product Fit Assistant guidance fields.
Setup Guide with reusable store guidance templates.
Category and attribute guidance rules for reusable product advice.
Optional AI Assistant settings for merchant-provided OpenAI API access.
Guidance dashboard showing products that may need stronger guidance.

Faq

Does this plugin require AI?

No. The rule-based fallback works without AI and uses WooCommerce product data plus optional merchant-entered guidance.

Does this plugin require an API key?

No API key is required for the rule-based assistant or local Product Finder fallback. If a store owner enables AI-generated answers for product-page answers or AI-ranked product recommendations, they must provide their own OpenAI API key.

Is a ChatGPT subscription enough for AI-generated answers?

No. A ChatGPT subscription is not the same as OpenAI API billing. AI-generated answers require an OpenAI API account with API billing enabled.

Does the plugin include AI credits or bundled API keys?

No. The plugin does not include bundled AI credits, bundled API keys, or an API subscription. AI usage is billed separately by the selected AI provider.

Is there a Pro version?

Yes. Product Fit Assistant Pro is an optional paid add-on for stores that need advanced workflow and reporting tools. The free version remains fully functional and does not require Pro.

Product Fit Assistant Pro adds bulk guidance and discovery keyword generation, fill-empty and overwrite workflows, Product Finder insights, missed-query reporting, and product improvement opportunity reports. Pro features appear inside the same WooCommerce > Product Fit Assistant admin area when the Pro add-on is installed and licensed.

Product Fit Assistant Pro requires this free plugin to be installed and active.

Learn more:
https://software.preciseexpressions.com.au/product/precise-expressions-product-fit-assistant-pro/

Where does the assistant appear?

The product-page assistant appears on individual product pages. Product Finder is separate and appears on shop/category pages when enabled, or wherever the [pfwa_product_finder] shortcode is used.

How do I add Product Finder?

Add [pfwa_product_finder] to a page, homepage, shop page content area, category page content area, or other shortcode-capable location. Product Finder uses modal mode by default. Use [pfwa_product_finder mode="inline"] for the full form.

Does Product Finder send my whole catalog to AI?

No. Product Finder searches WooCommerce locally first and sends only a limited set of top candidate products to the AI provider when AI-generated answers are enabled.

Does disabling AI hide the assistant interfaces?

No. AI-generated answers are separate from display settings. Turning AI off stops AI provider calls, but the product-page assistant and Product Finder can still appear if their own settings are enabled and local fallback guidance is available.

Can I disable the assistant for one product?

Yes. Edit the product and use the Product Fit Assistant meta box to inherit the global setting, enable it, or disable it for that product.

Do I need to configure every product?

No. Global templates, category guidance rules, and attribute guidance rules can provide reusable guidance across many products. Product-level notes are optional overrides for products that need more specific guidance.

How do Product discovery keywords work?

Product discovery keywords are optional phrases on the product edit screen. Primary keywords are strong matches, secondary keywords are related but weaker matches, and exclude / not suitable keywords reduce ranking when a shopper is clearly looking for something different. Product editors can enter keywords manually or generate suggested phrases for one product at a time. Local suggestions work without AI; optional AI suggestions require a merchant-provided OpenAI API key.

Can AI answers or generated keywords use another language?

Yes. AI answers can use the WordPress site language, English (US), a custom language, or match the shopper language where practical. Discovery keywords can use the WordPress site language, English (US), or a custom language. Static plugin labels still require normal WordPress translation files. The plugin does not automatically translate product content.

Does the assistant decide whether an item can be returned?

No. Return-related responses are neutral reminders based on merchant guidance and product data. Shoppers should review the store return policy, and store owners remain responsible for their own return terms and legal obligations.

Does the plugin store shopper personal data?

The plugin is designed to avoid storing customer identity. If interaction logging is enabled, logs may include product ID, selected prompt, optional shopper-entered question, whether guidance was available, and the time of the interaction.

The Guidance dashboard summarizes product-page assistant interactions and includes a Clear interaction logs button so store owners can reset test logs before public testing. Store-wide Product Finder searches are not included in the product interaction summary.

Reviews

Changelog

1.0.1

Improved AI fallback transparency by showing a clear visitor notice when AI answer limits are reached and local product guidance is displayed.
Added a product-page assistant display position after the short description so the assistant remains visible when Add to Cart is hidden or disabled.
Improved frontend notice styling for AI fallback messages.

1.0.0

Initial public release.
Product-page assistant with local fallback and optional AI-generated answers.
Store-wide Product Finder with modal interface.
Product discovery keywords and per-product keyword generation helper.
Product Assistant language and keyword language settings.
Guidance dashboard and interaction logging tools.