Bison’s configuration file can be found in
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.
- 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 used in payment gateway.
- The folder which contains your product entries.
If your products are located in multiple folders, you can use an array.
- The field to determine the products’ uniqueness. (title, url, or a custom field like sku for example)
- The field name of the prices in your products
- The field name of the product options / price modifiers
- Tax applied to cart (percentage)
- Do product prices include tax?
truewill not add tax to the cart total.
- Field name for overriding the tax rate on a product level
- Field name for flagging a product as tax-free
- Do you want to allow customers to enter a tax number (ie. VAT)?
- How should the tax number be validated? (ie. A ensure
tax_numberis a valid VAT number)
- Should shipping be taxed?
- Should discounts be included in the tax calculations?
- Shipping calculation method. More info.
- Payment Gateway handle. Gateway specific settings can be found in the Gateways section.
- Orders can be saved to file
- Location (from root) to save orders
- Filename - if you plan on displaying on the frontend, use md.
- A string prepended to the start of the order ID
- A string appended to the end of the order ID
- 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.
- 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)
- The email handler used to send any emails. By default, PHP Mail will be used, but Bison can integrate with the following services:
Each service requires your own account and an API key.
- If you are using an email service, your API key goes here.
- This is an array that contains each email’s settings. More info.
- Location (from root) to find discounts
- Location (from root) to find coupons
- Whether to create members at checkout. More info
- Whether or not to clear the customer’s details from session at checkout
- An array containing your control Panel specific options. More info
Problem with this page? Edit it on Github.