Configuration

Here is a list of all the configuration options that are available in Spree.

| Configuration Key | Description | Default Value | |------------------------------------|-------------------------------------------------------------------------------------------------------|---------------------| | allow_checkout_on_gateway_error | Continues the checkout process even if the payment gateway error failed. | false | | address_requires_phone | Determines whether a phone number is required for Addresses. | false | | alternative_shipping_phone | Determines if an alternative phone number should be present for the shipping address on the checkout page. | false | | always_include_confirm_step | Determines if the confirmation step is always included in the checkout process, regardless of the payment method. | false | | auto_capture | Depending on whether or not Spree is configured to "auto capture" the credit card, either a purchase or an authorize operation will be performed on the card (via the current credit card gateway). | true | | auto_capture_on_dispatch | Captures payment for each shipment in Shipment#after_ship callback, and makes Shipment.ready when payment authorized. | false | | company | Determines whether or not a field for "Company" displays on the address form. | false | | credit_to_new_allocation | Determines if a new allocation is created anytime store credit is added. If not set, it will update the store credit's amount in place. | false | | disable_sku_validation | Determines if the built-in SKU uniqueness validation is disabled. | false | | disable_store_presence_validation | Determines if Store presence validation for Products and Payment Methods is disabled. | false | | expedited_exchanges | Determines if an exchange shipment is kicked off upon return authorization save. Requires payment profiles to be supported on your gateway and a configured delayed job handler. | false | | expedited_exchanges_days_window | The number of days the customer has to return their item after the expedited exchange is shipped to avoid being charged. | 14 | | restock_inventory | Determines if inventory should be restocked when an order is canceled or returned | true | | return_eligibility_number_of_days | The number of days after purchase within which a return can be initiated. | 365 | | show_products_without_price | Determines if products without a price are shown in the storefront and Storefront API | false | | tax_using_ship_address | Determines if tax information should be based on shipping address, rather than the billing address. | true | | track_inventory_levels | Determines if inventory levels should be tracked when products are purchased at checkout. This option causes new InventoryUnit objects to be created when a product is bought. | true |

Spree Initializer

To change values for these preferences, you need to edit your config/initializers/spree.rb file.

For example, to disable the expedited_exchanges feature, you would add the following line:

Spree.config do |config|
  config.expedited_exchanges = false
end

Accessing Configuration

To access these preferences in your application, you can use the Spree::Config module. For example, to access the expedited_exchanges preference, you can do the following:

Spree::Config.expedited_exchanges

This will return the current value of the expedited_exchanges preference. You can also set the value of a preference using the Spree::Config module. For example, to set the expedited_exchanges preference to true, you can do the following:

Spree::Config.expedited_exchanges = true

This will set the expedited_exchanges preference to true for the current process. After restarting the Rails server, the preference will return to the default value or the one set in the initializer.