E2V - Fast. Reliable. Scaleable.

Store Controller

The Store Controller must be rezzed on each region where you have a store. This allows you to have different settings, depending on the store location. Or, you can easily copy the settings note card from your main store, and use it in the Store Controllers of your satellite stores as well.

The Store Controller's settings note card contains the options for your store.

The note card is roughly divided up into 5 sections: Defaults, Partners, Splits, Sales, and Price Groups. For example:

# Defaults
N-Reward=2%
G-Reward=5%

# Partners
Partner=

# Splits
Split=

# Sales
Sale=
ExcludedGroups=
SpendCreditDuringSale=false
EarnCreditDuringSale=false

# Price Groups
PriceGroup=one,50
PriceGroup=two,100

Defaults section

N-Reward specifies the default non-group buyer's reward value to be used for each vendor, if the value is not specified either on the vendor, or in the vendor's price group. This value can be either a percentage (if you include the % sign) or an absolute value. Leave this blank, or use a 0, to prevent any default value from being used.

G-Reward specifies the default buyer's reward value to be used for each vendor when the customer has the same group tag active that the vendor object is set to, if the value is not specified either on the vendor, or in the vendor's price group. This value can be either a percentage (if you include the % sign) or an absolute value.

Partners section

If you are using a Partner Connection (separate product), then you need to inform the system about each authorized partner, by listing their avatar keys, one per Partner= line.

See the Store Partners topic for more information.

Splits section

Each Split= line defines one split scheme that is available to be used by your vendors.

Please see the article on Splits for more information on using splits.

Sales

You can place the entire store on sale by putting either a percentage or a flat amount into the Sale field. Once the settings are saved and loaded, the controller will restart all the vendors, and they will take on the sale pricing.

You can exclude certain pricing group (see below) from the store-wide sale by adding their names, separated by commas, to the ExcludedGroups line.

The SpendCreditDuringSale option controls whether customers will be able to to buy on-sale items using their store credit or not. Put "true" or "false." Note that vendors in groups that are excluded from the sale are not affected by this setting.

The EarnCreditDuringSale options control how buyer's rewards behave during the sale. Use "false" to prevent on-sale vendors from issuing buyer's rewards.

Price Groups

The price groups feature allows you to define a single set of vendor options, in one place, and then use those options on as many different vendors as you want. If the options ever need to change, you don't have to visit each vendor in the group, you can simply make changes to the group itself, and all vendors in that group will be updated automatically.

You can also put specific groups on sale simply by changing their prices, which the rest of the store remains unchanged.

Each group is defined on a PriceGroup= line, and consists of at least two items: the name of the group, and the price of the group. You can also specify buyer's reward values on the group, by adding them after the group's price.

Omitting vs zeros
When you don't supply a value for buyer's rewards, you are indicating that you want to use the default values (if they exist). Leaving them blank is not the same thing as using explict 0's. For example:

N-Reward=2%
G-Reward=10%

PriceGroup=socks,100
PriceGroup=shoes,100,,8%
PriceGroup=pants,100,0
PriceGroup=shirts,100,0,0

The above settings will result in the following values:

  • socks ... n-reward: L$2, g-reward: L$10
  • shoes ... n-reward: L$2, g-reward: L$8
  • pants ... n-reward: L$0, g-reward: L$10
  • shirts ... n-reward: L$0, g-reward: L$0

 

Following the buyer's reward values (or "empty" commas), you can put a comma separated list of split scheme names you'd like to apply to the group. E.g.:

PriceGroup=socks,100,,,mgr,rent

Note that there's one "empty" comma for the n-reward value, then another for the g-reward value (meaning both fall back to the default values), followed by the split name(s).