Partially Widget for BigCommerce
Partially Widget for BigCommerce
The widget is a small bit of JavaScript code that you can place on your product pages to let customers know they can purchase with a Partially payment plan. The widget will let the customer interactively see the payment plan options available to them.
Generate the widget
The widget code is generated by the integration tool of your offer. The generated code can be customized further — see the options below.
Add the widget code to BigCommerce
You will need to add the widget code to the product-view file of your theme under Templates Folder > Components Folder > Product Folder > product-view.html file. It's recommended to place it under your product price.
Widget options
- amount (string) — the amount to use for the payment plan, typically product price
- offer (string) — this decides the terms to use in the widget, the offer ID from your Partially merchant portal
- currency (string) — currency to use, default USD
- language (string) — language to use in the widget popup, defaults to
enfor English. Options:de,en,es,fr,it,pt - source (string) — if your Partially account integrates with your shopping cart, set the source here
- includeCheckout (boolean) — true to include a Partially checkout button in the widget
- checkoutButtonText (string) — if including a checkout button
- style (string) — widget style, either
stackedorthin. Default isstacked - title (string) — for stacked style widgets, text for the title
- actionText (string) — text for the widget link to open popup
- popupDetails (string) — custom text in the header of widget popup
- body (string) — custom body text for the widget. Custom placeholders are available to insert. Leave empty for default dynamic body.
- targetSelector (string) — CSS selector for element to render the widget inside of
- render (boolean) — whether or not to automatically render the widget, default
true - actionSelector (string) — if setting render to false, set this to a CSS selector to the element which should trigger opening the widget popup
- quantity (integer) — quantity of the product, default
1 - quantitySelector (string) — CSS selector of quantity input element to monitor for changes, and automatically update widget price
- checkoutButtonConfig (object) — checkout button config
Custom placeholders
A few custom placeholders are available for the widget body to insert dynamic information:
- down_payment_amount — the calculated down payment amount
- down_payment_min_amount — the calculated minimum down payment amount, for offers with a flexible down payment
- payment_amount — the calculated scheduled payment amount
These placeholders are dynamically calculated using Liquid syntax. For example:
Payment plan available, as low as {{payment_amount}} per month