The following section lists each of the settings that can be configured within Cartridge. Each setting is registered using the mezzanine.conf module which is discussed in Mezzanine’s Configuration.
Cartridge defines the following settings:
Sequence of available credit card types for payment.
Default: (u'Mastercard', u'Visa', u'Diners', u'Amex')
If True, users must create a login for the checkout process.
Default: False
Dotted path to the Form class to be used at checkout.
Default: u'cartridge.shop.forms.OrderForm'
If True, the checkout process has a final confirmation step before completion.
Default: True
If True, the checkout process is split into separate billing/shipping and payment steps.
Default: True
Controls the formatting of monetary values according to the locale module in the python standard library. If an empty string is used, will fall back to the system’s locale.
Default: u''
Default cost of shipping when no custom shipping is implemented.
Default: 10.0
Discount codes can be entered on the first checkout step.
Default: True
Dotted package path and class name of the function called upon submission of the billing/shipping checkout step. This is where shipping calculations can be performed and set using the function cartridge.shop.utils.set_shipping.
Default: u'cartridge.shop.checkout.default_billship_handler'
Dotted package path and class name of the function that is called once an order is successful and all of the order object’s data has been created. This is where any custom order processing should be implemented.
Default: u'cartridge.shop.checkout.default_order_handler'
Dotted package path and class name of the function that is called upon submission of the payment checkout step. This is where integration with a payment gateway should be implemented.
Default: u'cartridge.shop.checkout.default_payment_handler'
Dotted package path and class name of the function called upon submission of the billing/shipping checkout step. This is where tax calculations can be performed and set using the function cartridge.shop.utils.set_tax.
Default: u'cartridge.shop.checkout.default_tax_handler'
Sequence of indexes from the SHOP_OPTION_TYPE_CHOICES setting that control how the options should be ordered in the admin, eg given the default for SHOP_OPTION_ADMIN_ORDER, to order by Colour then Size we’d use (2, 1)
Default: ()
Sequence of value/name pairs for types of product options (e.g. Size, Colour).
Default: ((1, u'Size'), (2, u'Colour'))
Subject to be used when sending the order receipt email.
Default: u'Order Receipt'
Email address from which order receipts should be emailed.
Default: [dynamic]
Sequence of value/name pairs for order statuses.
Default: ((1, u'Unprocessed'), (2, u'Processed'))
If False, there is no payment step on the checkout process.
Default: True
Sequence of description/field+direction pairs defining the options available for sorting a list of products.
Default: ((u'Recently added', u'-date_added'), (u'Highest rated', u'-rating_average'), (u'Least expensive', u'unit_price'), (u'Most expensive', u'-unit_price'))