General Configuration
The following section explains how to correctly configure the widget items
Settings
Attribute | Default value | Description |
---|---|---|
amount-selectors | [".price-container .price"] | List of price box selectors divided by "," |
amount | The amount used as fallback if amount-selectors prop is not defined | |
frequency-number | 30 | Number of days between each installment |
number-of-installments | 3 | Number of installments |
hide | false | Hide widget |
min | 0 | Minimun amount to display the widget |
max | 2000 | Maximum amount to display the widget |
currency-position | before | Position of the currency |
currency-display | symbol | Type to display the currency |
logo-size | 100 | Logo size in percentage |
locale | en | Language of the labels |
theme | primary | Theme of the widget |
Settings usage
Amount Limits
Set the amount limits of the product price on pageload by adding the following attributes:
min={minimum-amount}
max={maximum-amount}
Min & Max limits
This limits are set to default to 0 and 2000: make sure to modify them accordingly to your contract!
Frequency Number
Number of days between each installment. The value for Pay in Installments is 30. For Pay Later 14
frequency-number={frequency-number}
Number Of Instalment
Number of the payments with Scalapay. The values for Pay in Installments are 3 or 4. For Pay Later is 1.
number-of-instalment={number-of-instalment}
Handle changes to product amount
If the product price changes, simply add the selector of the product price component to allow the widget to watch for updates and change dynamically
amount-selectors='["#price-container"]'
For pages that can have multiple prices such as a regular price and special price, simply add multiple price selectors seperated by a comma ',' and the widget will prefer the price of the first selector
amount-selectors='["#price-container .default-price", "#price-container .secondary-price"]'
Amount value
The amount prop is used as fallback if amount-selectors
prop is not defined.
The value could be the price with or without the currency (i.e. 100.00 €
, 100.00
).
amount={amount-value}
Update language
The Scalapay widget supports English, Italian, Portuguese, German, French and Spanish languages.
Set the language by adding the following attribute (valid values are 'en', 'it', 'pt', 'de', 'fr', 'es'):
locale={'en' | 'it' | 'pt' | 'de' | 'fr' | 'es'}
Hide
Option to hide programmatically the widget.
hide={true | false}
Update logo size
The value to resize the logo has to be between 60 and 120.
Only available for Pay in Installments
logo-size={logo-size} // (values with a range from 60 to 120)
Update currency position
Move the position of the currency before or after the amount.
Only available for Pay in Installments
currency-position={'before' | 'after'}
Update currency Display
Modify the code of the currency.
Only available for Pay in Installments
currency-display={'symbol' | 'code'}
Theme
Used to change the presentation of the widget
Only available for Pay Later
theme={'primary' | 'variant'}
Updated 17 days ago