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.
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.
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…
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.
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”).
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:
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).
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.
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.
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 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.
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 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.
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.
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.
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:
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.
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
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
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.
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 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.
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
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;
}
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:
pcv_strUseEnhancedViews = True
pcv_strUseEnhancedViews = False
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:
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:
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:
Let’s review each of the settings that are located in this area of the Add/Edit product page:
Stock
Enter the current stock level for this product. This is an optional field, which can help you manage your inventory. If a product is out of stock and you have selected the Show Out of Stock option under Store Settings > Miscellaneous, then the product details page on your store will display an Out of stock message unless the product allows back-ordering. If back-ordering is allowed, the message is replaced with Typically Ships in .. Days.
You can use the Import Wizard or the Update Inventory Levels feature to update the stock count for multiple products at once.
When a customer tries to order more than the quantity in stock, a message is shown indicating that only N units of that product can be ordered. For example, if there are 5 units in stock for product XYZ, the customers enters 6 in the quantity field, and tries to add the product to the cart, a message will notify him/her that there are only 5 units in stock. This is true both when the product is added to the cart and when the quantity is updated on the View Shopping Cart page. These features prevent a customer from checking out with a quantity that exceeds the current inventory levels. The inventory levels are updated immediately after an order has been placed (even if the order is still Pending).
Units to make 1 lb (or 1 Kg)
If a product weighs less than one ounce or less than one gram, use this field to specify how many units of this product it takes to weigh 1 pound or 1 kilogram. This feature allows you to properly calculate the order weight when a single unit of the product weighs less that the lowest weight unit accepted by ProductCart, which is 1 ounce or 1 gram.
For example: how heavy is a business card? There are many products that have a weight that is smaller than an ounce or a gram.
In the field, enter the number of units of the product that will weigh one pound or one kilogram. For example, assume that 250 business cards weigh 1 pound. You would enter 250 in the field. When a customer orders 2,000 business cards, ProductCart will know that the total order weight is 2,000 : 250 = 8 lbs.
Use this feature in conjunction with the Minimum Quantity to Buy setting to ensure that customers order at least N units of the product.
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.
You can specify that a shipping surcharge be added to the total shipping charges for an order.
Current feature limitations:
No Shipping
If you check this option, the product will be considered a non-shipping item. If this is the only product in the shopping cart, the shipping rates selection page will not be shown.
If this option is unchecked, but the product’s weight is set to zero, shipping charges that are based on the order weight will also not be shown during checkout. Note that this setting applies to all shipping charges based on the product’s weight. If you would like to configure individual shipping services for “free shipping”, please consult the Shipping Options section.
If the product that you are adding to the catalog is a Downloadable Product, delivered only electronically, then you should check this option so that the shipping rate selection page is skipped during checkout.
Not for Sale
That are many reasons why you may want to display a product in your catalog, but not allow store customers to order it. For example, the product could be “Coming Soon”, or “Discontinued”, or available for sale only through telephone orders. Check this option if your product falls in these or similar categories.
When this option is checked, the “Add to Cart” button will not be displayed. In addition, ProductCart will not show product options, custom input text fields, and the quantity field. Instead, the text that you enter in the “Display Text” input field will be displayed (e.g. “Call us to order this product”, or “Coming Soon”, etc.).
The difference between a “Not for Sale” product and one that is “Inactive” is that an inactive product will not be displayed at all in the catalog, but “Not for Sale” products will.
New in ProductCart v4.1 is the ability to override the “Not for Sale” property at the ”Customer Pricing Category” level, which allows you to implement creative business models such as creating a ”Private Shopping Club”. You can also hide prices when products are Not For Sale.
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:
Expiring URL
The download link provided to customers (e.g. thru confirmation emails, pages containing details about previous orders, etc.) never points to a file. Rather, it contains code that allows ProductCart to locate the file that needs to be downloaded, and check whether or not the customer’s eligibility to download the file has expired. In other words, you can set the download URL provided to a customer to expire after N days (each download URL provided to any customer is unique).
If a customer clicks on a link that has expired, the file download process is never started. So regardless of whether or not the Hidden URL feature mentioned above is in use on the store, the file location cannot be determined. This security measure attempts to limit the damage that a digital product publisher would suffer in scenarios such us a URL being illegally sent to multiple individuals via e-mail or posted on a Web page without authorization. Even if the URL is posted on a Web page without authorization, it would be rendered useless after the N days have passed.
License Delivery
A license containing up to 5 pieces of information can be delivered to the customer with the purchase of a Downloadable Product. Many publishers of digital goods protect the unauthorized use of their products by requiring that the customer enter some type of unique license upon installation (e.g. software) or fruition of the product.
Since the type of license needed to unlock/use a digital product varies dramatically from product to product, and from publisher to publisher, the Downloadable Products Module (DPM) within ProductCart was engineered to be as flexible as possible with regard to how license information is generated.
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:
License Field Descriptions
Your license generator can return to ProductCart up to five variables. Please refer to Appendix A for a technical overview of how this is achieved. Here you can enter descriptive names for those variables. These are the names that will be associated with the variables’ values when the license information is delivered to the customer (e.g. order confirmation email, previous order details page, etc.). Leave the field(s) blank if you do not plan to use it.
For example, if your product license is made of three pieces of information (e.g. Serial Number, User Name, and Password), you would enter the corresponding descriptions in the first 3 fields, and leave the other 2 blank.
Please note the following about how other product settings are affected by a specific product being a downloadable product.
Please see the section that covers Gift Certificates.
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.
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.