Table of Contents

Adding a New Product

Adding and Editing Individual Products

ProductCart includes many ways to add and edit multiple products at once, such the Product Import Wizard and the Global Changes features. Of course, you can also add and edit individual products, and that's what this section of the ProductCart WIKI focuses on.

Below you will find a description of each of the settings that can be found on the Add/Modify Product pages. To get started, select Products > Add New Product from the Control Panel navigation.

New Tabbed Layout

ProductCart v3.5 and above include a new layout for the add/modify product pages. All the information has been reorganized in easy-to-navigate sections controlled by tabs organized vertically on the left side of the page.

New tab-based layout for the Add and Modify Product pages

Choosing a Category

The first step in adding a new product to your database is choosing the category that the product belongs to. ProductCart supports unlimited category assignments for any products, but here you need to specify the first category that the product will belong to. You can add others later.

You can…

You can add a new category on the fly when adding a new product

When you add a new category, the list of existing categories will be instantly refreshed to list the newly added category. Select it from there and move on to the next section.

Name and Descriptions

SKU (which stands for Stock-Keeping Unit and is also referred to as the Part Number), Name and Description are required fields. The Short Description is not required. Product Notes is a new field in ProductCart version 3.5, and is for administrative purposes only (e.g. you can leave a note for another store administrator: “The product descriptions need to be updated”).

Stock-Keeping Unit (SKU)

Enter the product SKU or Part Number, which typically is a combination of letters and numbers. Note that the database will also automatically add to each product a unique Item Number, which is not displayed on this form. The Item Number uniquely identifies the product in ProductCart's database. The SKU, instead, is your own product identifier.

The maximum number of characters that can be entered in this field is 50 for stores powered by an Access database, and 100 for stores powered by a SQL database (alphanumeric characters).

ProductCart does not enforce unique SKUs. However, if you enter a SKU that has already been assigned to another product, the system will notify you. It is then up to you to decide whether to modify the product and replace the SKU with a unique one or keep the existing one. We recommend that you use unique SKUs for several reasons. Among them:

Product Name

Enter the product name. The maximum number of characters that can be entered in this field is 100 (alphanumeric characters). We recommend that you do not use any HTML in the product name. If you want to style the way product names are shown in the storefront, use the CSS file “pcStorefront.css”, which contains several styles that affect the way product information is shown (see the comments inside the file itself for more information).

Description

Enter a description for the product. This is the description that will be displayed to your store visitors when they opt to receive more details on a certain product. For example, if they run a product search, the shopping cart will return N items on the search results page. If they click on More Details next to any of the items, they will be shown a page that displays the product description that you are entering here (together with the general image and other product information).

The database allows an unlimited number of characters for this field (both Access and SQL).

If you enter a Short Description for the product, the long description is shown at the very bottom of the product details page. The short description is shown at the top of the product details page, and a text link to the long description is added automatically at the end of it.

HTML Editor

You can use any HTML tag to format the text in this field. For example, you can use the <b>word</b> tag to make a word bold. This also allows you to link to other pages on your Web site, display additional product images, etc. To enter an HTML description, click on the Use HTML Editor button. You can then either paste your own HTML code or use the built-in HTML editor.

When using the HTML editor, make sure to save your work by clicking on the Save button in the HTML editor window. You will be returned to the Add New Product page, where you can continue configuring the rest of the product settings.

Generally speaking, you should avoid pasting complex HTML code into the product description field because it could generate conflicts with the rest of the code generated by ProductCart.

Using JavaScript and ASP in the Description

Short Description

The short product description is an optional field that can help customers more easily browse the store. As mentioned in the Display Settings section of this User Guide, the short product description is shown in many of the browse & search pages. It is also displayed at the top of the product details page, with a link to the long description. This ensures that all relevant buttons (e.g. Add to Cart, Add to Wish List), menus, and fields (e.g. option menus and custom input fields) are displayed at the top of the page.

If the short description is not present, the long description is shown at the top of the page, and no product description is shown on the browse/search pages.

Although you can use HTML tags in the short description, you should not use complex HTML tags there because of the location of the short description throughout the store and the conflicts that it could create with the surrounding code. In fact, if possible, you should limit the use of HTML code to basic, font-formatting tags such as <strong>, <em>, and alike.

Product Notes

Product Notes is a new field that was added to the Add/Modify Product pages in version 3.5 of ProductCart. It is strictly for administrative purposes. Its content is never shown in the storefront. For example, it can be used to leave a note for another person contributing to updating the same products.

Product Prices

Main Price Fields

In ProductCart you can specify multiple prices for a product. In the image shown below, you can see how this product has several different price levels associated with it. The first 3 apply to any product. They are:

You can use the Global Changes feature to quickly assign wholesale prices to multiple products if the wholesale price is a function of the online or the list price. You can also use the same feature to recalculate the online price based on a function that uses the list price, wholesale price, or the product cost.

ProductCart supports unlimited pricing levels

Additional Product Prices

ProductCart allows you to add unlimited other pricing levels to your store through a feature called Pricing Categories. Please refer to the Pricing Categories section of this User Guide for details on how to create and manage a pricing category.

Here we want to draw your attention to the fact that can override the default prices for a pricing category at the product level, as shown in the picture above.

Categories

The Categories tab is only available when you are editing an existing product. If you are adding a new product to your e-commerce store, the tab will not be shown as you are choosing a category at the top of the page, as described above.

To give you maximum flexibility, ProductCart allows you to assign a product to multiple categories. This means that you can create multiple “category trees” to allow your customers to browse the store in a variety of ways. For example, a toy store could create several different category trees based on the idea that customers may want to browse the store “by age”, “by occasion”, “by type of toy”, etc.

A product can belong to unlimited categories, but it must belong to at least one. To select more than one category, press the CTRL key on your keyboard as you select categories using your mouse. To manage categories and subcategories, see Create and Modify Product Categories.

Once you have added the product to the store, the quickest way to assign it to multiple categories is to modify the product by selecting Details after locating the product in your catalog. On the page that is displayed, scroll down to the middle of the page where the category assignment is shown, then click on Edit Category Assignment. A pop-up window will allow you to easily check or uncheck the categories that the selected product should be assigned to or removed from. When you are done, click on Update and you will be returned to the product details page.

Note about hidden categories: typically, if you assign a product to a hidden category, the product will not be shown in the storefront (even if you later assign it to a visible category). However, if you assign the same product first to a visible category, and then to a hidden category, the product will be visible.

Images

Overview

ProductCart supports unlimited product images. New in ProductCart v3.5 is the integration of a popular set of image display tools for better handling image galley display (HighslideJS).

There are three “main” images. The Thumbnail Image image is used in product searches, when you browse the store by category and in other pages where a small product image is shown, unless you choose a display setting that does not use product images. The General Image is shown on the product details page. The Detailed View Image is opened in a separate window to provide a closer look at the product.

Recommended sizes

How to upload images

ProductCart assumes that all images used for products and categories are uploaded (or will be uploaded) to the directory pc/catalog on your Web server. There are three ways to upload an image to your store:

  1. Upload previously edited images via the Upload Images feature.
    Refer to Getting Ready to Add Products for details about image sizes and formats. If you haven’t already uploaded images to your server, you can do so by using ProductCart's automatic upload component, accessible either by selecting Upload Images from the Settings menu, or directly from the Add New Product form, through the text link next to the image fields.

    To upload images using this component, Browse your computer until you locate the file(s). You can repeat this task for up to 6 images at the same time. When you are done locating the file(s), click on Upload to automatically move them to the right directory on your Web server. You will receive a confirmation message indicating that the upload was successful. For security reasons, you cannot upload any files other than JPEG and GIF images. If you attempt to upload any other files, you will receive an error message.

  2. Upload previously edited images via FTP. To upload images to your server you can also use any FTP program. This is the recommended method if you are planning to upload a large number of images at the same time (or if you are uploading large image files).

    Many FTP programs are available in the market, some of them free of charge. In addition, your Web hosting service provider may have some for you to download as well. For a list of good FTP programs available for download - for instance - you could run a search for “ftp” on a Web site such as http://www.download.com

  3. Upload unedited images via the Upload & Resize feature, described below.

The Upload & Resize Feature

The Upload & Resize feature allows you to take one image, and automatically create the thumbnail, standard, and detail view images for your products (it also works with category images). This feature can save you a significant amount of time when adding new products and categories to your store. It’s one the most popular features among ProductCart users

The Upload & Resize feature is only available when your Web server has the software components that are needed for it to work. Please review the ProductCart System Requirements for more information

When adding, cloning, or editing a product, select the upload & resize text link to load a window where you can enter settings specific to the task.

A progress bar will show you the file being uploaded to the server. When the process has ended, you will be shown the three new image file names, hyperlinked to the images themselves. Click on any of the links to see the images. At the same time, ProductCart has also populated the three image input fields on the page with the newly created file names. Close the window to return to the Add/Modify Product page.

Behind the scene, the upload & resize utility performs the following tasks.

  1. Uploads the source image to a temporary directory in the includes folder called uploadresize. The source file is automatically deleted from this folder after these tasks are completed.
  2. Creates the three files mentioned above, adding a descriptive suffix to the file name to differentiate them. The files are then saved to the pc/catalog folder.
  3. Copies the file names to the input fields on the page from which the utility was launched (i.e. add/clone/modify product pages).

Common problems: If you are having problems with this feature, errors might be occurring, but they might be hidden by ProductCart’s “error trapping” code. A very common source of problems is the fact that the license of the components used for this feature has expired. Please ask you Web hosting company to confirm that the licenses for the image components are current. See the note below about which image components are necessary. Another common source of problems is that folder permissions are not properly set.

Locating an existing image

If you know that the image that you would like to use for any of the image fields shown on the add/modify product page is already on the Web server (e.g. you already used it for another product, or you transferred all of your graphics already via FTP), click on the search icon to graphically browse through the images in a pop-up window.

ProductCart includes an advanced image search feature that allows you to quickly locate an image file that was previously uploaded to the pc/catalog folder. This feature is especially useful if you transfer your images to the Web server using an FTP program. You might be uploading hundreds of images that way. How will you find the image you need when you add or edit a product? ProductCart will help you quickly locate the image you are looking for.

Searching for an image requires that you first index your image directory (the pc/catalog folder). You should perform this task every time you have uploaded new images to the store. If you cannot find an image that you know is there, try running the indexing feature again. Depending on how many images are stored there, indexing may take from a few seconds to over a minute.

Click on the Index Now button to create a searchable index of all the images contained in the folder. Once your pc/catalog folder has been indexed, the image search feature will allow you to easily locate images in the folder. Use any of the filters on the page to narrow your search.

An AJAX-driven search preview tool will tell you how many results your search will return, so you can adjust your filters before actually performing the search.

On the search results page, click on an image or image name to view its actual size. Images are automatically resized to better fit into this window, and therefore may appear distorted. Click on the Select button to copy the image file name to the image field that was next to the search icon that you originally clicked on to start the search.

Additional Product Views

Additional Product Views allow you to showcase additional product images to help your customers get a better idea of how a product looks. You can upload an unlimited number of images. The additional images are shown on the product details page (pc/viewPrd.asp), as shown in the image below.

Additional product views is a useful feature to let customers learn more about your products

Number of Thumbnails

A thumbnail for each additional image is shown below the main product image. Three thumbnails are shown per row. This value is hardcoded into the ASP source code of the pages pc/viewPrdCode.asp and pc/viewPrd.asp. The code change to alter this setting is the following (change the number 3 with another integer):

if pcv_intProdImage_Columns="" then
 pcv_intProdImage_Columns = 3
end if

Size of the Thumbnails

The size of the thumbnail is set using CSS. This means that you do not need to create and upload a thumbnail for the Additional Product Views: the browser will automatically resize the General Image to the width and height defined in the main ProductCart CSS file.

Specifically, the CSS document pc/pcStorefront.css contains the following code (the height was not defined before ProductCart version 3.5 and pcStorefront.css is not included in ProductCart updates since it is often customized):

#pcMain .pcShowAdditional img {
 width: 50px;
 height: 50px;
 border: 1px solid #cccccc;
 margin-bottom: 6px;
}

General and Detail Views

When the height of the additional views is different, there is an interface issue on the product details page. That is: the section of the page that contains the thumbnails “jumps” to accommodate the taller or shorter images above it. On FireFox, this also creates flickering on the thumbnail views. Here is a solution.

Slideshow and Enhanced Views

Starting with ProductCart version 3.5 all image pop-ups have been replaced with modal windows. Modal windows are a Web 2.0 approach to pop-up windows in that they offer many advantages over the old style pop-up windows. The images are displayed within the active window avoiding complications with pop-up blockers. The windows have a toolbar that allows the shopper to view product images and additional product views as a slide show.

The modal windows in ProductCart are built on top of the popular Highslide framework. The framework is enabled by default in ProductCart version 3.5. You may turn the framework off and revert to using the old style pop-ups with one small code change.

To use the old pop-ups, do the following:

  1. Go to the pc directory via FTP and download the file viewPrdCode.asp
  2. Open the file in Notepad or with your favorite HTML editor
  3. Locate the following string: (around line 20)
    pcv_strUseEnhancedViews = True

  4. Replace with

    pcv_strUseEnhancedViews = False

  5. Save the file and re-upload it to the Web server.

The Highslide slideshow feature is not currently available with Apparel products. The slideshow buttons will be hidden in the Apparel product's image.

Image Magnifier (MojoZoom)

ProductCart now supports an image magnifier (built using MojoZoom). The feature allows the customer to zoom into an image by simply mousing over the regular size product image. The tool automatically adjusts itself depending on whether the product image is on the left or right side of the page. You can activate this feature by checking the corresponding checkbox in the Images section of the add/modify product page.

For example, you can see it at work on one of the ProductCart demo stores:

MojoZoom image magnifier with product image on the right

Inventory Settings

Inventory Status

ProductCart contains a number of inventory-related features. Use the Store Settings page to set general inventory settings, such as whether or not inventory levels should be shown on the product details page, whether out of stock merchandise can be purchased or not, and whether an out of stock message should be displayed.

When inventory is tracked (products that are out of stock are not available for sale), there are three inventory statuses that a product can be in:

How back-ordering information is shown in the storefront

For example, if you setup a product with 18 units in stock, allowing back-ordering, indicating that it is typically restocked every 7 days, and setting a low inventory notification at 10 units, then your ProductCart-powered e-commerce store would behave as follows:

The three inventory statuses listed above become irrelevant when:

Product-specific Inventory Settings

Let’s review each of the settings that are located in this area of the Add/Edit product page:

Weight and Shipping

Supplier and Drop-Shipping

Weight

Oversized Settings

Setting a product as Oversized makes ProductCart replace the default package size with the package dimensions entered here. Please see the Shipping Options section for more information about entering default package dimensions for your shipments. For now, note that “length” should always be the longest dimension.

In some cases (e.g. UPS), oversized items incur extra shipping charges. However, if you set a product as Oversized, but the actual package weight and size do not fall into the oversized category, the shipping provider will return the correct rate.

Another consequence of enabling the Oversized option is that when you set an item as oversized, it will automatically be handled as a separate package when calculating shipping charges. ProductCart allows you to handle multiple package shipments to more accurately calculate shipping rates on your orders.

Shipping Surcharge (v4 Only)

You can specify that a shipping surcharge be added to the total shipping charges for an order.

Current feature limitations:

Other Settings

Downloadable Settings

Digital Products and Security Issues

ProductCart has the ability to flexibly handle the sale of electronically delivered products. We refer to these products as Downloadable Products or Digital Products (DP). What is common among all downloadable products is that a download link must be delivered to the customer once an order has been processed.

Publishers of digital products are typically concerned about delivering the download URL to the customer due to the fact that the link can be easily provided to other, unauthorized users.

Companies often protect themselves from the unauthorized download of a digital product by adding barriers to the use of the product after it has been downloaded. For example, many software applications require the user to enter a valid License Key or Serial Number upon installation.

ProductCart attempts to address both security concerns (unauthorized download and unauthorized use after the download has taken place), through the following features:

Limited Applicability of Hidden URL feature. The latest versions of Microsoft® Internet Information Service (IIS 6 and IIS 7) contains a structural limitation to server-side file buffering. Only files that are smaller than 4 MB in size can be buffered. This limits the applicability of the Hidden URL feature only to files that are smaller than 4 MB on servers that use IIS 6 or 7. If your Web store is hosted on a Web server that runs IIS 6 or 7, you have two options: (1) contact the hosting company about the possibility of changing this limitation to a larger file size; (2) enter a HTTP location for the downloadable file, rather than a physical location: when you do so, ProductCart automatically ignores the Hidden URL feature when generating the download link. If you enter a physical path to a file larger than 4 MB on a server running IIS 6, when you click on the download link a 0 K file will be downloaded (the file was not buffered).

Adding and Editing a Downloadable Product

To add a Downloadable Product to your store, select the Downloadable Settings tab on the Add/Edit Product page. A radio button toggles the setting on and off. Select “Yes” next to the “This is a downloadable product” radio button and a number of new fields will appear. Here is a description of each of them:

Digital Products and Other Product Settings

Please note the following about how other product settings are affected by a specific product being a downloadable product.

Gift Certificate Settings

Please see the section that covers Gift Certificates.

Custom Search Fields

This section, new in ProductCart version 3.5, allows you to quickly associate Custom Search Fields with the product that you are adding or editing. See Managing Custom Search Fields for more information.

Product-specific Meta Tags

ProductCart allows you to enter product- and category-specific Meta Tags to provide search engines with more accurate information on what is found on the page. Although they are no longer the main element used by search engines to rank Web sites, well written Title and Description meta tags can certainly contribute to good search engine rankings. The “Keywords” meta tag is less frequently used.

The Meta Tags that you enter when adding/editing a product or a category will be written to the corresponding category or product page in your storefront only if the file include-metatags.asp is used in pc/header.asp. Make sure that pc/header.asp does not contain hardcoded meta tags (or you will end up with duplicate tags), and refer to the section that talks about integrating ProductCart with your Web site for more information.

If someone else created the file header.asp for you, you can check whether ProductCart is able to writing meta tags dynamically to the page by simply visiting your storefront and moving from one product page to another: does the title of the browser window change? That’s the text at the very top of your browser window. If the title changes, then header.asp has been properly configured.

If you have a large number of products and/or categories and cannot write Meta Tags for each for them, don't worry. ProductCart will dynamically create the Meta Tags for you by using the product name for the Title tag and a portion of the product description for the Description tag.

Learn more about how ProductCart handles Meta Tags.