EPiStore Configuration

Transcription

1 EPiStore Configuration Product version: 2.3 Document version: 1.0 Document creation date Document last saved: Purpose This technical note provides information on how to set up and configure EPiStore and also gives a basic understanding on how the session object in the.net Framework works. TECHNICAL NOTE

2 2 EPiStore Configuration Table of Contents INTRODUCTION 2 REQUIREMENTS 2 CONFIGURING EPISTORE 3 ITEM ATTRIBUTES 4 THE.NET SESSION OBJECT 4 Introduction EPiStore is an e-shopping module, built on the.net Framework, with integrated shopping carts for EPiServer CMS. The main purpose of this module is to act as a simple e-shopping solution, where the customer can browse items and add them to his personal shopping cart. Users can browse and add items to the cart without having to identify themselves, although the sample solution included in the shop requires identification before the user can actually place an order. EPiStore has two separate parts: the core that handles the shopping cart and the database transactions, and a sample solution. The shop is very flexible as most of the logic is contained in the code-behind classes in the sample solution. Requirements System Requirements EPiStore requires an installation of EPiServer CMS 5 SP1 or later and the system requirements are the same as for EPiServer CMS 5. License Requirements You need an EPiStore license to enable the EPiStore functions. Most of the store can be used for testing purposes without a valid license, but placing an order will require a valid license. The status of your license can be seen in the Shop settings page in Admin mode. You can create a demo license and place orders for licenses at

3 Configuring EPiStore 3 Configuring EPiStore The first step after installation is normally to configure the EPiStore installation. This is done in the Dynamic Properties for your store. The values in the table below can be stated. Note that the start page and search page cannot be stated until they have been created in the structure. Root page for EPiStore Search page for the store Show price in store? Short currency Long currency Page type for shop items Search path to attribute file Checkout sender Checkout subject Checkout text Delivery sender Delivery subject Delivery text Links to your EPiStore root page. Links to the EPiStore search page. Indicates whether you want to show prices in the store. Short currency, for example, $, kr. Long currency, for example, dollar, kronor. Enter the template to be used for products. Search path for attribute file. This is an advanced option that is described later in this document. From address for the checkout confirmation . Subject for the checkout confirmation . text that will be sent as checkout confirmation. From address for the delivery confirmation . Subject for the delivery confirmation . text that will be sent as delivery confirmation.

4 4 EPiStore Configuration Item Attributes Items in EPiStore can be configured to enable the customer to specify additional settings when ordering the item. For example, the item sweatshirt may be ordered in different sizes and colors. For this you only have to create one item and an attribute file that specifies the options for this item. You can either specify the attribute file by the property EPiStoreItemAttributeFilepath on the item page or as a dynamic property. If this property has no value or the file does not exist, EPiStore will try to find an XML file with the name of the item page type in the shopping/itemattributes/ folder. Here is an example of an attribute file: <?xml version="1.0" encoding="utf-8" standalone="yes"?> <attributes> <attribute name="size" defaultvalue="0"> </attribute> <option name="small" value="0" /> <option name="medium" value="1" /> <option name="large" value="2" /> <option name="x-large" value="3" /> <attribute name="color" defaultvalue="1"> </attribute> </attributes> <option name="black" value="0" /> <option name="green" value="1" /> <option name="yellow" value="2" /> Note Each option has both name and value. This makes it possible to change the name in the XML file without affecting saved orders. The default value setting is used when putting an item in the shopping cart without specifying any attributes. The.NET Session Object EPiStore uses the session object in the.net Framework to store the shopping cart. The session object can use different forms of session-state storing. The options are: In process - the information is kept within the ASP.NET process. No additional setup is needed to use this option. Out of process the information is handled by a Windows NT service. The service has to be installed on the Web server for this option. SQL Server the information is stored in an SQL Server. The.NET Framework provides a script (state.sql) for installing the required database on the SQL Server. This script will use the temporary database in the SQL Server and therefore not fully support the persistence of data. A new script is available from Microsoft to fully take advantage of the data persistence of this option. For more information about this, see Microsoft KB ( This store has been tested with In process during early development and SQL Server mode under beta testing. We recommend using the SQL Server mode as it will ensure very good data persistence. The SQL Server mode can handle the following scenarios without losing data: The database server is restarted. SQL Server service is restarted.

5 The.NET Session Object 5 ASP.NET process is restarted. Internet Information Service is restarted. Web server is restarted. This option will enable the user to maintain his shopping cart as long as he does not close his browser window group. The shop has been tested using cookies, which is the default option for the session state and this is currently the supported mode. Copyright EPiServer AB. EPiServer is a registered trademark of EPiServer AB. Other product and company names mentioned in this document may be the trademarks of their respective owners. The document may be freely distributed in its entirety, either digitally or in printed format, to all EPiServer users. Changes to the content or partial copying of the content may not be carried out without permission from EPiServer AB: EPiServer AB Finlandsgatan 38 SE Kista Sweden Changes are periodically made to the document and these will be published in new editions of the document. EPiServer AB reserves the right to improve or change the products or programs included in this document at any time.