eMartCart powered by eMartCart
  DEMO |  FAQ |  FORUM  |  HOME   

How To: Create Your eMartCart Catalog Page

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.

 Merchant Information
Your E-mail: This is a required field, and it must 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.
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.)
Tax Region: 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. Important Note: If you are going to create several different catalog pages, you must be careful to specify the same Tax Region and Tax Rate 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 rate for your Tax Region, 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.
Shipping Option: If you wish to offer your customers up to nine 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. (Note that the shipping rates are not specified in these fields. Rates are set for each item when you enter the items.) 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.
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 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. It is best to use the full URL, e.g., http://www.yourdomain.com/yourdirectory/logo.gif, so that the graphic will be loaded regardless of the location of the page HTML. However, you can also use "relative" URLs when the catalog page HTML file and the graphic file are on the same site. For example, if these files are on the same site but on different directories, you might use something like /yourdirectory/logo.gif (specifying the Web directory path and file name), or if these files are on the same directory, you can give just the name of the image file, logo.gif. (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://...".)

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.
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 if the payment is canceled. If the Thank You URL is not specified (see next form entry), this URL will also be used as the "Continue" link in PayPal after the payment is successfully processed. Note: This URL must always be given as the full URL, such as http://www.yourdomain.com/yourdirectory/page.htm, because relative URLs will not work to return the user from either the shopping cart or the PayPal site.
Thank You URL: This URL will be sent to PayPal to use as the "Continue" link on the payment page after the payment has been successfully processed. (Any "Cancel" button clicks before that will send the customer back to the Return URL; see above.) If this URL is specified, it should always be given as the full URL, such as http://www.yourdomain.com/yourdirectory/page.htm, because relative URLs will not work to return the user from either the shopping cart or the PayPal site. To accommodate certain affiliate programs, the Thank You URL can reference a script instead of an HTML file. In this case, it is possible to send the amount of the order to the script using a URL variable. That is, if the characters "@amount@" are found anywhere in the Thank You URL, that reference will be replaced by the amount of the order (shipping not included). For example, the URL could be something like this: http://www.anydomain.com/cgi/somescript.pl?amt=@amount@
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. Note that PayPal currently supports only US dollars for prices. (However, that is expected to change when PayPal begins accepting international payments.)
Sale? Check this box to put the words "Sale Price:" in front of the item price in the listing.
Fixed Qty.: This field should only 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. 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 "product"). If you put a 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 this field is not set (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.
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 and the Product Number will be the only fields shown on the order to identify the item, so make sure that the combination of the two 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 does not exceed 36 characters.
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.
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.
Selections: The two 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. Note: The format of this entry is very important in order for the pull-down lists to function properly. The entry for each 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:".)
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. (That is, the numbers assigned to these Shipping Cost fields in the Item section 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 cost. The first box is a "base" shipping charge that will be applied regardless of the quantity of the item that the customer orders. The second box is to specify a per-item shipping charge (i.e., a charge that is multiplied by the quantity ordered). Both of these charges may be used, or either one can be omitted. For example, you may want to add only a small charge, or no extra charge at all, for extra quantities of a small, light item. On the other hand, if you have a fixed charge for each item, you can omit the "base" cost and put the entire per-item cost in the second box.

For each item, 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.

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. (This consideration only applies to the base rates; the per-item rates can be different.) Note that the entries must be exactly the same: "5" will not be recognized as the same thing as "5.00". If you do not what to consolidate the base charges (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, or you could intentionally use "5" for one item and "5.00" for another, to make them appear different to the program.

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.


Also, please read: How eMartCart Works

Copyright ©2002-2003 Longhair Technologies, Inc. All rights reserved
Notice: eMartCart ® is not affiliated with PayPal or X.Com except for standard referrals