Setup Wizard

V3.0 Shopping Cart Setup Wizard

The Shopping Cart Setup Wizard screen generates the store configuration information.
ezStore123/MerchantComplete's flexibility resides in the capability to configure many aspects of the system's behavior. This is accomplished through the Setup Wizard.

The screen is divided in 6 to 9 sections depending upon the option selected: Standard (default) or Advanced. The 'Advanced' screen allows definition of rarely used settings.
Each caption also indicates the name of the global variable used by the system. This facilitates manual editing of the configuration file or debugging of configuration issues as necessary.

The wizard generates a configuration file (_sysdefs.asp) in the /ezStore123 folder. It also saves the previous configuration as _sysdefs.bak.

Important Notes:
1. The setup wizard cannot read or write configuration files from versions prior to 2.2.
Configuration files from older versions are however compatible with versions 2.2 and higher.

When the Setup Wizard detects an older version configuration file, it displays a warning message as well as detailed instructions on how to convert the configuration file to Wizard-compatible format. Conversion process involves downloading the previous file and printing it for reference and backup. All configuration data must then be re-entered in the appropriate fields before the new configuration can be saved under the new Wizard-compatible format.
If in doubt about configuration file conversion issues, contact your Service Provider.

2. The configuration file contains additional, system-specific definitions that cannot be accessed using the wizard. System-specific definitions are transparently saved and restored when the wizard is used.

3. Additional definitions can be added to the configuration file. These definitions usually pertain to search catalogs or other custom options and plug-ins.
These additional definitions must be set up and maintained by technical personnel and are not available through the wizard. They are transparently saved and restored when the wizard is used.

4. To help software integrators, the names of the corresponding constant or global variables in _sysdefs.asp appear under the field captions on this screen.

1. Database Connection:

*Field Name*	*Description*
Name of Database Server (or IP) AppDBConn (1)	Enter the DNS name of the database server or its IP address. Example: sql.mySite.com or 192.0.0.10 Note: The SQL Server can be located on the web site server or on a remote server.
Name of SQL Database AppDBConn (2)	Enter the name of your store database in the SQL server.
SQL Login ID for Internet Users AppSafeUser	SQL Login ID of a 'safe' user serving as proxy to web site users. Security tip: do not set this ID as 'sa'.
SQL User Password AppSafePassword	SQL password for the Internet User.

2. System URLs:

*Field Name*	*Description*
Web Site URL AppDomainRoot	Enter the full URL for your web site (eg: http://www.mySite.com).
Store Secure Folder URL AppEZS123SSLRoot	URL for the secure shopping cart folder (eg: https://www.mySite.com/ezStore123/secure).
Index page URL AppHomeForm	Web site index page (eg: http://www.mySite.com/index.htm). The shopping cart will use this information when users click the 'Home' button.
Support Page URL AppSupportURL	Web site support information page.
Default Catalog Page URL AppShopHomeForm	Enter the full URL of the page used as default catalog. Typically one of the built-in catalog pages such as 'DTCatalogList.asp', 'DTProductAtoZList.asp', 'DTClassList.asp'. You may also provide the URL of your custom catalog page if applicable. This is the page web site customers are referred to when they click the 'Keep Shopping' button.
After-Sale Page URL AppAfterSaleForm	Enter the full URL of the page you want the site customers to be sent to after purchasing items from the site (typically, the index page but you may also substitute any custom page). If a custom page is used, it must contain the ezStore123 activation and transaction-state support libraries. These libraries handle page authentication, referrer and coupon recording and other system-level tasks. They are implemented as include files. To enable the ezStore123 activation and transaction-state support library, simply include the following code snippet at the top of your custom page: <!-- #include virtual="/ezStore123/_sysdefs.asp" --> <!-- #include virtual="/ezStore123/_library.asp" --> <!-- #include virtual="/ezStore123/_ezs123Init.asp" -->

3. Company Information:

*Field Name*	*Description*
Store Name AppName	Enter the name you want to appear on sale receipts or other pages managed by the shopping cart. This value is used as backup in case the database is unavailable and is normally the same as the 'Store Name' in the Merchant setup screen.
Company Name AppCompany	Enter the company name (or again the store name if they are the same).
Customer Support Phone AppSupportPhone	Enter the phone number for your Customer Support Department.
Customer Support E-Mail AppSupportMailTo	Enter the e-mail address for your Customer Support Department.

4. Order Confirmation:

*Field Name*	*Description*
E-Mail Subject AppConfEmailSubject	Enter the e-mail subject desired for order confirmation e-mails.
Marketing Message on E-Mails AppConfEmailCustom	Enter any marketing message to be displayed at the bottom of confirmation e-mails. Note that the system automatically appends a 'Thanks for shopping with 'StoreName' message, so don't set up the Marketing Message as a 'thank you' note. Marketing messages may contain hyperlinks.

5. Listing Control Parameters:
The system uses 2 sets of control parameters, one for the product listings, a second one for category listings. Each set of control parameters features multiple behavior modifiers.

*Field Name*	*Description*
Product Listings AppListParams	Supply the following information: 1. Number of columns in listings (1 to 9). 2. Whether to show the category thumbnail image (click ON or OFF). 3. Whether to show the product thumbnail image (click ON or OFF). 4. Whether to show the product full text (click ON or OFF). 5. Whether to show the product SKU (click ON or OFF). 6. Whether to enable selection of multiple products simultaneously (click ON or OFF).
Catalog Listings AppCatalogParams AppCatalogParams	This setting affects the behavior of both the 'Fast Catalog' page and the 'Category Drill-Down' page. Supply the following information: 1. Number of columns in listings (1 to 9). 2. Whether to show the category thumbnail image (click ON or OFF) . 3. Whether to show the product thumbnail image (click ON or OFF). 4. Whether to show the category full text (click ON or OFF). Important note: You must check at least the first box for item #2 or the listing will not display any data. The category listing includes 'smart logic' that will automatically display the category description and/or the text or image if the either text or image are specified. If no image is specified, the text only will be displayed, however, the system cannot make any assumption about whether you want the category image only to be displayed. This is why this item should always be checked.

6. Fonts & Colors:

*Field Name*	*Description*
Application Text Font AppFont	Select fonts from the drop-down list. This will be the base font for all text in the shopping cart. Note: You may override the base font in product descriptions or other text by inserting HTML font tags (<font>...</font>).
Background AppBGColor	Enter the color for the shopping cart pages background.
Text AppTextColor	Enter the color for regular text.
Titles AppTitleColor	Enter the color for screen title text.
Link AppLinkColor	Enter the color for hyperlinks.
Alt. Link AppALinkColor	Enter the alternate color for hyperlinks.
Visited Link AppVLinkColor	Enter the color for visited hyperlinks.
Borders AppBorderColor	Enter the color for table borders.
Header Background AppHeaderBG	Enter the background color for screen headers.
Header Text AppHeaderTextColor	Enter the color for text in screen headers.
Error AppErrorColor	Enter the color for error messages.
Warning AppWarningColor	Enter the color for warning messages.
Horizontal Ruler AppHRColor	Enter the color for horizontal rulers.
Horizontal Ruler Size AppHRSize	Enter the size for horizontal rulers (1 through 10).

Notes about colors definition:
- You may use color standard name, hex value (#nnnnnn) or the rgb(nnn,nnn,nnn) function.
- Using the color picker: Select the desired color definition field, then click on the desired color from the color table.

7. Order Control Parameters (Advanced):

*Field Name*	*Description*
Show Order Status on History AppShowHistoryStatus	Check the box if the order status is to be shown on order history reports displayed to customers. If you do not track or update the shipping status of your orders through the shopping cart system, un-check this box otherwise orders will always show as 'pending' and customer will wonder whether they were shipped. This will probably trigger phone calls to your customer support department.
Show Order History (days) appshowhit AppShowHistory	Specify how far in the past (in number of days) should order history reports go.
Show Re-Order Button on History appshowhit AppShowHistoryReorder	Specify whether a 'Re-Order' button should be displayed when customer view their history to enable them to place the same order as a previous one. Orders created by re-ordering can still be modified by the customer.
Mailing List Default Setting AppEMailPromoDefault	Specify whether the 'e-mail promotion' check-box should be checked on or off by default in user check-out screens. Note that this value may be overridden according to customer's indicated preferences.

8. Sales-Related Parameters (Advanced):

*Field Name*	*Description*
'On Sale' Phrase (product listing) AppOnSale	Enter the phrase you want to appear next to items on sale on product listings.
'On Sale' Phrase Color (product listing) AppOnSaleColor	Specify the color for the 'on sale' phrase text on product listings. You may also use the color picker as described above.
'On Sale' Phrase (category listing) AppOnSaleCat	Enter the phrase you want to appear next to items on sale on category listings.
'On Sale' Phrase Color (category listing) AppOnSaleCatColor	Specify the color for the 'on sale' phrase text on category listings. You may also use the color picker as described above.
'On Sale' Price Style AppShowRegPrice	Select an 'On-Sale' price style from the drop-down list.

9. Miscellaneous Phrases (Advanced):

*Field Name*	*Description*
Title For Category Listing AppClassListTitle	Enter the title you want for main category listing. The system will use 'Catalog' as default.
Text On 'Add-To-Cart' Button AppBuyButtonText	Specify the text for the 'Add-To Cart' button (eg: 'Add', 'Buy', etc...).
Text On 'Pay' Button AppPayNowButtonText	Specify the text for the 'Pay' button on check-out screens (eg: 'Pay', 'Process', etc...).
Text For Items Out of Stock AppOutOfStock	Specify the text to be displayed next to items that are out of stock.

Command Button	Action
Advanced...	Loads the 'Advanced' wizard screen (sections 7, 8 and 9 will be displayed).
Save	Saves the changes and exit.
Cancel	Exits the screen without saving changes.