Applet: uShopInitialize

Description:
The uShopInitialize applet provides the means by which you can specify the currency, whether to display the EURO totals, and some other general store preferences. If used, this applet should be placed on one of the store's initial pages so that the settings set by this applet are applied as soon as possible. Ideal locations for this applet might be your store's "Enter" page or if using a "frames" layout, in the small frame where the small shopping cart applet is located. An "image" parameter allows you to use any image to configure this applet's appearance - or you can just set WIDTH and HEIGHT of this parameter to 2 x 2 so that the applet is virtually invisible.

Example:


<APPLET CODE="uShopInitialize.class" CODEBASE="../classes/" WIDTH=201 HEIGHT=61>
<PARAM NAME="image"                 VALUE="ushop_logo.gif">
<PARAM NAME="currency_symbol"       VALUE="$">
<PARAM NAME="show_euro"             VALUE="NO">
</APPLET>


Parameters:

Name Description
codebase This parameter is actually part of the <APPLET> tag and therefore should be specified on the first line of the Applet (see example). It allows you to specify the location of this applet's class file. The recommended value is "../classes/". See codebase for more information.
image This parameter allows you to specify the image that the applet will appear as. Note that due to the security restrictions built into IE, when loading any image by an applet, the image must be located in the same directory as the applet's class file. So be sure that the image that you specify here is located in your "classes" directory. Note that for this applet, you do not have to specify any image at all here - but rather, you can make this applet virtually invisible by setting the WIDTH and HEIGHT to 2 x 2.
link If desired, this parameter allows you to make this applet a link to any other page. This is sometimes desireable if the applet is on a special "Enter Store" page - in which case, you can make this applet a link to a page inside your store. The format of this parameter is simply the name (and relative path) to the page that you want to link to. If you do not want this applet to be a link, simply leave this parameter blank or set it to "NONE".
target If this applet is also configured to be a link, then this parameter allows you to specify the "target" page for the link. The default value of this parameter is "".
currency_symbol The currency symbol that will be used throughout your store. Valid values are "$", "£", "DM", etc. The default value depends on the language module that you are using - "$" for US, "£" for UK, etc.
show_euro This parameter allows you to specify whether to also display the subtotal in EURO dollars. Valid values are "YES" or "NO". The default value is "NO".
euro_symbol The currency symbol that will be used when displaying the EURO subtotal. The default value is "EURO".
euro_conversion_rate The current conversion rate that is used to convert from your base currency to the EURO dollar. The EURO total will be determined by the formula:

Euro Total = Total / Conversion Rate,

where the Conversion Rate is the current conversion rate from your currency to the EURO dollar. You can look up the current conversion rates at the Yahoo Currency Converter. Typical values for this parameter will be something like "0.6568" for conversion from "£" to EURO or "1.956" for conversion from "DM" to EURO. The default value is "1.0".
hidden_extra1 This parameter allows you to specify an extra hidden field that will be maintained throughout the customer's shopping session.
hidden_extra2 This parameter allows you to specify an extra hidden field that will be maintained throughout the customer's shopping session.
hidden_extra3 This parameter allows you to specify an extra hidden field that will be maintained throughout the customer's shopping session.
hidden_extra4 This parameter allows you to specify an extra hidden field that will be maintained throughout the customer's shopping session.
hidden_extra5 This parameter allows you to specify an extra hidden field that will be maintained throughout the customer's shopping session.
Language Preference Parameters
Name Description
label_add This is the default label that will appear on the Input Applet "ADD" buttons.
label_view This is the default label that will appear on the Applet "VIEW" buttons.
label_quantity This is the default label that will appear next to the Input Applet quantity entry box.
label_price This is the default label that will appear next to the Input Applet current price indicator.
label_total This is the default label that will appear next to the Input Applet current total indicator.
cart_label_id This is the default label that will appear above the product ID column in the shopping cart.
cart_label_name This is the default label that will appear above the product NAME column in the shopping cart.
cart_label_description This is the default label that will appear above the product DESCRIPTION column in the shopping cart.
cart_label_weight This is the default label that will appear above the product WEIGHT column in the shopping cart.
cart_label_quantity This is the default label that will appear above the product QUANTITY column in the shopping cart.
cart_label_price This is the default label that will appear above the product PRICE column in the shopping cart.
cart_label_empty This is the default text that will appear in the shopping cart when the cart is empty.
cart_label_full This is the default text that will appear in the shopping cart when the cart is full.
cart_label_subtotal1 This is the default label of the SUBTOTAL field in the shopping cart. (The subtotal BEFORE any discounts are computed).
cart_label_discount This is the default label of the DISCOUNT field in the shopping cart.
cart_label_subtotal2 This is the default label of the SUBTOTAL field in the shopping cart. (The subtotal AFTER any discounts are computed).
cart_label_euro_subtotal This is the default label of the EURO SUBTOTAL field in the shopping cart.
cart_label_tax This is the default label of the TAX field in the shopping cart.
cart_label_shipping This is the default label of the SHIPPING field in the shopping cart.
cart_label_handling This is the default label of the HANDLING field in the shopping cart.
cart_label_shipping_and_handling This is the default label of the SHIPPING & HANDLING field in the shopping cart.
cart_label_total This is the default label of the TOTAL field in the shopping cart.
cart_label_euro_total This is the default label of the EURO TOTAL field in the shopping cart.
popup_window_title This parameter allows you to specify the title that appears on the "add product" popup window. The default value is "Added To Cart".
popup_window_message This parameter allows you to specify the message that appears in the "add product" popup window. The default value is "The item has been added to your shopping cart."