README

BerryPath Guided Selling Flows for PrestaShop

The official BerryPath integration for PrestaShop. Add guided product finders to product pages, category pages, and theme content without overriding PrestaShop core code.

Start free · Documentation · Live demo

The free plan includes one published flow and a catalogue of up to 2,500 products.

Guide shoppers where decisions happen

Add a dedicated flow to any product or category.
Choose a popup call to action, sidebar, or inline embed per placement.
Localize the title, description, and button label with PrestaShop's language fields.
Render flows from a Smarty theme with PrestaShop's native widget API.
Attribute assisted orders with optional conversion tracking.
Configure market, locale, and product identifiers for your catalogue.

Screenshots

PrestaShop configuration	Category placement

Product page	Category page

Guided question	Recommendations

Requirements

PrestaShop 8.1 or later, including PrestaShop 9.x
PHP 8.1 or later
A published BerryPath Flow UUID

Installation

Composer

Run these commands from the root of your PrestaShop project:

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

Then open Modules → Module Manager, find BerryPath Guided Selling Flows, and configure the integration.

Module Manager

Alternatively, download the latest release ZIP and install it from the back office:

Open Modules → Module Manager → Upload a module.
Upload the ZIP, which contains a top-level berrypathflow directory.
Configure BerryPath Guided Selling Flows.

Finally, edit a product or category, open its BerryPath section, and enter the published Flow UUID.

Publish the flow in BerryPath first and make sure the storefront domain is allowed. Leave the Flow UUID empty when no finder should be shown on that page. Titles, descriptions, and button labels are translatable fields. Built-in module strings can be translated under International → Translations → Installed modules translations → BerryPath Guided Selling Flows.

The BerryPath loader is only requested on pages that contain a configured widget or conversion marker.

Theme widget

Theme authors can render a flow without creating a product or category placement:

{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 type values are popup, sidebar, and inline. Optional parameters are market, locale, product_id, and context.

Data and privacy

The storefront loader sends the configured Flow UUID, locale, market, and optional product identifier to BerryPath. Browser and interaction information may be processed by the hosted BerryPath flow. When assisted conversion tracking is enabled, the order confirmation page reports the order total and unique product identifiers. This module does not send customer names, email addresses, postal addresses, or payment information.

Review the BerryPath privacy statement and terms when updating your store's privacy information.

Development

composer install
_PS_ROOT_DIR_=/path/to/prestashop composer quality

The module uses PrestaShop hooks, the Widget API, Symfony form modifiers, multistore-aware storage, and transactional writes. It does not override core classes or controllers.

License

MIT

berrypath / prestashop-berrypath-flow

Maintainers

Package info

Statistics

Security