SurfShopCart Documentation

Setting Up Shop Has Never Been Easier!

User Tools

Site Tools


adding_and_modifying_products

Adding and Modifying Products

Items must exist in the catalog database before you can present them for sale on your website. To add or modify items in your SurfShop™ catalog database, go to admin.cgi and select “Edit Catalog.”

You will see a list view of your current catalog which you can navigate, 20 items at a time. From this page you can:

  • Search for specific Catalog Items
  • Add New Catalog Items
  • Delete Catalog Items
  • Mark Catalog Items as taxable
  • Mark Catalog Items as “Hot Items” to be rotated on the website
  • Assign Catalog Items to specific Categories
  • Add, delete, or rearrange categories
  • Import/Export Records
  • Add/Delete Database Fields (Advanced users only)

To modify an existing item, click the link under the “Item ID” heading.

To add a new item, click the button labeled “Add Catalog Item”

Either option opens a new window to edit a single Catalog Item. Here you can enter values for each of the following fields.

Product Fields

itemid

Unique identifier (SKU) for the item. This field can contain only letters, numbers and dashes (-);

description

Name or short description of the item

long_desc

Long text description of the item. This field can be up to 1k in length and can contain HTML. A shortened version (the first 256 characters) of this text appears in the search results when using a single column. Be sure that any HTML tags used within these first 256 characters are also closed within the first 256 characters or the search page will not display properly.

Retail Price, Wholesale Price, Member Price

Unit price of the item. If using tiered pricing, the teirs are entered here.

Specials

You can assign a special price to be given during a period of time. The field works the same way as the Retail price field.

Start Date and End Date

Beginning and Ending dates for the Special Price, above.

setup

Quantity-independent price modifier. This field is not multiplied by the quantity in the final order, so it can be used to add a “set-up” charge for an item. Example: if your item is a T-Shirt and the cost per item is $3.50, with a single screen charge of $20.00, you would enter $20 in this field.

shipping

This field contains shipping charges that are added to the total shipping charge. It can be tiered by quantity in the same way as the unitprice field, above. You can enter specific charges for each shipping method offered, or a generic charge that is added to all shipping methods. See “item-specific shipping charges,” below.

weight and volume

These fields allow items to be quantified by weight or volume in the calculation of shipping charges. They are optional and do not affect the system in any other way.

taxable

This field flags whether an item is non-taxable. When calculations are made on “taxable” items, items in the customer's order that are flagged with this value will be excluded.

categories

This field assigns a catalog item to one or more categories for searching purposes. Categories can be tagged as “sub-categories” so that any item that is a member of a “sub-category” is also a member of it's “parent” category.

QuickBooks Income Item

Select the category that corresponds to this item's Income Account. QuickBooks Note: QuickBooks will automatically create new income accounts for any categories you select in this field if they do not already exist. Please make sure the category name matches exactly as it appears in your QuickBooks file.

link

This field allows you to display a specific web page in lieu of the page that is automatically generated by the program when an item is selected from a list of search results.

option1-3

You can create up to three (3) separate lists of options pertaining to a single catalog item. See Product Options, below.

image

This is the URL path for the “thumbnail” image associated with a catalog item.

large_image

This is the URL path for the “full-size” image associated with a catalog item.

Example:

/ssimages/store/bigchair.gif

By default, SurfShop™ only allows images that are stored on the same web server as the store. For this reason, only paths consisting of a slash, followed by the path to that image file will appear when using the default installation. You can change this by customizing the output templates. See “Customizing Output.”

Notes

This value is not displayed to the customer anywhere in the order process. This allows you to record information about a product that you may not wish the customer to see, e.g., a vendor's name.

Related Items

List the itemid's of other catalog items you wish to have displayed when the customer selects this item, separated by commas. The related items are shown at checkout and when an item detail is viewed.

Example:

123dogbis,124dogbis

hazardous

This field lets you identify shipping methods which cannot be used to ship this item. The menu will consist of shipping methods you have created in your calculations admin. For example, if this is a flammable item, you may wish to exclude “overnight” or “air” shipping methods.

inventory

This field lets you keep track of quantity you have of this item on hand. Inventory counts are automatically deducted when an order is placed. Note: at this time SurfShop™ cannot track counts of optional variations of catalog items. If you must track items separately, you must create separate item records.

Featured (Hot) Item

Items that are flagged as “Hot Items” are randomly rotated throughout the store as “Featured Items.” You can use this system to push clearance items or items you wish to highlight.

Featured Item Message

You can enter text or HTML in this field to appear whenever the item is displayed in the “Featured Items” area.

Product Options

You can create up to three (3) separate lists of options pertaining to a single catalog item. Examples might be “Color,” “Size,” and “Finish.” Options appear as “dropdown” menus on the item's detail page. Enter a list of options in each of the fields with the option “label” as the first entry in the list, followed be the variations available for that item.

Example:

   Color
   Red
   Green
   Blue

If you wish to apply a specific price modifier to an option, add a double equals sign (“==”) followed by the price adjustment associated with that option.

Example:

   Color
   Red==.50
   Green==1.00
   Blue==1.50

If the unitprice of the above item was $4.00, you could display the various prices in the dropdown menu like this:

   Color
   Red (4.50)==.50
   Green (5.00)==1.00
   Blue (5.50)==1.50

If you leave the “unitprice” field blank, Surf Shop uses the option 1 price modifier of the as the unit price. This way you can set up different prices for a single item based on the option selected.

  • Note: Only the OPTION 1 price modifier can be used as the unit price.

Tiered Retail Prices

The unit price can be tiered by quantity. To enter price breaks, enter the quantity at which the price changes, followed by a comma, followed by the price of that “price tier.” Price breaks must be entered one per line, in ascending order. The final price tier must be labeled “over.”

Example:

   50,100
   75,95.50 
   100,90
   over,87.50

Minimum Quantity

You can set a minimum quantity for tiered orders. Enter the price followed by a comma, followed by the phrase, “(min)” on the FIRST LINE of the input box.

Example:

   50,(min) 
   50,100 
   75,95.50 
   100,90
   over,87.50

When the item is displayed by SurfShop™ in a search, a minimum identifier will be displayed.

“50 (min) to 100”

If the item is added to a users cart for fewer than the minimum, SurfShop™ will be adjust the quantity to the minimum automatically.

Wholesale Prices

Wholesale prices can be given to customers that are marked as “Wholesaler” in the Customer Admin. The price is automatically given when the customer signs in using their password.

Use the “Wholesale Price” field to enter price breaks for wholesale customers. The price can be tiered the same way as the retail price.

Example:

   50,(min) 
   50,87.50
   75,85
   100,80
   over,77.50

If you do not wish to use special “Wholesale” pricing, leave this field blank.

Member Prices

In addition to wholesale, you can specify a price for members only. This price is automatically given when the customer signs in using their password, but is not listed as a “wholesaler” in the customers database.

Use the “Member Price” field to enter price breaks for members. The price can be tiered the same way as the retail price.

Example:

   50,(min) 
   50,90
   75,87.50
   100,85
   over,80

If you do not wish to use special “Member” pricing, leave this field blank.

Specials

Use the “Specials” field to enter special price breaks for a limited time. The special price will be shown in the product pages as a “SPECIAL” in a different typeface if the current date falls within the Special's date window.

The price can be tiered the same way as the retail price.

Example:

   50,(min) 
   50,90
   75,87.50
   100,85
   over,80

To enable the special price, both a Starting Date and and Ending Date must be entered. The special price will be active during the date window specified. Dates use the format MM/DD/YYYY.

You can set different “Special” pricing for Retail, Wholesale and Member customers.

Wholesale Specials

Wholesale specials can be given to customers that are marked as “Wholesaler” in the Customer Admin. The price is automatically given when the customer signs in using their password.

For tiered wholesale price breaks, you must use the same break points as your retail price breaks. Include the wholesale price right after the retail price, separated by a comma. Ex:

Example:

 50,(min) 
 50,100,87.50
 75,95.50 ,85
 100,90,80
 over,87.50,77.50

Member Specials

In addition to wholesale, you can specify a special price for members only. This price is automatically given when the customer signs in using their password.

Include the member price right after the wholesale price, separated by a comma. If no wholesale price is used, leave the space blank where the wholesale price would be.

For tiered member price breaks, you must use the same break points as your retail price breaks. Include the member price right after the wholesale price, separated by a comma. If no wholesale price is used, leave the space blank where the wholesale price would be.

Example:

 50,(min) 
 50,100,87.50,90
 75,95.50,,87.50
 100,90,80,85
 over,87.50,77.50,80

Item-Specific Shipping Calculations

You can designate a specific shipping charge by entering a value in the “shipping field.”

Example:

   3.00

The shipping charge can be tiered by quantity the same way as the unitprice field above, by entering a quantity on a single line, followed by its corresponding shipping charge.

Example:

   10,3.00
   20,3.25
   over,3.50

You can set specific charges for the various shipping methods you have configured in your calculations admin. Enter the shipping method name as it appears in the calculation admin, followed by a colon, followed by the associated shipping charge. You can enter as many shipping types as necessary on a single line, however in order for them to be applied, they must already exist in the calculations admin. See “Calculations” for more information.

Example:

   10,UPS:3.00,Overnight:5.50
   20,UPS:3.25,Overnight:5.75
   over,UPS:3.25,Overnight:5.75

List the itemid's of other catalog items you wish to have displayed when the customer selects this item, separated by commas. The related items are shown at checkout and when an item detail is viewed.

Example:

123dogbis,124dogbis

You can now choose how many related items you want to show across the bottom of the detail pages by entering a number in the “Number of Related Items per page” checkbox on the Default Template Options admin page. If you don't want to show any related items, make sure that none of your products contains any related items. If you don't, entering '0' in the checkbox will still show one related item.

Restricted Shipping Methods

This field lets you identify shipping methods which cannot be used to ship this item. The menu will consist of shipping methods you have created in your calculations admin. For example, if this is a flammable item, you may wish to exclude “overnight” or “air” shipping methods.

Tracking Inventory

This field lets you keep track of quantity you have of this item on hand. Inventory counts are automatically deducted when an order is placed. Note: at this time SurfShop™ cannot track counts of optional variations of catalog items. If you must track items separately, you must create separate item records.

Items that are flagged as “Hot Items” are randomly rotated throughout the store as “Featured Items.” You can use this system to push clearance items or items you wish to highlight.

Featured Item Message

You can enter text or HTML in this field to appear whenever the item is displayed in the “Featured Items” area.

To disable the Featured Items, do not set any Products as “Featured Items.”

Payloads

You can designate a catalog item as a “payload,” by appending “pld” to its itemid value. SurfShop™ automatically generates a “download link” for any payloads in a customer's order. See “Payloads” for more information.

Example:

Name of file being delivered: “surfshop.zip”
itemid of this file: surfshoppld

Gift Certificates

You can designate a catalog item as a “Gift Certificate” by appending “gft” to its itemid value. SurfShop™ automatically adds any purchased Gift Certificates to the “coupons” database for the value purchased. See “Coupons and Gift Certificates” for more information.

Example

itemid of a Gift Certificate: SpringSavingsgft

<<Main_Page Top^

adding_and_modifying_products.txt · Last modified: 2018/07/03 04:55 (external edit)