Product Setup

SmithCart > Products

Some products in your store may be services, downloads, or access to exclusive content. In addition, products might have certain properties that other products don't have such as permissions, tax or discounts. This KB article will explain the settings available on the Add Product screen.

Contents



Introduction

To access the Add Product screen, either Add a New Product or Edit an existing Product.

For detailed instructions for Adding or Editing a Product, see the Manage Products KB article.

There are 6 important settings that are required to add or save a Product:

  1. Manufacturer
  2. Product Sku
  3. Product Name
  4. Unit Cost
  5. Qty On Hand
  6. Weight

[up to contents]



Product Setup

This section will describe the Product Setup section of the Add product page.

The following settings are available in the Product Setup section:

Sort Order – The sort order field controls the order in which the products are displayed in the product catalog. Enter a numeric number from 1 to 999. The products will be sorted in ascending order by the sort order field.

Manufacturer - Select the manufacturer for your product from the dropdown list.

Product SKU – Enter your product sku or model number in this field. The product sku is typically a unique number that identifies your product for inventory purposes.

Product Name - Enter your product name in this field. The product name is displayed to the user in the product list, product detail and cart screens in the shopping cart.

Unit Cost – The unit cost is the cost you want to charge for your product. Enter your product unit cost here. If you set the unit cost for a product to zero it will enable “free checkout”. Free checkout will allow the user to add the zero cost product to the cart and checkout, bypassing the payment page where the user normally enters their credit card number.

Price Units – The cost or price of an item based on the unit of measure. If you populate the unit price field, the price per unit is displayed next to the product price on the product details page and also in the variant matrix.

Price Class - Allows for mix and match pricing by “Price Class” which allows you to group products by price class and calculate quantity discounts by price class. If “Discount Price by Role” is configured in the cart and the user is a member of the role it would override price class discounting. For more information about setting up Price Classes see the Price Class Discounts section.

[up to contents]



Sale and Member Pricing

This section will describe the Sale and Member Pricing section of the Add product page.

Sale Price – Provides the ability to set a sale price for a product. When sale price is populated the product listing and product detail pages on the front end cart will show the regular price with a strikethrough and the sale price will be displayed in red so the customer can see they are getting the product on sale.

Sale Start Date – Select the date to start your sale

Sale End Date – Select the date to end your sale

Member Price – A special price offered only to those who are registered within your DNN store.

Wholesale Price – Wholesale price will be used when calculating Sales Rep commissions.

[up to contents]



Summary and Description

This section will describe the Summary and Description section of the Add product page.

Summary – Short description of the product.

 

Product Description and Tabs:

SmithCart allows you to add up to five product descriptions for each product and also allows you to configure the tab name for each product description that is displayed on the product details page. The rich text editor is used for managing product descriptions enabling you to add regular text or html and upload photos and videos.

Tab Name 1-5 – Enter a tab label for the tabbed product description that is displayed on the product detail page. The product description tab control supports up to 5 tabs.

Description 1-5 – Enter a detailed product description using the rich text editor. HTML fully supported. The product description tab control supports up to 5 tabs.

[up to contents]



Inventory Stock Configuration

This section will describe the Inventory Stock Configuration section of the Add product page.

Quantity on Hand – The quantity on hand field is used to manage your available inventory for your product. Enter the current available product quantity you have available in your inventory. Every time a user purchases a unit of product the quantity on hand is decremented by the number of units purchased. If a product has a quantity on hand of zero or if the customer tries to purchase a quantity of product that exceeds the available on had then the cart will display an out of stock message on the cart screen and not allow the user to proceed to checkout.

Weight – Enter your product weight here. The weight field can be entered in any unit of measure you like unless you have configured your store to use the “Real Time Shipping Calculator” in the BuyNow module settings. UPS, USPS, FedEx, Canada Post and Australia Post are the carriers used by the real time shipping calculator. If you have configured your store to use the real time shipping calculator, please be sure to enter the product weight in the Unit of Measure which is accepted by the Shipping Carrier selected. If you enter a weight greater than zero the shipping calculator will calculate real time shipping costs. If you enter zero for your product weight, no shipping will be charged for that product when checking out. If the weight of the all the products in the cart is zero, then the cart will not charge shipping costs.

Minimum Order Quantity - Enter the minimum number of units required to purchase this product. If user clicks add to cart with a quantity less than the min order quantity then the cart will display the message “Product XYZ” has a minimum order quantity of X units” and will not allow the product to be added to the cart until the user enters a quantity that meets the minimum order quantity threshold.

Maximum Order Quantity - Enter the maximum number of units required to purchase this product. If user clicks add to cart with a quantity greater than the max order quantity then the cart will display the message “Product XYZ” has a maximum order qty of X units” and will not allow the product to be added to the cart until the user enters a qty that meets the maximum order quantity threshold.

Product Dimensions – Specifies the dimensions for your product.

Please Note: This field is not currently used for shipping calculations.

Items in Sku – Items in Sku is used if you are bundling multiple products in a single sku. For example, a “Buy 2 Get 1 Free Deal”. It is used in conjunction with the coupon feature giving you the ability to control the coupon discount. For example, if you are running a promotion for 5 dollars off and individual products and the customer purchases the buy 2 get 1 free you can give them 10 dollars off. This feature allows you to use a single coupon codes for the single items or the bundled items.

Bin Location – A Bin is a container in the warehouse where inventory is stored. Bin location is an alphanumeric label where a particular inventory item is located in the warehouse.

Number of Boxes – The number of physical boxes for the product.

Please Note: This field is not currently used for shipping calculations.

Date Added to Inventory – Enter the date that the specified product became available for purchase through your storefront.

Lead Time - Enter the number of days before the product can be shipped. Used to indicate when a product is not "In Stock" or in the warehouse. If lead time is configured for a product when a user adds the item to the cart then the lead time will be added to cart after the product name and variants so the customer can see when the product is being shipped. The lead time by default is styled red and can be changed to any color by changing the "LeadTime" style in module.css.

Client – Enter the name of the client that is providing your storefront with the specified product.

Owner – Enter the name of the owner of the inventory.

[up to contents]



Product Options

This section will describe the Product Options section of the Add product page.

 

Product Type

Featured Product – Allows the Product to be displayed in the Smith Featured Products module.

Upsell Product – Enables the upsell page during checkout. For more information on configuring the cart upsell checkout page feature see the Upsell Page KB article.

Gift Card/Certificate – When checked, enables product as a gift card/certificate product. When product is enable as gift card/certificate and user purchases the gift card product the purchase amount is stored on the gift card. Click here.

E-Card/Greeting Card – Check to enable product as as E-Card/Greeting Card product. When E-Card/Greeting Card is enable and user purchases product a greeting card template will be displayed on the confirm status page allows the user to fill out the ecard recipiant name, email and card message.

Compare Group – The product compare group is used with the Smith Product Compare module and alllows you to define what products are allowed to be compared together. Products that are allowed to be compared together should be in the same compare group.

Share Product

Share Products Between Catalogs – The “Share” checkbox only applies if you have added more than one cart module on different pages. This feature is used in situations where you want multiple product catalogs on different pages of your website. For example, if you are selling books and computers on your website and you wanted to have one page dedicated to books and another page dedicated to computers. If the share checkbox is checked for a particular product the product will be displayed in all product catalogs on any pages where you have added the shopping cart module. If the share checkbox is not checked then products added to your first cart module will remain separate from products added to your second cart module.

  • Multiple store support – SmithCart allows you to add the BuyNow module to multiple pages in your DNN portal The allows you to create of an unlimited number of stores on your Web site to offer different product selections, presentations, payment methods, shipping rates, and tax setup. This is useful for such purposes as building a members-only store or creating a discount store for clearance items. The share flag can be useful in this context to share products across multiple BuyNow modules eliminating the need to reenter your products in each BuyNow module.

Enforce Behavior

Require Login – This setting will require the user to enter a user id and password before checking out. The require login checkbox in the add products screen is associated with a product or products and will only require the user to login if they have the products in their cart that require login. The cart settings screen also has a require login checkbox, when checked will require the user to create a login for any product they purchase.

Charge Handling – When “Charge Handling for Selected Products” and “Charge Handling” are checked the cart will apply the following rules for charging handling:

  • If no items in the cart have “Charge Handling” checked in product setup then the cart will charge zero handling.
  • If at least one product in the cart has “Charge Handling” checked then use the cart will apply the handling amount configured in the BuyNow settings handling setup section.

Note: This setting works in conjunction with “Charge Handling for Selected Products” setting.

Prevent Cart Delete – When checked prevent the product from being deleted from the cart.

Enable Payment Options

User Entered Amount – Enables user entered amounts for a product. When enabled, the user will be able to enter a price for your product. This option is typically used for online bill payment or sites that collect online donations.

Minimum Partial Amount – Enter the minimum partial amount the customer is allowed to pay for this product. Enter -1 to indicate no partial amount allowed.

Show Fields

Show Custom Fields – This checkbox allows you to show/hide the user defined fields on the product details page by product.

Show Order As Is – Displays the order as is feature on the product details page that allows the user to select from a previous order and purchase the same configuration of a product. Specifically useful is you have products with a lot of variants. Will save the customer time when they order the same configuration of a product frequently.

Use Company Logo – When checked and user is logged and a member of a role with a company logo uploaded the cart will use the company logo uploaded. Please note: In order for this feature to work you must also have the Smith Registration module installed and companies are using Smith Registration to upload their company logos.

Hide Fields

Hide Price - When checked hides prices for a specific product. This is useful when setting up a product catalog only or setting products that need to be quoted. When hide price is checked the price of a product is replaced with “Request a Quote”.

Hide Quantity - When checked hides quantity for a specific product. This is useful when setting up a product catalog only or do not want the user to change the quantity for a product.

When hide price or hide quantity is checked the price will be removed on following screens and confirmation emails:

  • Product listing page
  • Product details page
  • Cart page
  • Confirmation page before payment
  • Confirmation page after payment
  • User and admin confirmation email

Hide Thumbnail - When checked the thumbnail image will not be displayed on the product listing page of the catalog.

Hide Product (All Roles) – Allows you to hide a product from the catalog for all DNN roles except the admin and host accounts.

Deactivate Product

Deactivate Product - Check this box to deactivate the product. When a product is deactivated it will not show up in the front end product catalog and will not be available for purchase.

Urls

Product Details URL - The Product Details URL allows you to enter a custom URL for your product details page. You should only enter a link here if you want to create your own custom product details page. If you are using the Smith Cart product details module you should not enter a URL here. The custom Product Details URL replaces the links on the product listing and cart pages with the custom link you enter.

Affiliate URL - When the user clicks the “Add to Cart” button the cart will open a new window with the link entered and the user will complete the checkout for the product on the affiliate’s site.

[up to contents]



Tax

This section will describe the Tax section of the Add product page.

 

Tax Exempt – Check this box if you do not want to charge tax for the product.

Tax Rate – Enter the Product Level Tax Rate. For example, 8.25% is entered as 8.25

Taxable Amount (Optional) – If the “Taxable Amount” field is populated, the cart will use the “Taxable Amount” field to calculate tax instead of the "unit cost" field the cart normally uses. Tax is calculated prior to any coupon or discount.

[up to contents]



Coupons

This section will describe the Coupons section of the Add product page.

Require Coupons – Check this box if you would like to require a coupon or access code in order for the user to checkout and purchase the product. Inventory Management on the Cart page must also be enabled to enforce the Coupon to be required.

Exclude Coupons – Check the exclude coupons checkbox if you wish to exclude this product from being discounted when the user enters a valid coupon code during checkout. This enables you to choose which products are discounted when you have an active coupon enabled in your cart.

[up to contents]



Booking

This section will describe the Booking section of the Add product page.

Enable Booking – Enables booking in scheduling for the product. User selects dates to schedule item from calendar and date picker on the product details page.

Show Date Picker – When checked, displays a date picker button next to the from and to dates. Only applies to booking products when the calendar is displayed on the product details page.

Show Time Picker – When checked, displays a time picker button next to the from and to dates. Only applies to booking products when the calendar is displayed on the product details page.

Booking Units – Select the Booking Units to use when calculating product price.

[up to contents]



Downloadable Product

This section will describe the Downloadable Product section of the Add product page.

Download URL – Enter the URL to the product. Before entering the path in the “Download URL” field see the Downloadable Products KB article.

Auto Generate GUID – The auto generate guid provides additional security features for preventing piracy of your downloadable products. When this checkbox is checked the cart will automatically generate a unique GUID and add the GUID to the end of the download url.

Auto Generate GUID Example:

Download URL: http://www.mydomain.com/somefolder/somepage.aspx?guidid=

When auto generate GUID is checked the download URL generated by the cart will be the following:

http://www.mydomain.com /somepage/somefolder.aspx?guidid=23DQ42WT8R4

Notice in the example above the question mark and the variable name in the querystring are added by the admin which gives you the flexibility to add additional querystring parameters and name the variables anything you want.

In the example above, the aspx page named “somepage.aspx” is used as a gatekeeper program that control passes to when the user clicks the download button after successful purchase. The Gatekeeper Download Manager is a companion program developed to work with SmithCart and provides additional levels of security for your electronic products.

Features include:

  • Anti-piracy features for electronic products
  • Velocity Checks - number of times and/or number of days to allow file to be downloaded by a recipient
  • PDF Watermarking/Stamping - Stamp every page with pre-defined fields from the order. Stamps are secure and cannot be removed.

Please contact Smith Consulting at sales@smithcart.com for more information about The Gatekeeper.

[up to contents]



Bundled Product

This section will describe the Bundled Product section of the Add product page.

Bundled Product Setup – Bundled products are Sometimes referred to as “Kit” products, bundled products contain a master SKU and one or more sub SKUs.

Use Primary Product Price & Weight – When this checkbox is checked the price and weight of the bundled product will be the price and weight of the master product. When this checkbox is NOT checked the price and weight of the bundled product will be the SUM of the price and weight of the master product and all sub products defined in the bundle.

[up to contents]



Recurring Billing

This section will describe the Recurring Billing section of the Add product page.

For detailed information and configuration instructions, please see the Recurring Billing KB article.