Find a Setting

Settings are used to control much of how the software functions. The search box within the Filter section at the top of the page is the easiest way to find the Setting you'd like to change. Simply type the name into the Search All Fields box and click Submit. This is also a good way to find settings if you're not sure of the name. As a rule, AspDotNetStorefront makes the Setting names as relevant to their function as possible. For instance, if you want to change settings for how product ratings work, a simple search for 'ratings' will return the applicable settings. Settings are also broken down into groups of settings that affect similar functions - ADMIN, GATEWAY, etc. Choosing aSetting Groupfrom the dropdown list will narrow down the list of settings presented to help focus your search.

Edit a Setting

Click a Setting name to edit the setting value.Note that to the left of each setting name, in the Store column, you initially see the word "Default." Each MultiStore installation begins with Settings defined only for a single store. When checking a setting, the software looks to see if there is a store-specific copy of that setting. If so, that value will be used. If not, the software 'falls back' to the default value.

Each setting includes several fields, each described below. Values may be displayed in dropdown menus, radio buttons, or text boxes. Edit the value(s) as desired, then click Save.

Name

The name of the setting; used by the software and cannot be modified.

Value

The setting value - this can either be in a dropdown list, text box, or radio buttons. If multiple stores are in use, options appear to configure the setting differently for each store. When setting values vary by store, a copy of the setting is created with a unique value, and is assigned to each store individually. You can also set the value in the Default for All Stores and the setting will apply to all stores.

Description

A brief description of the setting that will instruct administrators how the setting will be used.

Group

The group classification of the setting, used by the Setting Group filter on the Settings page.

SuperAdmin Only

If set to Yes, only administrators set to SuperAdmin will be permitted to edit the setting.

Value Type

The type of the setting. These should only be used when adding new settings.

Allowed Values

Used by some settings to determine options available for the setting value.

Value Types

Each setting value is assigned a value type. These types allow technical administrators to assign predefined values that are allowable for each Setting (if desired). This allows users who are less familiar with the technical side of the software to easily make changes without risking setting something incorrectly. Typed Settings also reduce the number of accidentally mis-set values (for example entering 'flase' instead of 'false').

The supported setting types are:

Type

Description

String

String values can be any text that you wish, up to 1000 characters. Use this for passwords, URLs, etc

Boolean

Boolean values are for settings which should only ever be true or false.

Integer

Integer settings are used for whole numbers, e.g. inventory limits.

Decimal

Decimal type settings can store decimal numbers. This is a good setting to use for settings involving dollar amounts.

Double

This is a good type to use for numerical values that may be set very high.

Enumeration

Enumeration settings have a list of allowable values, which the admin can set once and then choose from later. Only one value can be selected at a time.

Multi-Select

These types of settings enable administrators to set a list of allowable values, but multiple choices can be selected. A good example would be payment methods that are allowed.

Dynamic Invoke

This type of settings pulls from values set in the code. This type can only be used along with some development work.

Add a New Setting

To create a new setting, click the Add Setting button from the Settings page.

Simply fill in the Name, Description, and Value, then assign a Group, and set the Value Type if necessary. When finished, clickSave. Additional development work may be necessary for your new Setting to have any effect on store operation.

Allowed Values

Appropriate for the following value types: Enumeration, Multi-Select, Dynamic Invoke.
Make this a comma separated list (or, for Dynamic Invoke ... well, if you're smart enough to be using this feature, you can most likely figure the rest out for yourself.)