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: ('Mastercard', 'Visa', 'Diners', 'Amex')
Number of minutes of inactivity until carts are abandoned.
Enable featured images in shop categories
If True, users must create a login for the checkout process.
If True, the checkout process has a final confirmation step before completion.
If True, the checkout process is split into separate billing/shipping and payment steps.
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 cost of shipping when no custom shipping is implemented.
Discount codes can be entered on the cart page.
Discount codes can be entered on the first checkout step.
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.
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.
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.
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.
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)
Sequence of value/name pairs for types of product options (e.g. Size, Colour).
Default: ((1, 'Size'), (2, 'Colour'))
All order receipts will be BCCd to this address.
Subject to be used when sending the order receipt email.
Default: 'Order Receipt'
Email address from which order receipts should be emailed.
Sequence of value/name pairs for order statuses.
Default: ((1, 'Unprocessed'), (2, 'Processed'))
If False, there is no payment step on the checkout process.
Number of products to display per category page.
Sequence of description/field+direction pairs defining the options available for sorting a list of products.
Default: (('Recently added', '-date_added'), ('Highest rated', '-rating_average'), ('Least expensive', 'unit_price'), ('Most expensive', '-unit_price'))
Show the product rating form, and allow browsing by rating.
Show upsell products in templates, and allow editing them in the admin.
Use product variations.
Show the links to the wishlist, and allow adding products to it.