Settings
Bison’s configuration file can be found in /_config/add-ons/bison/bison.yaml.
It provides a number of sensible defaults (shown below the descriptions) but there are also some settings you will need to tend to before beginning.
Options
encryption_key
Required- Used to encrypt and decrypt data. You should set this to a strong 32 character passphrase. You can use an app like 1Password to generate one.
currency- Currency used in payment gateway.
USD product_folder- The folder which contains your product entries.
If your products are located in multiple folders, you can use an array.
eg.['products', 'things']
products unique_field- The field to determine the products’ uniqueness. (title, url, or a custom field like sku for example)
title price_field- The field name of the prices in your products
price option_field- The field name of the product options / price modifiers
options tax_rate- Tax applied to cart (percentage)
0 tax_inclusive- Do product prices include tax?
truewill not add tax to the cart total.falsewill.
false tax_rate_field- Field name for overriding the tax rate on a product level
tax_rate tax_free_field- Field name for flagging a product as tax-free
tax_free enable_tax_number_field- Do you want to allow customers to enter a tax number (ie. VAT)?
false tax_number_validation:- How should the tax number be validated? (ie. A ensure
tax_numberis a valid VAT number)
vat shipping_taxable- Should shipping be taxed?
false discounts_taxable- Should discounts be included in the tax calculations?
true shipping_method- Shipping calculation method. More info.
payment_gateway
Required- Payment Gateway handle. Gateway specific settings can be found in the Gateways section.
order_save_to_file- Orders can be saved to file
true order_save_path- Location (from root) to save orders
_content/orders/ order_extension- Filename - if you plan on displaying on the frontend, use md.
md order_id_prefix- A string prepended to the start of the order ID
order_id_suffix- A string appended to the end of the order ID
order_statuses- An array of statuses you want to use for your orders. The first in the list will be the default. It can either be key/value pairs of name/label, eg.
paid: Paid; or a regular list, eg.- paid.
paid order_status_colors- The colors used in the control panel (but you can also use them in your templates with the order_status tag). This should be a key/value pairing of order statuses and colors. They can be any valid CSS color (hex, rgb, etc)
paid: green email_handler- The email handler used to send any emails. By default, PHP Mail will be used, but Bison can integrate with the following services:
mandrill,mailgun,postmarkandsendgrid
Each service requires your own account and an API key. email_handler_key- If you are using an email service, your API key goes here.
emails- This is an array that contains each email’s settings. More info.
discounts_folder- Location (from root) to find discounts
_content/discounts coupons_folder- Location (from root) to find coupons
_content/discounts create_members- Whether to create members at checkout. More info
clear_customer_details- Whether or not to clear the customer’s details from session at checkout
false control_panel- An array containing your control Panel specific options. More info
Problem with this page? Edit it on Github.