PrestaShop module for Flow widgets

The official PrestaShop module connects published Advice flows to product pages, category pages and theme content without core overrides.

Requirements

• PrestaShop 8.1 or newer, including PrestaShop 9.
• PHP 8.1 or newer.
• A published Advice flow and its Flow UUID.
• The storefront domain added under Team -> Allowed embed domains.

Install with Composer

Run these commands from the PrestaShop project root:

composer require berrypath/prestashop-berrypath-flow
php bin/console prestashop:module install berrypathflow

Then open Modules -> Module Manager -> BerryPath Guided Selling Flows to configure the module.

Install through Module Manager

Download a module ZIP with berrypathflow as its top-level folder. Upload it through Modules -> Module Manager -> Upload a module, then install and configure it.

Connect an Advice flow

1. Publish the Advice flow in BerryPath.
2. Open Share & Publish, select PrestaShop and copy the Flow UUID.
3. Add the storefront domain under Team -> Allowed embed domains.
4. Edit a product or category in PrestaShop and open the BerryPath section.
5. Enter the Flow UUID and choose Popup, Sidebar or Inline.
6. Save and test the storefront page on desktop and mobile.

Each product and category can use its own Advice flow. The title, description and button text use PrestaShop language fields, so each storefront language can have its own copy.

Add a Flow widget to theme content

The module exposes a native Smarty widget:

{widget
  name='berrypathflow'
  flow='YOUR_FLOW_UUID'
  type='popup'
  title='Need help choosing?'
  description='Answer a few short questions and quickly find the product that fits you.'
  button='Start the choice helper'
}

Supported display types are popup, sidebar and inline. Optional parameters include market, locale, product_id and context.

Translate module labels

Translate the module's built-in storefront labels through International -> Translations -> Installed modules translations -> BerryPath Guided Selling Flows.

Measure assisted conversions

Assisted conversion tracking is optional. When enabled, the module sends the order total and product identifiers after an order. It does not send customer names, email addresses, postal addresses or payment details.

Links

• PrestaShop module on GitHub
• PrestaShop integration overview
• Flow widget docs