README

BerryPath helps ecommerce teams add guided selling, product finder flows and product advice to their webshop. This plugin adds BerryPath Flow widgets to WooCommerce product pages, product category pages and WordPress content.

Website: www.berrypath.eu

Features

• BerryPath Flow settings page under WooCommerce.
• Product fields for showing a Flow widget on a WooCommerce PDP.
• Product category fields for showing a Flow widget on category pages.
• BerryPath Flow Gutenberg block and [berrypath_flow] shortcode for CMS content.
• Assisted conversion tracking on the WooCommerce thank-you page.

Configuration

Global settings:

WooCommerce > BerryPath Flow

Product pages:

Products > Edit product > Product data > General > BerryPath Flow

Category pages:

Products > Categories > Edit category > BerryPath Flow

CMS content:

[berrypath_flow flow="YOUR_FLOW_UUID" type="popup"]

Publish the flow in BerryPath first, then copy the Flow UUID into WooCommerce. Also make sure the WooCommerce storefront domain is allowed in BerryPath.

External Service

This plugin loads https://www.berrypath.eu/embed/berrypath.js on pages where a Flow widget is shown. BerryPath receives the Flow UUID, locale, market code and configured product identifier needed to render the widget.

When success pixel tracking is enabled, the WooCommerce thank-you page passes order total and configured product identifiers to BerryPath so assisted conversions can be measured. This can be disabled in the plugin settings.

Service provider: BerryPath
Privacy policy: https://www.berrypath.eu/privacy

Template Overrides

The plugin is built so storefront markup is easy to customize from a theme. Copy any template from templates/ to your theme under berrypath-flow/.

wp-content/themes/your-child-theme/berrypath-flow/widget.php
wp-content/themes/your-child-theme/berrypath-flow/product-widget.php
wp-content/themes/your-child-theme/berrypath-flow/category-widget.php
wp-content/themes/your-child-theme/berrypath-flow/content-widget.php

Templates:

• widget.php: shared widget markup.
• product-widget.php: product detail page placement.
• category-widget.php: product category placement.
• content-widget.php: Gutenberg block and shortcode placement.

Styling lives in assets/css/berrypath-flow.css and uses BEM classes plus CSS custom properties.

Useful filters:

• berrypath_flow_widget_args
• berrypath_flow_widget_template
• berrypath_flow_locate_template
• berrypath_flow_success_pixel_payload

Screenshots

License

MIT. This license is GPL-compatible.