Class: Spree::AppConfiguration

Inherits:
Preferences::Configuration show all
Defined in:
app/models/spree/app_configuration.rb

Constant Summary collapse

DEPRECATED_STORE_PREFERENCES =

all the following can be deprecated when store prefs are no longer supported

{
  site_name: :name,
  site_url: :url,
  default_meta_description: :meta_description,
  default_meta_keywords: :meta_keywords,
  default_seo_title: :seo_title,
}

Instance Attribute Summary collapse

Attributes inherited from Preferences::Configuration

#preference_store

Instance Method Summary collapse

Methods inherited from Preferences::Configuration

#configure, preference, #reset, #set, #use_static_preferences!

Methods included from Preferences::Preferable

#default_preferences, #defined_preferences, #get_preference, #has_preference!, #has_preference?, #preference_default, #preference_type, #set_preference

Instance Attribute Details

#address_requires_state ⇒ Boolean

Returns should state/state_name be required.

Returns:

  • (Boolean) —

    should state/state_name be required



27
 
# File 'app/models/spree/app_configuration.rb', line 27

preference :address_requires_state, :boolean, default: true

#admin_interface_logo ⇒ String

Returns URL of logo used in admin (default: ‘logo/solidus_logo.png’).

Returns:

  • (String) —

    URL of logo used in admin (default: ‘logo/solidus_logo.png’)



31
 
# File 'app/models/spree/app_configuration.rb', line 31

preference :admin_interface_logo, :string, default: 'logo/solidus_logo.png'

#admin_products_per_page ⇒ Integer

Returns Number of products to display in admin (default: 10).

Returns:

  • (Integer) —

    Number of products to display in admin (default: 10)



35
 
# File 'app/models/spree/app_configuration.rb', line 35

preference :admin_products_per_page, :integer, default: 10

#admin_variants_per_page ⇒ Integer

Returns Number of variants to display in admin (default: 20).

Returns:

  • (Integer) —

    Number of variants to display in admin (default: 20)



39
 
# File 'app/models/spree/app_configuration.rb', line 39

preference :admin_variants_per_page, :integer, default: 20

#allow_checkout_on_gateway_error ⇒ Boolean

Returns Allow checkout to complete after a failed payment (default: false).

Returns:

  • (Boolean) —

    Allow checkout to complete after a failed payment (default: false)



43
 
# File 'app/models/spree/app_configuration.rb', line 43

preference :allow_checkout_on_gateway_error, :boolean, default: false

#allow_guest_checkout ⇒ Boolean

Returns When false, customers must create an account to complete an order (default: true).

Returns:

  • (Boolean) —

    When false, customers must create an account to complete an order (default: true)



47
 
# File 'app/models/spree/app_configuration.rb', line 47

preference :allow_guest_checkout, :boolean, default: true

#allow_return_item_amount_editing ⇒ Boolean

Returns Determines whether an admin is allowed to change a return item’s pre-calculated amount (default: false).

Returns:

  • (Boolean) —

    Determines whether an admin is allowed to change a return item’s pre-calculated amount (default: false)



51
 
# File 'app/models/spree/app_configuration.rb', line 51

preference :allow_return_item_amount_editing, :boolean, default: false

#alternative_billing_phone ⇒ Boolean

Returns Request an extra phone number for bill address (default: false).

Returns:

  • (Boolean) —

    Request an extra phone number for bill address (default: false)



55
 
# File 'app/models/spree/app_configuration.rb', line 55

preference :alternative_billing_phone, :boolean, default: false

#alternative_shipping_phone ⇒ Boolean

Returns Request an extra phone number for shipping address (default: false).

Returns:

  • (Boolean) —

    Request an extra phone number for shipping address (default: false)



59
 
# File 'app/models/spree/app_configuration.rb', line 59

preference :alternative_shipping_phone, :boolean, default: false

#always_put_site_name_in_title ⇒ Boolean

Returns When true, site name is always appended to titles on the frontend (default: true).

Returns:

  • (Boolean) —

    When true, site name is always appended to titles on the frontend (default: true)



63
 
# File 'app/models/spree/app_configuration.rb', line 63

preference :always_put_site_name_in_title, :boolean, default: true

#auto_capture ⇒ Boolean

Note:

Setting this to true is not recommended. Performing an authorize and later capture has far superior error handing. VISA and MasterCard also require that shipments are sent within a certain time of the card being charged.

Returns Perform a sale/purchase transaction at checkout instead of a authorize and capture.

Returns:

  • (Boolean) —

    Perform a sale/purchase transaction at checkout instead of a authorize and capture.



71
 
# File 'app/models/spree/app_configuration.rb', line 71

preference :auto_capture, :boolean, default: false

#auto_capture_exchanges ⇒ Boolean

Returns automatically capture the credit card (as opposed to just authorize and capture later) (default: false).

Returns:

  • (Boolean) —

    automatically capture the credit card (as opposed to just authorize and capture later) (default: false)



75
 
# File 'app/models/spree/app_configuration.rb', line 75

preference :auto_capture_exchanges, :boolean, default: false

#binary_inventory_cache ⇒ Boolean

Only invalidate product caches when they change from in stock to out of stock. By default, caches are invalidated on any change of inventory quantity. Setting this to true should make operations on inventory faster. (default: false)

Returns:

  • (Boolean) 


84
 
# File 'app/models/spree/app_configuration.rb', line 84

preference :binary_inventory_cache, :boolean, default: false

#checkout_zone ⇒ String

Returns Name of a Zone, which limits available countries to those included in that zone. (default: nil).

Returns:

  • (String) —

    Name of a Zone, which limits available countries to those included in that zone. (default: nil)



88
 
# File 'app/models/spree/app_configuration.rb', line 88

preference :checkout_zone, :string, default: nil

#company ⇒ Boolean

Returns Request company field for billing and shipping addresses. (default: false).

Returns:

  • (Boolean) —

    Request company field for billing and shipping addresses. (default: false)



92
 
# File 'app/models/spree/app_configuration.rb', line 92

preference :company, :boolean, default: false

#create_rma_for_unreturned_exchange ⇒ Boolean

Returns allows rma to be created for items after unreturned exchange charge has been made (default: false).

Returns:

  • (Boolean) —

    allows rma to be created for items after unreturned exchange charge has been made (default: false)



96
 
# File 'app/models/spree/app_configuration.rb', line 96

preference :create_rma_for_unreturned_exchange, :boolean, default: false

#credit_to_new_allocation ⇒ Boolean

Returns Creates a new allocation anytime StoreCredit#credit is called.

Returns:



225
 
# File 'app/models/spree/app_configuration.rb', line 225

preference :credit_to_new_allocation, :boolean, default: false

#currency ⇒ String

Currency to use by default when not defined on the site (default: “USD”)

Returns:

  • (String) —

    ISO 4217 Three letter currency code



101
 
# File 'app/models/spree/app_configuration.rb', line 101

preference :currency, :string, default: "USD"

#customer_returns_per_page ⇒ Integer

Returns Customer returns to show per-page in the admin (default: 15).

Returns:

  • (Integer) —

    Customer returns to show per-page in the admin (default: 15)



166
 
# File 'app/models/spree/app_configuration.rb', line 166

preference :customer_returns_per_page, :integer, default: 15

#default_country_id ⇒ Integer?

Deprecated.

Returns id of Country to be selected by default in dropdowns (default: nil).

Returns:

  • (Integer, nil) —

    id of Country to be selected by default in dropdowns (default: nil)



106
 
# File 'app/models/spree/app_configuration.rb', line 106

preference :default_country_id, :integer

#expedited_exchanges ⇒ Boolean

Note:

this requires payment profiles to be supported on your gateway of choice as well as a delayed job handler to be configured with activejob.

Kicks off an exchange shipment upon return authorization save. charge customer if they do not return items within timely manner.

Returns:

  • (Boolean) —

    Use expidited exchanges (default: false)



115
 
# File 'app/models/spree/app_configuration.rb', line 115

preference :expedited_exchanges, :boolean, default: false

#expedited_exchanges_days_window ⇒ Integer

Returns Number of days the customer has to return their item after the expedited exchange is shipped in order to avoid being charged (default: 14).

Returns:

  • (Integer) —

    Number of days the customer has to return their item after the expedited exchange is shipped in order to avoid being charged (default: 14)



121
 
# File 'app/models/spree/app_configuration.rb', line 121

preference :expedited_exchanges_days_window, :integer, default: 14

#layout ⇒ String

Returns template to use for layout on the frontend (default: “spree/layouts/spree_application”).

Returns:

  • (String) —

    template to use for layout on the frontend (default: “spree/layouts/spree_application”)



125
 
# File 'app/models/spree/app_configuration.rb', line 125

preference :layout, :string, default: 'spree/layouts/spree_application'

#logo ⇒ String

Returns URL of logo used on frontend (default: ‘logo/solidus_logo.png’).

Returns:

  • (String) —

    URL of logo used on frontend (default: ‘logo/solidus_logo.png’)



129
 
# File 'app/models/spree/app_configuration.rb', line 129

preference :logo, :string, default: 'logo/solidus_logo.png'

#mails_from ⇒ String

Returns Email address used as From: field in transactional emails.

Returns:

  • (String) —

    Email address used as From: field in transactional emails.



219
 
# File 'app/models/spree/app_configuration.rb', line 219

preference :mails_from, :string, :default => '[email protected]'

#max_level_in_taxons_menu ⇒ Integer

Returns maximum nesting level in taxons menu (default: 1).

Returns:

  • (Integer) —

    maximum nesting level in taxons menu (default: 1)



142
 
# File 'app/models/spree/app_configuration.rb', line 142

preference :max_level_in_taxons_menu, :integer, default: 1

#order_bill_address_used ⇒ Boolean

bill addresses on payment sources. (default: true)

Returns:

  • (Boolean) —

    Use the order’s bill address, as opposed to storing



134
 
# File 'app/models/spree/app_configuration.rb', line 134

preference :order_bill_address_used, :boolean, default: true

#order_capturing_time_window ⇒ Integer

Returns the number of days to look back for fully-shipped/cancelled orders in order to charge for them.

Returns:

  • (Integer) —

    the number of days to look back for fully-shipped/cancelled orders in order to charge for them



138
 
# File 'app/models/spree/app_configuration.rb', line 138

preference :order_capturing_time_window, :integer, default: 14

#order_mutex_max_age ⇒ Integer

Returns Max age of OrderMutex in seconds (default: 2 minutes).

Returns:

  • (Integer) —

    Max age of OrderMutex in seconds (default: 2 minutes)



146
 
# File 'app/models/spree/app_configuration.rb', line 146

preference :order_mutex_max_age, :integer, default: 120

#orders_per_page ⇒ Integer

Returns Orders to show per-page in the admin (default: 15).

Returns:

  • (Integer) —

    Orders to show per-page in the admin (default: 15)



150
 
# File 'app/models/spree/app_configuration.rb', line 150

preference :orders_per_page, :integer, default: 15

#products_per_page ⇒ Integer

Returns Products to show per-page in the frontend (default: 12).

Returns:

  • (Integer) —

    Products to show per-page in the frontend (default: 12)



158
 
# File 'app/models/spree/app_configuration.rb', line 158

preference :products_per_page, :integer, default: 12

#promotions_per_page ⇒ Integer

Returns Promotions to show per-page in the admin (default: 15).

Returns:

  • (Integer) —

    Promotions to show per-page in the admin (default: 15)



162
 
# File 'app/models/spree/app_configuration.rb', line 162

preference :promotions_per_page, :integer, default: 15

#properties_per_page ⇒ Integer

Returns Properties to show per-page in the admin (default: 15).

Returns:

  • (Integer) —

    Properties to show per-page in the admin (default: 15)



154
 
# File 'app/models/spree/app_configuration.rb', line 154

preference :properties_per_page, :integer, default: 15

#require_master_price ⇒ Boolean

Returns Require a price on the master variant of a product (default: true).

Returns:

  • (Boolean) —

    Require a price on the master variant of a product (default: true)



170
 
# File 'app/models/spree/app_configuration.rb', line 170

preference :require_master_price, :boolean, default: true

#require_payment_to_ship ⇒ Boolean

Returns Allows shipments to be ready to ship regardless of the order being paid if false (default: true).

Returns:

  • (Boolean) —

    Allows shipments to be ready to ship regardless of the order being paid if false (default: true)



174
 
# File 'app/models/spree/app_configuration.rb', line 174

preference :require_payment_to_ship, :boolean, default: true

#return_eligibility_number_of_days ⇒ Integer

Returns default: 365.

Returns:

  • (Integer) —

    default: 365



178
 
# File 'app/models/spree/app_configuration.rb', line 178

preference :return_eligibility_number_of_days, :integer, default: 365

#searcher_class ⇒ Object 



229
230
231
 
# File 'app/models/spree/app_configuration.rb', line 229

def searcher_class
  @searcher_class ||= Spree::Core::Search::Base
end

#send_core_emails ⇒ Boolean

Returns Whether to send transactional emails (default: true).

Returns:

  • (Boolean) —

    Whether to send transactional emails (default: true)



215
 
# File 'app/models/spree/app_configuration.rb', line 215

preference :send_core_emails, :boolean, default: true

#shipping_instructions ⇒ Boolean

Returns Request instructions/info for shipping (default: false).

Returns:

  • (Boolean) —

    Request instructions/info for shipping (default: false)



182
 
# File 'app/models/spree/app_configuration.rb', line 182

preference :shipping_instructions, :boolean, default: false

#show_only_complete_orders_by_default ⇒ Boolean

Returns Only show completed orders by default in the admin (default: true).

Returns:

  • (Boolean) —

    Only show completed orders by default in the admin (default: true)



186
 
# File 'app/models/spree/app_configuration.rb', line 186

preference :show_only_complete_orders_by_default, :boolean, default: true

#show_products_without_price ⇒ Boolean

Returns Whether products without a price are visible in the frontend (default: false).

Returns:

  • (Boolean) —

    Whether products without a price are visible in the frontend (default: false)



194
 
# File 'app/models/spree/app_configuration.rb', line 194

preference :show_products_without_price, :boolean, default: false

#show_raw_product_description ⇒ Boolean

Returns Don’t escape HTML of product descriptions. (default: false).

Returns:

  • (Boolean) —

    Don’t escape HTML of product descriptions. (default: false)



198
 
# File 'app/models/spree/app_configuration.rb', line 198

preference :show_raw_product_description, :boolean, :default => false

#show_variant_full_price ⇒ Boolean

Returns Displays variant full price or difference with product price. (default: false).

Returns:

  • (Boolean) —

    Displays variant full price or difference with product price. (default: false)



190
 
# File 'app/models/spree/app_configuration.rb', line 190

preference :show_variant_full_price, :boolean, default: false

#tax_using_ship_address ⇒ Boolean

Returns Use the shipping address rather than the billing address to determine tax (default: true).

Returns:

  • (Boolean) —

    Use the shipping address rather than the billing address to determine tax (default: true)



202
 
# File 'app/models/spree/app_configuration.rb', line 202

preference :tax_using_ship_address, :boolean, default: true

#track_inventory_levels ⇒ Object

Determines whether to track on_hand values for variants / products. If you do not track inventory, or have effectively unlimited inventory for all products you can turn this on.

Returns:

  • Track on_hand values for variants / products. (default: true)



209
 
# File 'app/models/spree/app_configuration.rb', line 209

preference :track_inventory_levels, :boolean, default: true

Instance Method Details

#static_model_preferences ⇒ Object 



233
234
235
 
# File 'app/models/spree/app_configuration.rb', line 233

def static_model_preferences
  @static_model_preferences ||= Spree::Preferences::StaticModelPreferences.new
end