berrypath / woocommerce-berrypath-flow
WooCommerce plugin for BerryPath guided selling Flow widgets on product pages, category pages and WordPress content.
Package info
github.com/BerryPath/woocommerce-berrypath-flow
Type:wordpress-plugin
pkg:composer/berrypath/woocommerce-berrypath-flow
Requires
- php: >=7.4
README
Help shoppers choose the right product with guided selling flows on WooCommerce product pages, category pages, and WordPress content.
New to BerryPath? A free plan is available with 1 guided selling flow and up to 2,500 products. Existing customers keep using their current plan.
Features
- Guided onboarding and integration defaults under WooCommerce > BerryPath Guided Selling.
- Per-product and per-category BerryPath Flow UUID and placement settings.
- BerryPath Guided Selling Flows block and
[berrypath_flow]shortcode for WordPress content. - Popup, sidebar, and inline display modes.
- Product matching by ID, SKU, slug, name, global unique ID, custom field, or attribute.
- Assisted conversion tracking on the WooCommerce thank-you page.
- Theme template overrides, CSS custom properties, actions, and filters.
Configuration
Store defaults:
WooCommerce > BerryPath Guided Selling
Product pages:
Products > Edit product > Product data > General > BerryPath Guided Selling Flows
Category pages:
Products > Categories > Edit category > BerryPath Guided Selling Flows
WordPress content or page builders:
[berrypath_flow flow="YOUR_FLOW_UUID" type="popup"]
Publish the flow in BerryPath first, copy its BerryPath Flow UUID into WooCommerce, and make sure the storefront domain is allowed in BerryPath.
External Service
The plugin loads the BerryPath embed script on pages where a guided selling flow is displayed. BerryPath receives the BerryPath Flow UUID, locale, market code, and configured product identifier required to render the widget.
When assisted conversion tracking is enabled, the WooCommerce thank-you page passes order total and configured product identifiers to BerryPath. Customer names, email addresses, postal addresses, and payment details are not included. Tracking can be disabled in the plugin settings.
Service provider: BerryPath Terms: BerryPath terms and conditions Privacy policy: BerryPath privacy statement
Template Overrides
Copy any template from templates/ to a 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
Storefront styling lives in assets/css/berrypath-flow.css and uses BEM classes plus CSS custom properties.
Useful extension points:
berrypath_flow_before_widgetberrypath_flow_after_widgetberrypath_flow_widget_argsberrypath_flow_widget_templateberrypath_flow_locate_templateberrypath_flow_success_pixel_payload
License
MIT. This license is GPL-compatible.
