Home : OpenEdit SDK : Programming OpenEdit : ECommerce Setup : Store Configuration
Store Configuration
General Settings
<name>Example Store</name>This is the name of the store that will appear on your site.
Ordering Configuration
<coupons enabled="true" />Set this to true if coupons may be used.
<credit-card-type name="Master Card" id="MCARD"/>
<credit-card-type name="Visa" id="VISA"/>
<credit-card-type name="American Express" id="AMEX"/>
<credit-card-type name="Discover" id="DISCOVER"/>
These are the types of credit cards that are accepted.
<tax statecode="OH" rate=".07"/>
This is the sales tax that will be applied to orders.
<uses-po-numbers>true</uses-po-numbers>
If this is true, than a customer may enter a purchase order to number, instead of credit card information, to complete their order.
<uses-bill-me-later>false</uses-bill-me-later>
If this is true, then a customer may request that they be sent an invoice.
<display-terms-conditions>false</display-terms-conditions>
If this is true, and <uses-bill-me-later> is true, then a user must agree to the terms and conditions specified in /store/terms.html
Mail Configuration
Edit your /configuration/store.xml file with these email settings:
<to-address>cburkey@openedit.org</to-address>
This is the address that new orders will be sent to. The e-mail will contain information on the customer and the products ordered, as well as a link to a secure location in the store that has the customer's credit card information.
<from-address>store@einnovation.com</from-address>
This is the address that will appear in the “from” field for e-mails that the store sends.
<email-layout>/store/thanksemail.html</email-layout>
This is the location of the layout for the “thanks” e-mail, that is sent to customers when they place an order.
<order-layout>/store/orderemail.html</order-layout>
This is the location of the “order” e-mail, which is sent to <to-address> when an order is placed.
Shipping Configuration
There are two types of shipping methods, “price based” and “weight based”.Price based shipping uses flat shipping rates that apply for certain ranges of total order costs.
Weight based shipping uses shipping rates that apply for certain ranges of total order weights. These rates may either be flat or calculated based on the weight of the order.
Each shipping method may also have handling charges associated with it, which go inside the tag of the shipping method.
<price-shipping-method id="1" costs="6" description="Standard Delivery" lowerThreshold=”0.00” upperThreshold="199.99">
</price-shipping-method>
This creates a price based method.
The “id” field is a unique identifier for the method.
The “costs” field is the flat rate of that method.
“description” is shown to customers when choosing their shipping method.
“lowerThreshold” is the lower end of the range of order totals that apply to this method.
“upperThreshold” is the upper end of the range of order totals that apply to this method.
Thresholds are optional.
<weight-shipping-method id="2" costs="12" percentageCosts=”1.10” description="3 Day Rush Delivery" lowerThreshold=”0.00” upperThreshold="50.00">
</weight-shipping-method>
This creates a weight based method.
The “id” field is a unique identifier for the method.
The “costs” field is the flat rate that will apply to an order if either percentageCosts is not specified, or if the weight of the order is zero.
The “percentageCosts” field specifies the value that will be multiplied by the total weight of the order to determine the price of shipping.
“lowerThreshold” is the lower end of the range of total order weights that apply to this method.
“upperThreshold” is the upper end of the range of total order weights that apply to this method.
<handling-charge level="A" costs="35" additionalCosts="true" />
This creates a handling charge for a specific shipping method.
The “level” field specifies a unique identifier which individual products may specify to indicate that those products need that level of handling. Each shipping method will then have their own handling charge that is associated with that level of handling.
The “costs” field specifies the flat rate of handling for an item needing this level.
If “additionalCosts” is set to true, then a message is displayed to the user telling them that additional handling costs will be added to their order.
As a final example, your store.xml file may have the following:
<price-shipping-method id="1" costs="6" description="Standard Delivery" lowerThreshold=”0.00” upperThreshold="199.99">
<handling-charge level="A" costs="15" additionalCosts="true" />
<handling-charge level="B" costs="30" additionalCosts="true" />
</price-shipping-method>
<weight-shipping-method id="2" costs="12" percentageCosts=”1.10” description="3 Day Rush Delivery" lowerThreshold=”0.00” upperThreshold="50.00">
<handling-charge level="A" costs="35" additionalCosts="true" />
<handling-charge level="B" costs="60" additionalCosts="true" />
</weight-shipping-method>
<assign-shipping-method>false</assign-shipping-method>
If you only have one shipping method, then set this to true and the one method will be automatically assigned to all customers.