Config widgets.Expand panels to view the topic details, guides & instructions. This tutorial comes with videos to help guide users for further understanding & speed up installation process.
Use only what you need!
Add parameters in any order but only to the assigned Config Widget.
Click
PreviousAdd parameters in any order but only to the assigned Config Widget.
Click
View Dashboard to view the Config Widget locations. Install TemplateNext
Theme Personalisation
3.0 Store Set-ups
Store currency.
Quickly set-up your store currency with shopping cart pre-sets or custom currency of choice.
Quickly set-up your store currency with shopping cart pre-sets or custom currency of choice.
3.1 Currency
The required parameters & values to activate your store currency as follows:-
| Location | Store Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Values |
|---|---|---|---|
| currency_code | text/string | A 3 letter international currency code. ie USD, MYR, VND, GBR etc.This 3 letter international codes are pre-sets with the shopping cart plug-in pre-installed with theme. Find further below the detail currency code pre-sets that can be used in chart below. | USD |
If your currency is not listed as presets or you require to customise the pre-set currency, the set-up as follows:-
| Location | Store Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| currency_method | custom | Required to activate a custom currency. Add a value of custom to activate the custom currency for your shopping cart. | none |
| currency_code | text/string | A 3 letter international currency code. ie USD, MYR, VND, GBR etc.This 3 letter international codes are pre-sets with the shopping cart plug-in pre-installed with theme. Find further below the detail currency code pre-sets that is made available. | USD |
| currency_name | text/string | International currency name | US Dollar |
| currency_symbol | text/string/hex symbol | Currency symbol to display at shopping cart. Text/integer or hex currency code symbol are allowed & will display at shopping cart (depends on browser support) | $ (US Dollar sign) |
| currency_delimiter | text/string | A delimiter to display for prices to separate by thousands. | , (comma) |
| currency_decimal | text/string | A decimal point to display at prices following the cents. | . (dot) |
| currency_accuracy | number/integer | The accuracy to calculate prices & shopping cart totals which includes tax & shipping. | 2 |
Currency Pre-sets Chart
* Available pre-set currencies * Currencies supported by Paypal * Ref: https://developer.paypal.com/docs/classic/api/currency_codes/ code: "USD" "US Dollar", code: "AUD", "Australian Dollar", code: "BRL", "Brazilian Real", code: "CAD", "Canadian Dollar", code: "CZK", "Czech Koruna", code: "DKK", "Danish Krone", code: "EUR", "Euro", code: "HKD", "Hong Kong Dollar", code: "HUF", "Hungarian Forint", code: "ILS", "Israeli New Sheqel", code: "JPY", "Japanese Yen", code: "MYR", "Ringgit Malaysia", code: "MXN", "Mexican Peso", code: "NOK", "Norwegian Krone", code: "NZD", "New Zealand Dollar", code: "PHP", "Philipine Peso", code: "PLN", "Polish Zloty", code: "GBP", "Pound Sterling", code: "RUB", "Russian Ruble", code: "SGD", "Singapore Dollar", code: "SEK", "Swedish Krona", code: "CHF", "Swiss Franc", code: "TWD", "Taiwan New Dolar", code: "THB", "Thai Baht", code: "TUR", "Turkish Lira", * * Currencies not supported by Paypal but included as pre-sets * code: "BTC", "Bitcoin", code: "INR", "India Rupee", code: "IDR", "Indonesia Rupiah", code: "NGN", "Nigeria Naira", code: "VND", "Vietnam Dong", code: "PKR", "Pakistani Rupee", code: "TKA", "Bangladeshi Taka",
3.2 Currency Rates Setup [Elite Version]
For Elite BlogrCart theme versions allows Blogger stores to set unlimited currency to rates options at checkout. The rate will automatically calculate & display at shopping cart & sent to available checkout options.
| Location | Store Config - to activate currency rates options Currency Options - to insert currency code & rates select options | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| Required to activate at Store Config. | |||
| currency_rates | true or null | Set to true to activate currency rate options at Currency Rates Config widget. | null |
| Required to Set a Currency Option at Currency Options Widget. Example currency options format | |||
| USD_Text to display at currency option Capital case currency code Seperator [REQUIRED] Text to display at currency rate drop down option
| |||
3.3 Shipping Setup
The required parameters & values to activate your store shipping as follows:-| Location | Store Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| Required to activate | |||
| shipping_method | shippingFlatRateshippingQuantityRateshippingTotalRate | A shipping flat rate using a shipping_rate value regardless of quantity in cart.A shipping quantity rate using the cart quantity and multiply the shipping_rate value.Shipping total rate is a percentage based shipping on items total in cart. Refer example below. | null |
| shipping_rate | integer/number | A value to set as a shipping rate. If shipping rate not provided or a value of 0 the shipping container at checkout will not display. | null |
Example setup a
shippingQuantityRate. Say you require 6% of the total amount in cart to add in as shipping charges. So the Parameter & Value to Set at Store Config widget as follows:-6 % equivalent to 6/100 = 0.06.
Enter:-
Link Name field = shippingQuantityRate
Links Field (New Site Url = 0.06
click Add Link.
Store shipping by average weight.
Activate & sett-up unlimited shipping by weight options for your store.
Activate & sett-up unlimited shipping by weight options for your store.
3.4 Shipping Average Weight Setup [Elite Version]
For Elite BlogrCart themes also comes equipped with a shipping custom rate which handles an average weight to value shipping charges via options.
| Location | Store Config - to activate shipping_method Shipping Config - to set shipping options reference. Shipping Options - to map the weight to value for shipping options. | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| Required to activate at Store Config | |||
| shipping_method | shippingCustom | Required to activate with Shipping Config & Shipping Options configuration widgets. Once set & saved, activates shipping by average weight & displays at shipping options at checkout shipping section. shipping_rate will be ignored & all values connected comes from Shipping Options & Shipping Config widget. | null |
| shipping_select_text | text/string | When shippingCustom is activated, the select options default text to display ( the first option ) | Choose a shipping destination |
| Required to set at Shipping Config widget. | |||
| weight_max | number/integer | A maximum weight for a shipping select option. This value equals the last weight value pairing for a Shipping Option. This value format is dedicated with a one decimal point. | null |
| weight_average | number/integer | The average weight value of items at your store. This value will be calculated & referenced with the custom shipping functions. Example 0.25 (for 250 grams if in kg), 0.15 lb - accepts decimal points.This value format is dedicated with a one decimal point. | null |
| weight_metric | text/string | A weight metric to be used for Shipping Options. Example: kg, lb etcThis value is displayed at shipping select options when activated. | null |
| Configuring Shipping Options Widget | |||
| Example shipping options weight to value format at Shipping Options widget | |||
| 0.5=7; 1.0=9; 1.5=12; 2.0=14; 2.5=22;3.0=24; ..... 9.0=56;9.5=59;10.0=61; #starts #occurring #occurring #ends
| |||
3.5 Tax Setup
The required parameters & values to activate your store tax as follows:-| Location | Store Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default value |
|---|---|---|---|
| Required to activate | |||
| tax_rate | integer | A value to set as tax rate for shopping cart. The value entered is percentage based. Example if required 5% for tax rate at your store, then key in 0.05 ( 5/100 ) as the values.This value is auto calculated at shopping cart totals & has options to include or exclude shipping totals. If tax rate not provided or 0, the tax container will not display at checkout. | null |
| More Options | |||
| tax_shipping | true or false | If set to true the tax will be calculated including totals & shipping charges. | false |
3.6 Paypal Setup
The required parameters & values to activate your store Paypal checkout as follows:-
| Location | Store Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| Required to activate If not provided Paypal checkout button will not display at checkout. | |||
| paypal_email | email address | The email address registered at Paypal to receive payments for Paypal checkout at your store. Optional to upgrade your Paypal account to Merchant and the services is free with minimum surcharge. If merchant account has been activated at Paypal, the return url after success or error transactions at Paypal checkout page will be activated for your usage. | null |
| paypal_success_url | url | The url to your store success page. The dedicated page where users will return to when successfully finished transactions at Paypal checkout page. (Refer Section 1.2) | null |
| paypal_error_url | url | The url to your store error page The dedicated page where users return to when transaction at Paypal page is unsuccessful. (Refer Section 1.3) | null |
| More Options | |||
| paypal_sandbox | true or false | A real live test environment for Paypal checkout transactions using demo accounts & demo credit cards. | false |
| paypal_currency_convert | true or false | When set to true activates the currency conversion options when checkout to Paypal.The currency to convert for Paypal checkout must be available as an option at Currency Rates options. | null |
| paypal_currency_to_convert | currency code | A 3 letter Paypal supported currency code. The currency option to convert must be available at Currency Options widget. The currency option to convert must be a pre-set currency with shopping cart plug-in. By default all currencies available to checkout to Paypal has been included. | null |
| paypal_store_logo | url | An image to be displayed at Paypal checkout page above the payment summary. Preferred image size 160px X 60px & will be cropped/re-sized by Paypal checkout page.Preferred image hosted on a secured hosting environment (https:// protocol) Tested using image url's hosted on Blogger image servers & works very well. Very useful to customise how your checkout displayed with your store brand. | null |
3.7 Send Order Email
The required parameters & values to activate your store send order checkout & form as follows:-| Location | Email Config | ||
| Parameter (Name Field) | Values to Set (Links Field) | Description | Default Value |
|---|---|---|---|
| Required to activate If not provided - send order button will not display at checkout. | |||
| my_store_email | email address | The email address receive the send order email notification by users submitting send order form. | null |
| my_store_name | text/string | The name of your store. Displayed as subject on receiving email. | null |
| my_business_name | text/string | Store business name. Displayed at Reply-to email name. | null |
| my_success_url | url | The url to your store success page after users successfully sent orders. (Refer Section 1.2) | null |
| my_error_url | url | The url to your store error page if users sent orders fails. (Refer Section 1.3) | null |
| More Options | |||
| my_address | text/string | Store business address displayed at email body footer. | null |
| my_phone_1 | text/string | Store telephone numbers displayed at email body footer. | null |
| my_note_1 | text/string | Displayed at instructions section at email body line #1. | null |
| my_note_2 | text/string | Displayed at instructions section at email body line #2. | null |
| my_note_3 | text/string | Displayed at instructions section at email body line #3. | null |
| my_note_4 | text/string | Displayed at instructions section at email body line #4 | null |
| my_pay_1 | text/string | Displayed at transactions section at email body line #1 | null |
| my_pay_2 | text/string | Displayed at transactions section at email body line #2 | null |
| my_pay_3 | text/string | Displayed at transactions section at email body line #3 | null |
| More Options | |||
| my_send_shipping_option | true or false | If set to true users shipping options will auto display at email body notification. my_note_1 text above will act as subject to the option selection. | false |
| my_currency_symbol | true or false | Option to allow to display current store currency symbol at email body | false |
| my_new_delimiter | text/string | If set, change the delimiter used at email body prices. | , |
| my_new_decimal | text/string | If set, change the decimal used at email body prices. | . |
| my_new_accuracy | number/integer | If set, the amount of the trailing price calculation. | 2 |
This BlogrCart Theme also comes with troubleshooting helpers. If you feel that the configurations set is not functioning as expected, press F12 on your computer keyboard and view your browser Console Logs.
Have a question or having some trouble?
Send it to us using this theme support page here. Our team members would gladly assist you.[*] Unless otherwise stated in theme/template listings.