eMartCart: Help Creating Page


	How To Create Your Catalog Page
	HOME \| CREATE CATALOG PAGE \| SEND ORDER \| FAQ \| FORUM \| CONTACT US

How To: Create Your eMartCart Legacy Premium Service Catalog Page

The "Create Your Catalog Page" form is used to create a catalog page showing one or more items linked to the shopping cart system. The information that you supply in this form will be inserted into an HTML "template" of your choice to generate the HTML for your Web page. When you have finished defining your page, you can download this HTML to a file on your own computer and then transfer that file to your own Web site.
You can also download and save the form itself on your computer, so that you can reload the form later (by using the browser's "File->Open" function), make just the necessary changes and additions, and then regenerate the HTML for the page.
The initial item entry form has one slot to define an item. To add additional items, fill in the first item and then click the "Create Catalog Page Form" button at the bottom of the page. The form will be sent back to your browser with all the previous information filled in, but with an additional slot to add another item. As each item is added, click the "Update Form" button at the bottom of the page. This step is necessary to insure that your data will be saved when you save the form on your computer. You must click the "Create Catalog Page Form" button, even if you only want one item on the page, before you can create the catalog page itself. (In addition to insuring that the form will contain your data when it's saved, this step is necessary to check the validity of your input data.)
When you are finished adding items to the page, you can generate the catalog page, but before doing that, you can click the "Download Form" and save the data on your local disk. When you reload this file into your browser (by using the browser's "File->Open" function and selecting the saved file), all of the previous data will be entered on the form, ready for editing. Note: Since you can save both your input form and the generated catalog page, be sure to give them different names.
The "Generate Page" button will show your catalog page in your browser. You can use the browser's "Back" function to go back to the form and make changes. As noted above, when you are satisfied with the catalog page, you can click the "Download Page HTML" button at the bottom of the form and save the downloaded file. This file will be a standard HTML file that you can install on your Web site.
If you prefer to create your own HTML for your pages, there is an option that will generate just the HTML for the "order" buttons. The generated page will have a "text box" for each item containing the HTML for an "order" button and a "check out" button. You can "cut and paste" the HTML for each button into the desired place in your own HTML files. To copy the HTML, click and hold your mouse's left button at the beginning of the code and "drag" the cursor down to the end of the code. The text should then be highlighted. Then you can either use the browser's "Edit->Copy" menu function or you can press the Ctrl-C keys to copy the text to the Windows clipboard. In your HTML editor, position the cursor where you want the button HTML, then use either "Edit->Paste" or the Ctrl-V keys to paste the copied text into your file. If you would like to use your own graphic files for the buttons, you can edit the SRC="..." URLs in the <INPUT TYPE="image"> tags.
If you are only creating the "order" buttons, you only need to enter the minimum required data, as noted below and on the form: Required fields are labeled with red prompts.
Below are detailed explanations for the data in the catalog page form. Please read these before creating your page, but when you are editing a form, you can click on any input field prompt to come back to this page to see the explanation for that field.
Warning: Do not use double-quote marks ( " ) in any fields, except possibly the Product Description field and the Catalog Page Heading field. All of the other fields will be defined in HTML <input value="..."> fields in the item form and the "order" button code, and double-quotes will confuse browsers when they interpret these input fields. You may, however, use apostrophes ( ' ) as single-quotes, or a pair of apostrophes as an approximation of a double-quote. (The Product Description and the page Heading fields use HTML <textarea> input fields, so double-quotes are safe in those fields.)
New Feature: [SET INITIAL DATA] The data in the top two sections (Merchant Information and Catalog Page Information) will now be saved in cookies, so the next time you use the Item Form to create a catalog page or Order buttons, you can have these two sections filled in automatically. (Note this will only work after you update a form at least once with this new feature enabled.) To use this feature, there is a link labeled "[SET INITIAL DATA]" on the far righthand side of the gray "Merchant Information" title bar at the top of the page. Whether you are on the "create a new page" Item Form or on an updated Item Form that already has item entries, clicking this line will initialize a new page with the top two sections filled in with the previous data you entered, and no items, so you are ready to create a new page similar to your previous page. Again, please note that this will work only after you have created or updated an Item Form since this new feature has been installed. However, note that if you have saved your previous Item Form (which you should always do!), then you can load it in your browser and click the "Update Form" button without actually making any changes. This will create a new Item Form page that will have the "[SET INITIAL DATA]" link at the top, and the data from your previous form will be set in a cookie. So, you can now click the "[SET INITIAL DATA]" link and start a new page similar to your existing one.

Merchant Information
Your E-mail:	This is a required field, and it must match the e-mail address that you registered for eMartCart Premium Service. If you will be using PayPal, this e-mail address must also match the e-mail address that you have used to establish your PayPal account: This is the e-mail address that will receive the PayPal payment so be very careful to enter this field correctly. If this e-mail address does not match the address you registered with eMartCart, your shopping cart will not function. If you ever need to change this e-mail address, contact us, giving us your new address and your original registered address. (After we change your registered address, your original address will continue to work for 7 days, while you change the address in all of your Order buttons. The easiest way to do this, without creating new buttons and pages, is to use any editor program -- Notepad will do -- directly on your HTML files, and use the "Replace All" function to change all instances of the old address to the new one. Note that PayPal allows multiple addresses for the same account, so the smoothest way to change your address without a break in service is to first add the new address to your PayPal account, send us an e-mail requesting the change, and after we notify you that your new address has been registered, change the address in your catalog pages and upload them.)
Use PayPal?	If you will be using only 2CheckOut, Authorize.Net, or PayByCheck, or having orders sent directly to you (E-mail Orders For) and you do not want your cart to have a check out button for PayPal, unset this checkbox by clicking on it. By default, this checkbox is set to "Yes".
Currency	PayPal now supports payments in British Pounds Sterling (GBP), Euros (EUR), Japanese Yen (JPY) and Canadian (CAD) Dollars. (NOTE: eMartCart also allows Australian (AUD) Dollars, but these are converted to US Dollars before transferring to PayPal, because PayPal does not yet support AUD directly.) EMartCart also allows using these currencies with the other payment services, but it does so by converting prices to US Dollars before transferring the customer for payment. With this Currency option, you can show Order button prices, taxes, and shipping charges in the currencies listed, and those currencies will also be shown for all amounts on the cart page. The specified currency code will also be passed to PayPal (except for AUD; see below). Please see the PayPal.com site for details about their alternate currency processing when this currency code is specified. For AUD passed to PayPal, and for all alternate currencies when 2CheckOut, Authorize.Net, or PayByCheck is used for checkout, the payment amount is converted to US Dollars before transferring for payment. For these conversions, eMartCart will use the daily average "spot market" rates as of noon each day and add 2.9%, to approximate the conversion rates charged by most online payment services. Note that this means that your customer will be paying the extra 2.9%, in dollars, so when the payment service converts the payment to your desired currency, the amount (before other transaction fees are applied) should be approximately the same as your list price in your currency. However, since the exchange rate used by the payment services is only assumed, eMartCart cannot and does not guarantee that prices after conversion will be the same as your original price. NOTICE: This feature is offered only as a convenience to you and your customer, and eMartCart cannot assume any responsibility for the actual rates applied by the payment services when the amount is converted to your currency. If you are unwilling to accept this condition, then do not use this feature, and instead you must list prices as you want them in US Dollars. By default, the currency is set to "USD" meaning US Dollars and a "$" symbol will be displayed in front of prices.
2CheckOut ID	The 2CheckOut option allows payments through your 2CheckOut.com merchant account. This option requires a "2CheckOut ID", which is a numeric Account ID that will be assigned to you when you register for the 2CheckOut.com service. (Please help support new eMartCart development by registering through our affiliate link, which pays us a referral fee and does not add any additional costs to you. Thank you.) To add a 2CheckOut checkout button to your cart, create an account and enter your 2CheckOut Account ID in this field. Important Note: For your eMartCart order messages to be processed correctly following a 2CheckOut.com payment, you must set your Cart/Program Details in your 2CheckOut account to return the customer to the eMartCart site following each payment transaction. With this link, eMartCart will send the order messages to you and the customer, and then send the customer to your "Thank You URL" page. Your order messages will not be sent until the 2CheckOut payment process links back to the specified URL. The eMartCart URL to set for this return link is: http://emartcart.com/cgi-bin/cart.exe/xcart/odb/2CheckOutNotify Also note that you can customize several attributes of the payment page, such as adding your own logo, so please see the 2CheckOut site for details.
PayByCheck ID:	The PayByCheck.com payment option requires a "PayByCheck ID", which is a numeric Account ID that will be assigned to you when you register for the PayByCheck.com service. (Please help support new eMartCart development by registering through our affiliate link, which pays us a referral fee and does not add any additional costs to you.) To add a PayByCheck checkout button to your cart, enter your PayByCheck.com Account ID in this field.
E-mail Orders for:	This field allows you to have orders e-mailed directly to you rather than transferred to any of the credit-card payment services. For example, you can use this method to accept checks and money orders by regular mail. The orders will be e-mailed to you, and you can contact the customers by reply e-mail to provide further instructions for completing the orders. The entry for this field should describe to customers what types of payment methods you will accept by e-mail order. A typical entry would be "Pay by Check or Money Order". Whatever you put in this field will be used a shopping cart section header below the "Check Out" header (i.e. the section where the links to the payment services are placed). Note that you can use this method exclusively: If you uncheck the "Use PayPal" field and do not have an entry for a PayByCheck or 2CheckOut account, then this will be the only way for customers to check out. By default, the orders will be sent to Your E-mail address (i.e., the first entry above). However, you may wish to use a different e-mail address for these orders, perhaps using an "auto-responder" message on this mailbox to provide your customers with the necessary information to complete the orders (e.g., your mailing address for sending checks and money orders, special conditions, etc.). To use a different e-mail address for receiving these orders, simply put the e-mail address in this field first, followed by a comma, followed by the text to use as the header for the shopping cart check out section.
Merchant Name:	This is an optional field that you can use to identify yourself or your business. It will be placed on the top of your catalog page. (The exact placement depends on the page style that you chose.) This name will also appear in the order messages that are sent to you and your customers. And, if you do not specify a Logo URL in the Catalog Page Information section below, the Merchant Name will be used on your shopping cart page, in the upper left-hand corner (i.e., in the place where the eMartCart logo appears on the standard-service cart page).
Tax Region 1 & 2:	If you are required to charge sales tax to residents of the same area in which your business is physically located, then identify the region (for example, your state) in this field. The second tax field can be used for a local tax (e.g., city or county), if that is a different rate. The names that you use for the Tax Regions can be anything, since they are simply displayed to the customers. Important Note: If you are going to create several different catalog pages, you must be careful to specify the same Tax Regions and Rates on all pages. Otherwise, the final tax calculation will depend on which page was last used to order an item.
Tax Rate:	Enter the tax rates for your Tax Regions, if any. Note: This rate must be entered as a percentage, such as 4 if the tax rate is four percent or 4.5 if the rate is four and a half percent.
Tax on Shipping?	Most states do not charge sales tax on shipping and handling charges. However, some state will require that you collect sales tax on shipping and handling charges, so you should verify the sales tax law in your state. To charge sales tax on shipping and handling, click in this checkbox to set it. Otherwise, if this box is not set (the default), then tax will be calculated on the order cost before calculating the shipping charge.
Shipping Option:	If you wish to offer your customers up to three different shipping methods, identify the methods by name in these fields. The names might be generic (e.g., Standard, Rush, Overnight), or you might identify specific carriers or options (e.g., Priority Mail, UPS, etc.). On the shopping cart page, these options will appear in a "pull-down" list for the buyer to select. If you only provide one shipping method, you can leave this section of the form blank, or you may want to enter just one Shipping Option so that the customer will know what shipping method will be used. (This method will be shown on the shopping cart page, but the customer will not be able to change it.) Important Note: If you are going to create several different catalog pages, you must be careful to specify the same Shipping Options on all pages. Otherwise, the shipping options that the shopper sees on the shopping cart page will depend only on which page was last used to order an item.
Order Chg.	For each shipping option, you can use the corresponding Order Chg entry to specify a shipping charge that will be applied for the total order. This is one of the two ways of charging for shipping (i.e. per total order and per item) and you can use either one or both combined. The Order Chg can be used to charge for shipping based on the total price of the order, if you prefer to use that method instead of the per-item charges that you can define for each individual item (see Item Shipping Cost). But you can also set per-item charges and use the Order Chg field to add a single additional charge (perhaps a handling charge) to each order. And, the Order Chg also allows you to offer free shipping for orders over a specified amount, whether or not you use the per-item charges. Another feature of the Order Chg entry is that you can use it to charge for shipping as a percentage of the total price of the order, rather than a fixed amount. There are several ways to specify the Order Chg depending on precisely how you want this charge to work, so please read this section carefully before using this field. If you enter a single number (with or without a decimal point) in the Order Chg field, that amount will be taken as the fixed shipping charge for the order. (Or, if you are using this field along with the per-item shipping charges, this amount will be added to the shipping charge calculated from the per-item charges). You can also enter a number immediately followed by a percent sign "%", and instead of being taken as a fixed dollar amount, the charge will be calculated as a percentage of the total price of the order. (For example, if you enter "10%" in the Order Chg field and the total price of the order is $100, then the calculated shipping charge will be $10.) You can also give a list of charges that are based on the total amount of the order. That is, you can have different rates, depending on the total price of the order, and the proper rate will be selected automatically. Each entry in this list should consist of a charge amount followed by a space, followed by a total order price for which that charge should be applied. (The charges can also be specified as percentages, rather than fixed dollar amounts, by adding a percent sign "%" after the charge number.) You can define several entries in this list, separated by commas, which would specify several different charges for increasing order prices. Note that the list must be given with the smallest total order price first, then additional rates must be given in order of increasing total order prices. Such a list might be something like this: "5 50, 8 100, 10 150, 12". The meaning of this specification would be: "Charge $5 for orders up to $50. Charge $8 for orders $50 or more, up to $100. Charge $10 for orders $100 or more, up to $150. Charge $12 for orders $150 or more." That is, if the total price of the order (taxes excluded) is less than the first specified order amount, then the first Order Chg will be applied. Otherwise, if the total order price is greater than that, the order price will be compared to the second entry, and so on until an entry is found that is greater than the order price, and the charge for that price will be applied. You can end your list with just a charge, without any order price, and if this entry is reached, then that amount will be charged for all orders greater than the previous entry. Note that you can use dollars and cents for either the charges or the order price brackets. Also note that the total order price is compared for being less than your list entries, and if, for example, you want to charge $5 for orders up to and including $50, etc., you could make the entries something like "5 50.01, 8 100.01, ..." A special option that you can use in the Order Chg specification is the word "free" as the last entry. This allows you to offer free shipping for orders over a given amount. You can use it as the last entry in the list, and there will be no shipping charge if the order is greater than the previous entry. For example, "5 50, 8 100, free" would mean that shipping is free for orders of $100 or more. Actually, you could use a 0 to do the same thing if you are only using the Order Chg and not the individual per-item charges, but using the word "free" does make a difference if you are using both types of charges. That is, if you are using both types of shipping charges, then the Order Chg is in addition to the per-item charges, so a 0 would mean no additional cost, whereas the word "free" would mean to charge no shipping at all if the order is over the specified amount. You may want to use the individual per-item charges, but also offer free shipping if the total order is over some specified amount. You can use the Order Chg to do this by a special type of entry: "free over" followed by the order amount. For example, the single entry "free over 100" in the Order Chg field, when combined with specifying individual per-item Shipping Costs, would mean to charge the given per-item costs if the total order is less than $100, but charge nothing for shipping if the total order (excluding taxes) is $100 or more.
Discount Passwords:	This field can be used to define a list of one or more passwords or coupon numbers that you can give to selected customers to offer them a special discount. In this field, a discount password (without spaces) or a coupon number can be entered, followed by a space, followed by the dollar amount or the percentage of the discount. For example, an entry such as "secretpwd $10" (without the quote characters) means that a customer who knows the "secretpwd" password will receive a $10 discount, or an entry such as "secretpwd 10%" means that a customer who knows the password will receive a 10% discount on the total price of the order (tax and shipping excluded). You can use "coupon numbers" instead of passwords, but note that eMartCart does not track coupon usage to insure that a coupon is only used once. If a coupon is only intended to be used once, you need to clearly inform your customers of that, and you will need to check orders yourself to insure that a particular customer does not attempt to use the coupon more than once. To define a list of passwords, each of which can have a different discount associated to it, separate the list or password/discount pairs with commas. (Note that each password entered must be followed by a space and a discount amount or percentage.) For example, an entry such as "wordOne $5, wordTwo 10%" defines two passwords, where "wordOne" is for $5.00 and "wordTwo" is for 10%. Note that passwords are case-sensitive. That is, if a password has uppercase letters, your customer will need to type in the password exactly the same way you defined it. Passwords are set in input fields in the Order button HTML, like all other ordering data, but the passwords are "one-way encrypted" so that anyone viewing the HTML will not discover the passwords.
Discount:	These two fields can be used to apply a flat discount on all purchases over a given total amount. For example, if you wish to offer your customers a 10% discount on all purchase over $100, enter 10 in the first field and 100 in the second field. The discount will be applied if the total amount of the product prices excluding tax and shipping exceed the specified amount.
Minimum Order:	You can set a minimum total order price in this field. If the total price of the order, excluding tax and shipping, is less than this amount in the shopping cart, then no Checkout buttons will be available. Instead, there will be a message telling the customer that the current order is below the minimum order price.

Catalog Page Information
Page Title:	This optional field may be used to identify the catalog page: It will be placed at the top of the page. (The exact location of the title depends on the page style that you select.
Logo URL:	If you have a logo graphic for your company, then you can include it on your catalog page and your shopping cart by entering the Web URL in this field. It will be placed at the top of the catalog page, depending on the page style that you select, and it will also be used in the upper left-hand corner of your shopping cart page instead of the eMartCart Logo. (Note: this is not necessarily the same as the logo that will be used on the PayPal payment page, the PayPal Logo URL described below, but you can use the same logo for both if it is 150 x 50 pixels. For this logo, you should give the URL as "http://...", not "https://...".) You must use the full URL for the graphic file, e.g., http://www.yourdomain.com/yourdirectory/logo.gif, so that the graphic can be loaded by the shopping cart page (which will be generated on the eMartCart site, so a "relative URL" for your site will not work). If you do not have a logo graphic for your company, you should specify the Merchant Name in the Merchant Information section above. This name will then be used on the shopping cart page instead of the eMartCart logo. (If you do not specify either the Merchant Name or the Logo URL, then the eMartCart logo will be used on the shopping cart page.)
Page Style:	From this pull-down list, select one of the available page styles. The selected style determines the page layout. After you have entered all of the other data, try each of the available styles (by selecting a style from the list and clicking on the "Generate Page HTML" button at the bottom of the page) to find the one you prefer.
Page Color:	From this pull-down list, you can select the color scheme that you would like to use.
Buttons:	You can select the style of Order and Checkout buttons that you want to use by clicking in one of the round "radio" selection boxes immediately to the left of each Order button. (Some styles say View Cart instead of Checkout, but it's really the same thing: that link goes to the cart page without adding any new items.) The first three styles shown have different colors available, depending on your Page Color selection. The last two buttons are patterned after standard PayPal buttons, and there is only the color shown. Note that if you don't want the Checkout / View Cart buttons included, you can put a check in the "No Checkout or View Cart Button" box below.
Order Button URL and Checkout Button URL	If you have Order and Checkout (View Cart) buttons that you prefer to use, you can enter the URLs for your image files here. Since the generated catalog pages showing these buttons will be on your own site (not on the emartcart.com site), you can use "relative URLs" in these fields. For example, no file system directory path is necessary if an image file is on the same directory as the HTML document referencing it, so in this case you could use just put the image file name in this field. Or, if the image file is on the same site (domain) but on a different directory (which is recommended), you can use just the URL file directory path such as "/images/orderButton.gif" (without needing the "http://domainName" in front, because the domain will be assumed to be the same as the referencing HTML document). If the image file is on a different domain, then you need a full URL including the "http://" in front of the domain name.
No Checkout or View Cart Button	Click in this checkbox (which sets a check mark) if you do not want any Checkout or View Cart buttons generated. If you do this, you should probably provide some other means of reaching the cart page without adding any new item; perhaps a single View Cart link in your navigation menu for the catalog page. This link should be: http://emartcart.com/cgi-bin/cart.exe/xcart/odb/Update?business=yourEmailAddress ...where "yourEmailAddress" should be exactly the same e-mail address that you are using for your buttons, with no quotes.
Heading:	This optional field may be used, in addition to the title, to provide general information about the items listed on the catalog page. The exact placement on the page depends on the page style selected. Note that you can use HTML in this text. (For example, you can include additional graphics with an <IMG SRC="url"> tag.)
Return URL:	This is a required field, even if you are only generating "order" buttons. This URL will be used as the destination page for the "Continue Shopping" link on the shopping cart page. Typically, you will want this to be the URL of your catalog page itself (i.e., the URL where you intend to install the catalog page on your site), so that shoppers can easily return to the same page after ordering an item. This URL will also be used to link the customer back to your site from the PayPal site after paying for the order. Note that if you also specify the Thank You URL (see below), then the Return URL will be used if the customer cancels the payment transaction in PayPal.
Thank You URL:	This URL will be used to link the customer back to your site from the payment processing site only after successful payment for the order. (If you do not specify a Thank You URL, then the Return URL will be used as the return link from PayPal for both successful payments and cancellations.)
PayPal Logo URL:	This URL will be passed into PayPal for display on the payment page. PayPal requires that this logo must be exactly 150 pixels wide by 50 pixels high (width=150 height=50). It is strongly recommended that this image is hosted on an SSL secure server and referenced with an "https://..." URL. This is because, if it is not, browsers will show a Security Warning window when the user attempts to check out, saying that the "page contains both secure and nonsecure items" and ask the user whether or not to display the nonsecure items. It's just your logo that's non-SSL, but your customer doesn't know that, so in addition to interrupting the checkout, this warning may cause some customers to believe that the transaction itself will not be secure. This can be avoided by hosting your PayPal payment page logo on an SSL server. Announcement: eMartCart users can host their PayPal payment page logos on the SSL server at SecureLogo.com at the special rate of $5 per year. Then, you can use an entry for this field such as "https://secure.securelogo.com/images/yourID.gif".
Nav.Menu, URL:	These fields may be used to define a "site navigation menu" of links to other pages, which will typically be other pages on your own site. That is, the menu allows you to link the catalog page that your are creating to other pages on your own site, such as your home page and other catalog pages. The smaller input fields on the left should contain the text to be displayed in the menu (e.g., "Home Page" or short names for other pages), and the larger fields to the right should contain the link URLs for each menu item. If these are links within your own site, you can use "relative" URLs, but again, full URLs (beginning with "http://yourdomain...") are recommended. The exact format of the displayed navigation menu will depend on the Page Style that you select. Note that there are five entries for menu items on the initial page definition form. When you Update the form, any menu links that you filled in will be shown, plus one additional slot to add another link. If you need more menu links than this, you can add as many as you need, one at a time, by simply clicking the Update button after entering something in the vacant slot. (That is, Update always adds one more vacant slot after the used ones.)

First Item, Add Another Item
Product Number:	Use this field to specify your product number or item number. This is a required field. Although it is called a "product number", this field can actually contain any kind of text (e.g., a combination of digits and alphabetic characters, or just alphabetic characters). If you don't have Product Numbers for your items, you can just use a short abbreviation of the product name. Note: This field should be limited to a total of 18 characters. Excess characters, beyond 18, will not be displayed on the order listing.
Price Ea.:	Enter the price for a single item. This is a required field unless the Price Options field provides a price for each product option. Note that PayPal, 2CheckOut, and PayByCheck currently support only US dollars for prices.
Sale?	Check this box to put the words "Sale Price:" in front of the item price in the catalog page listing.
Fixed Qty.:	This field can be used when you want to set a fixed quantity (typically 1) in the order for a particular item, and you don't want the customer to be able to change it. (That is, if Fixed Qty. is not specified, which would be the typical case, then the shopping cart will initialize the quantity field to 1, but the shopper will be able to change this number and recalculate the total charge. A Fixed Qty., on the other hand, will be shown on the cart, but it cannot be changed.) A fixed quantity of 1 might be used, for example, if you only have one of the items for sale, or you might use it if you are charging for a one-time service rather than a physical item. (Note: eMartCart does not track product quantities, so if you use this field when you only have one item to sell, it is your responsibility to remove the item from your page when that item is sold.) The Fixed Qty. feature may also be used to provide a pull-down list of quantities for your customer to select, as explained below. If you put a single number in this field, then this quantity will be shown in the shopping cart and the order, but the customer will not be able to change it before placing the order. If you enter a number greater than one, then this quantity will be multiplied by the Price Ea. (single item price) to get the total price. Another way to use this field is to provide a pull-down list of fixed quantities. This is indicated by giving a list of quantities separated by commas; for example: 3,6,9,12. (Spaces in the list are ignored.) This option is most useful when the product is pre-packaged in fixed quantities, but you could use a list like "1,2,3,4,5" if you simply want to give the shopper a pull-down list of quantities, rather than having to change the number in the shopping cart. The customer will not be able to change the quantity in the shopping cart. However, the item may be re-entered into the cart by selecting a different quantity and clicking the "order" button again, and the selected quantity will replace the original quantity, as the customer might expect.
Product:	This required field should contain a short description of the item. (A longer description can be put in the Description field below.) This short description, along with the Product Number, will be used to identify the item on the order listing. (Note that this field, with any of the pull-down selections added, and the Product Number will be the only fields shown on the order to identify the item, so make sure that the combination of these fields uniquely identify each product.) Although the size of this field is not limited, the order listing will be easier to read if this field (plus the optional selections, if any) does not exceed 36 characters. In the cart, the description will use multiple lines if necessary.
Price Options:	This field allows you to specify different options for a single basic product, each of which has a different price. (If you have product options that do not have different prices, or if only some of the options have added costs, you can use the Selections lists for those options, as explained below. This field is for the case where each option has a different price.) When you use this field, you should not enter the Price Ea. (If you do enter a Price Ea., it will appear on the catalog page, but it will not be used to calculate the price. When you use the Price Options list, you must provide a price for each option, even if it is the same price as another option in the list.) These options will appear in a pull-down list above the "order" button. If the customer does not change the selection, the first option in the list will be used when the "order" button is clicked. To use this feature, a list of option descriptions and prices must be entered in this field, separated by commas. Somewhere in each option description (usually following the text, but it can be anywhere), there must be a "$" immediately followed by the price for that option. For example, a list such as "Bronze $10, Silver $15, Gold $20" would cause those three options to appear in the pull-down list, exactly as you enter them, and the item's price will be extracted from the particular selection made by the shopper. The text for the selection (with the price removed) will be added to the text of the Product field (the short description) in the cart. The price extracted from that selection will be shown in the Price Ea. field.
Qty. Price:	This field may be used for volume discounts; it allows the price for the item to depend on the quantity ordered. The quantities and prices are entered in this field as a comma-separated list, where each list entry is a quantity followed by a space, followed by a "$" sign and the price for that quantity (or more). For example: "5 $9, 10 $8, 15 $7" would specify three quantity discounts ranges, but note that this actually creates four price ranges. The first entry in this list specifies that for quantities of 5 or more items, the price is $9 each. But note that this implies that quantities of 1 to 4 should be charged at the price entered in the Price Ea. field, so the Price Ea. field is required when you use this feature. The next discount range specified here begins at 10, so the price for 5 to 9 items would be $9 each and 10 or more would be $8 each. Similarly, the last entry specifies that if the quantity is 15 or more, the price is $7 each. This feature will cause a list of prices to be shown above the "order" button, in the place that the Price Ea. field is normally shown. For example, if you have entered the Price Ea. as 10 for this item and then entered "5 $9, 10 $8, 15 $7" in the Qty. Price field, the generated price list would look like this: $10.00 Qty 1 - 4 $9.00 Qty 5 - 9 $8.00 Qty 10 - 14 $7.00 15 or more
Picture URL:	If you have a graphic (a picture) of the product, you can enter the URL of the image file in this field. Like other URLs specific to your site, this can be a "relative" URL, but full URLs (starting with "http://yourdomain...") are recommended.
Ref. Link URL:	This optional field may be used to provide a link from the item to another page, which would typically be a larger picture or an HTML page containing more detailed information about the item. If this field is used, then both the image from the Picture URL above (if any) and the Product short description will be set up as links to this URL, so the shopper can click on either to visit this link. (Note: If you have a detail page for the item, you may want to copy the "order" button HTML code to that page as well. Using any text editor, just find the HTML code generated in the catalog page for that item -- it will be surrounded by HTML comment markers identifying the Product No. and Product -- then "copy" and "paste" it wherever needed.)
Description:	This field can be used for a longer, more detailed description of the item. You can use HTML in this field, if you like. Some useful HTML "tags" are: <B> and </B>, which makes the text between those tags bold type; <I> and </I> which displays the enclosed text in italic type; and the <P> (paragraph) tag, which skips a blank line. You can also use the <FONT> tag to change the font face and color; refer to any HTML manual for details.
Selections:	The four Selections entries can be used to define "pull-down" menus to allow the buyer to select options such as size, color, style, etc. as appropriate for the item. The entries in the list may optionally specify an additional cost, which is added to the basic product cost if those options are selected by the customer. Either or both may also be used to provide the customer with a text input box instead of a pull-down list, to handle special descriptive information such as names that are to be placed on a product. Note: The format of this entry is very important in order for the pull-down lists to function properly. When defining a pull-down list, the entry for the Selection can begin with an identifier followed by a colon (for example, "Size:" or "Color:"), to specify what is being selected. (On the item page, the pull-down list will be labeled with "Select Size:", "Select Color:", etc.) Following this identifier, the available selections should be listed, separated by commas. For example, a complete Selection entry might be "Color: Red, Blue, Green" or "Size: Small, Medium, Large, X-Large". Note: The buyers selection(s) will be added to the end of the Product description shown in the order listing (for example, "T-Shirt; Size:Medium Color:Blue"). There may be cases where you do not need or do not wish to use the colon-delimited identifier, because the selections are simply self-explanitory options. In that case, omit the colon-delimited label and just list the options separated my commas. (These options will appear in a pull-down list labeled simply as "Select:".) If one or more of the options is a Selection list have an additional cost, over and above the basic cost of the product, you can specify the additional cost directly in the option. This is done by placing the word "Add" (which must be spelled with an uppercase "A" and lowercase "dd") in the option, followed by a space and a "$" sign, then the additional cost. For example, an entry such as, "Metal: Bronze, Silver Add $1, Gold Add $2" would create a pull-down list labeled "Select Metal:" with the three entries, which would appear in the list exactly as entered. The "Bronze" selection would simply be added to the Product description line for the item in the cart, as shown above, but if the shopper chooses "Silver", $1 will be added to the product cost, and the "Gold" selection will add $2 to the cost. (Note that the additional cost will be removed from the text when the selection is added to the Product description line, but it will automatically be added into the Price Ea. column.) You can also use any or all four of the Selections to create an input box where the customer can enter some sort of special text or description, instead of a pull-down list. To do this, enclose an appropriate prompt for the desired text inside of "[" and "]" (square bracket) characters. For example, "[Your Name]" would create a text entry box labeled "Enter Your Name". (You cannot combine the text input box with the pull-down list in the same Selection, but you can use one pull-down list and one text input box for a single product.)
Shipping Cost:	For each of the Shipping Options that you define in the Merchant Information section, you can set a Shipping Cost for each item. The numbers assigned to these Shipping Cost fields in the Item section (1, 2, and 3) correspond to the numbers assigned to the Shipping Options fields in the Merchant Information section. Note that there are two boxes, with a "+" sign between them, for each shipping option. The first box is a "base" shipping charge that will be applied once regardless of the quantity of the item that the customer orders. The second box, "per qty", is to specify a per-item shipping charge (i.e., a charge that is multiplied by the quantity ordered). Both the "base" and the "per qyt" charges may be used, or either one can be omitted. For example, if you have a fixed shipping charge for each item (that is, the charge should be multiplied by the quantity), you can omit the "base" cost and put the entire per-item shipping cost in the second box. This is the simpliest method to use. On the other hand, you may want to add only a small charge, or no extra charge at all, for extra quantities of a small, light item. (This would be the case if the entire order can be shipped in a single package, and additional quantities do not add much extra cost.) In that case, you can use just the "base" charge with no "per qty" for a flat cost, or you can add a small "per qty" charge. (There is also a way to apply the base charge for a specified multiple of the item, to handle the case where 1 up to some limit number of the item can be shipped together, but over that number requires another package. This method is explained below; for now, assume a single base shipping charge.) For each product, the total shipping cost will be the cost in the first box (if any), plus an amount calculated by multiplying the ordered quantity for that item times the cost in the second box (if any). Note that the shipping cost for a single item will, therefore, be the sum of the two boxes. A frequently asked question is, "What if I want to charge $5.00 for the first item and $1.00 for each additional item?" In that case, use 4 for the "base" charge and 1 for the "per qty." charge, and the first item will simply be the sum of the two charges. The input box pair that will be used to calculate the shipping will depend on the numbered Shipping Option that the buyer selects on the cart page. Important Note: The number of Shipping Cost entries that you make for each item must be exactly the same as the number of Shipping Options that you specified in the Merchant Information section. Also, if you are going to create several catalog pages, you must be careful to specify the same Shipping Options on all pages, and a matching number of Shipping Cost entries for all items. Otherwise, the final shipping calculation for all items will depend only on the shipping options on the page that was last used to order an item, which may be incorrect for items selected from a different page. Important Note: If you have several different items that have the same base shipping rate, that base rate will be charged only once, but the per-item charge will be calculated for each group of items. That is, the program assumes that different items with exactly the same base shipping rate can be shipped together, so the base charge will be applied only once for all the items. (However, the per-item charge will be calculated for each of the different items, as expected.) If that is not what you want to do (i.e., the different types of items will be shipped separately, so the base charge should be applied for each type of item), you will need to make the base rates slightly different for each type of item, even if the difference is only one cent. On the other hand, if you do want to consolidate different items into the same shipment with a single base charge, you must make the base rates the same for the different items. (This consideration only applies to the base rates; the per-item rates can be different.) As mentioned above, there is also a feature provided so that each shipping cost can be applied to some multiple of the quantity, rather than each item. This is primarily intended for the case when you can ship more that one item in the same package, and the cost of that package is the significant cost (i.e., you don't want to simply charge a per-item cost), but there is a limit to the number of items that you can ship in the same package. Above that limit, you need additional packages, so you want to charge for them. For the base shipping charge, this kind of calculation can be indicated by placing a slash ("/") after the charge, followed by the quantity multiple that the charge should be applied to. For example, a base charge entered as "5/10" means "$5 for each 10 items, or fraction thereof." This would indicate that the base charge is $5 for quantities anywhere between 1 and 10 items, or $10 (2 packages at $5 each) for quantities from 11 to 20, and $15 for 21 to 30, etc. If you use this method for the base shipping charge, you can still enter a per-item cost in the second field, or you can leave it blank, as appropriate depending on what you will have to pay for shipping. For example, if you are paying for the total weight of the package, you can make the base charge just enough to cover the basic packaging, set the multiple to the maximum number of items that can be shipped in that package, then set the per-item cost to be enough to cover the shipping cost that you will actually pay for each item. Like the standard usage of the base charge, different products that have the same "per-multiple-quantity" base charge will be consolidated. For example, if you have two different products that both have "5/10" for their base shipping charges, then the program assumes that they can be shipped together, so the total quantity used for the shipping calculation will be the total of the quantities for both products. Therefore, if the quantities ordered for both products, added together, is 10 or less, the total shipping will only be $5. If that isn't how you want the charge calculated -- you want the products calculated separately -- then you will need to make either the charges or the multiples slightly different. If that is the way you want the charge calculated, you need to be sure that the charge is entered exactly the same for both products (for example, without any spaces because "5/ 10" will appear different from "5/10", and with the same cents if any, because "5/10" will appear different from "5.00/10"). (Note that you could actually use those techniques to make two products "appear" to have different rates, even though the values are really the same, but if you do that, be careful!) The "per qty" box can also have a "/" to make it a per-multiple-quantity charge, whether or not you specify a base charge. Similar to the base charge with a slash, this causes the charge specified before the slash to be applied to the mulitple of the quantity specified after the slash, or fraction thereof. The calculation for this type of "per qty" actually behaves like the base charge with a "/" and a quantity, but you can use both with different rates and with different quantities.

How To: Create Your eMartCart Legacy Premium Service Catalog Page

Create your catalog page now!

Also, please read: How eMartCart Works