Ektron CMS400.Net Reference

>>Conducting eCommerce with Ektron CMS400.NET > Products and Catalog Folders > Catalog Entries

Creating a Catalog Entry

Prerequisite: One or more catalog folders (See Also: Creating a Catalog Folder)

A Catalog entry is the eCommerce term that describes a product sold on your Web site. It is similar to content in the rest of Ektron CMS400.NET, so those concepts apply to catalog entries.

Catalog entries are built from Ektron CMS400.NET XML Smart Forms, so use the same content and folder structure as other Smart Forms. See Also: Working with Smart Forms

Catalog entries share the following features with regular content.

content status

approvals and permissions

metadata

schedule

can be private

history and the ability to restore previous versions

search

taxonomies to categorize products

Catalog entries also have unique information, such as

Tax Class - determines which taxes apply to item

Physical dimensions - used to calculate shipping costs

Inventory tracking

Pricing - can be fixed or variable for any currency

- tier pricing, that is, price adjusts when quantity reaches new plateau. For example, 1-9 items cost $500 each. But if 10 are sold, the price drops to $450 each.

Images (full sized and thumbnail) to display the product on your Web Site

Because there is so much information to provide about managing catalog entries, this section takes two approaches

Catalog Entry Screens and Menu Options describes all accessible options (tables, menus, etc.) from the catalog entry screen

Catalog Entry Tasks describes how to do things with catalog entries: create them, delete them, etc.

Catalog Entry Screens and Menu Options

Tabs on the Catalog Entry Screen

Menu Options on the Catalog Entry Screen

Folder View Menu options

Content View Menu Options

Catalog Entry Tasks

Creating/Updating Content

Deleting a Catalog Entry

Adding Cross Sell and Upsell Recommendations to a Catalog Entry

View and restore a previous version of a catalog entry - Navigate to catalog folder > select catalog entry > View Menu > Content History option. See Also: Content History

Edit permissions for a catalog entry - To enable this, break permission inheritance. Then, assign permissions to selected users. See Also: Setting Permissions for Content

Edit inherited approval chain - First break permission inheritance, and assign permission to users who need to be in the approval chain. Then, update the catalog entry’s approval chain. See Also: Editing an Approval Chain For Content

Make a catalog entry private, so that the Web site search does not find it - See Private Content

Archive a catalog entry - See Archived

Displaying Catalog Entries on your Web Site

Creating/Updating Content

Follow these steps to create a new catalog entry or update an existing one.

1. Navigate to a catalog folder in which you want to create or update a catalog entry. See Also: Creating a Catalog Folder

2. Choose New then select a product type on which to base the entry. See Also: Product Types

3. Complete the screens as needed. The required fields are:

- content Title

- Properties tab > SKU Number

- any fields on the content screen that your Ektron CMS400.NET administrator has designated as required

For information on the catalog entry screens, see Tabs on the Catalog Entry Screen

4. Check in or submit/publish the content. See Action Menu.

Note: After signing in to your Web site, you can also update a catalog entry’s information from there.

Note: See Also: The Web Site Content Menu

Deleting a Catalog Entry

Prerequisites:

Catalog entry is not on an order, or checked out.

You have delete permission for this catalog folder. See Also: Folder Permissions

Ektron Best Practice

Do not delete catalog entries. For example, if you delete an entry from your staging site, then run an eSync, that entry is removed from all active carts on your live site.

Instead of deleting entries, Ektron recommends archiving them using the Properties tab’s Archived checkbox (shown below).

Note: If you want to prevent site visitors from purchasing an item, but you cannot delete it because it has been placed on existing orders, you have two options.
* Uncheck its Buyable checkbox, located on the Properties screen (circled below). If you do, the product still appears on your Web site, but the Add to Cart button does not appear next to it.

* Archive it, using the Archived check box on the Properties screen (circled above). In this case, the product does not appear on your Web site. See Also: Archived

Follow these steps to delete a catalog entry.

1. Navigate to the catalog folder that contains the entry.

2. Click the entry.

3. Choose Action > Delete.

4. A warning message appears. Click OK.

5. The catalog entry is deleted.

Tabs on the Catalog Entry Screen

Tab

Description

For more information, see

Content

The entry’s content page.

Entering a Catalog Entry’s Content

Summary

The content summary, by default the first 40 characters of the content text.

Automatic Creation of a Summary and Working with Content Summary

Properties

eCommerce information about the catalog entry:

SKU number

Number of Units

Tax Class

Archived

Buyable

Dimensions

Inventory

Entering a Catalog Entry’s Properties

Pricing

Lets you define list and sales price

For each enabled currency, you can set a fixed price or have it float with exchange rate

Allows tier pricing

For subscription products, you enter recurring billing interval and term

Entering a Catalog Entry’s Price Information

Attributes

Additional information to help describe a catalog entry

Entering a Catalog Entry’s Attributes

Media

Lets you add images that appear on several eCommerce server controls

Entering a Catalog Entry’s Media

Items

Catalog entries that you are adding to this “umbrella” item.

If you add catalog entries to a simple product, it becomes a complex product.

For bundles, add catalog entries that make up a bundle.

For kits, enter groups and their options.

For subscription products, define membership and Ektron CMS400.NET user groups to which users are assigned when they purchase the subscription.

Entering a Catalog Entry’s Items

Creating a Complex Product

Creating a Bundle

Creating a Kit

Creating a Subscription

Metadata

Enter meta tags, title tags, etc.

Note: When viewing the metadata screen in view mode only, you see the catalog entry’s Product Icon. The product icon is set on the media tab. See Also: Product List, Product Search, and Recommendation server controls

Working with Metadata

Alias

Note: This tab only appears if Aliasing is enabled.

View and edit the catalog entry’s primary manual alias

View all automatic aliases assigned to this catalog entry

Creating User-Friendly URLs with Aliasing

Schedule

Lets you control when a version of a catalog entry becomes visible on the Web site. Similarly, you can remove a catalog entry on a predetermined date and time.

Note: The Archive and remain on the site option is not available with catalog entries.

Scheduling Content to Begin and End

Comment

View comments on changes made when editing a catalog entry.

Note: To view and edit catalog entry comments, open the editor and choose Change > Comment.


The comment also appears on the View Content and Content History screens. Use it to help distinguish one version from another.

 

Tasks

View tasks assigned to this catalog entry.

Note: To add a task from the View Entry screen, click Action > Add Task.

Assigning and Reviewing Tasks

Category

Add a taxonomy category to the catalog entry.

A list of available taxonomies and whether one is required are defined on the Catalog properties screen.

Note: This tab only appears if at least one taxonomy is assigned to the catalog folder.

Taxonomy

Menu Options on the Catalog Entry Screen

Menu Option

Description

Action Menu

Save

Saves the catalog entry without leaving the editor. It is a good idea to save your work frequently.

Check in

Save and check-in the document. This action returns the changed content to the database and exits the editor. It does not submit the content into the approval chain. Rather, it allows you and other users to continue changing it.

Submit/Publish

Submit the content into the approval chain. This action also returns the new or updated content to the database and exits the editor.

Publish the content to the Web site.

Note: Only the last approver in the approval chain sees this button. If no approval chain is assigned to the content’s folder, every authorized user sees this button. See Also: Approval Chains

This action also returns the changed content to the database and exits the editor.

Undo checkout

Exit screen and do not save changes made since you began editing this catalog entry.

Change Menu

Comment

Enter comments on changes made when editing a catalog entry.

The comment also appears on the View Content and Content History screens. Use it to help distinguish one version from another.

Template

A folder’s default template is automatically applied to all content in the folder. However, you can change a content item’s template to any of those assigned to the folder. See Also: Creating/Updating Templates

Entering a Catalog Entry’s Content

The Content tab displays the content page of this catalog entry’s product type. See Also: Step 2: Creating the Content Page

Because the format is customized for your system, this documentation cannot explain how to respond to the fields.

To learn about working with the editor, see Ektron CMS400.NET Editors.

Entering a Catalog Entry’s Summary

See Working with Content Summary .

Entering a Catalog Entry’s Properties

The Properties screen collects eCommerce-specific information about your catalog entries.

Use the following table to complete the Properties screen.

Property

Description

SKU

Enter a unique SKU code for this catalog entry. This is a required field that does not accept a value of zero (0) or a space character.

Number of Units

If this item has a quantity other than one (1) for internal record-keeping purposes only, enter that number.

For example, a 12 pack of soda. Set Quantity is 12 to represent the number of units. But a site visitor still orders 1 of the item.

The quantity is not used when this item is ordered, nor does it affect inventory levels. It is used for clerical purposes only.

Tax Class

Select the catalog entry’s Tax Class. See Also: The Tax Class Screens

Archived

Check this box if you want to archive this catalog entry. Once archived, site visitors can no longer see nor order it.

Also, Ektron CMS400.NET users cannot view an archived catalog entry in its catalog folder via the View Folders screen. To view it, open its catalog folder then select View > Archive.

To make the entry available again on your Web site, open its archive folder, edit the entry by unchecking the Archived check box, and publish it.

Note: A catalog entry can also be set to Archived status if it reaches its expiration date and its Schedule tab > Action on End Date field is set to Archive and remove from site (expire).See Also: Setting Archive Options

Buyable

To let site visitors add this catalog entry to a shopping cart, check this box. Otherwise, uncheck it.

If a product is not buyable, it can still be seen by site visitors, but its product page does not display an Add to Cart button.

Note: Tip! To remove a catalog entry from your site, use the Archive field.

Dimensions- Used to calculate packaging containers and shipping costs. See Also: Packages

Tangible Item

Check this box if the item is tangible, that is, it has dimensions, weight, and will be shipped to a customer. Examples of non-tangible items are services, warranties, and downloadable software.

If a catalog entry is tangible, you must enter its height, width, length, and weight.

Height

Enter the catalog entry’s height. The units of measure are specified in the web.config file’s ek_measurementsystem property.

Required if Tangible Item is checked.

Width

Enter the catalog entry’s width. Required if Tangible Item is checked.

Length

Enter the catalog entry’s length. Required if Tangible Item is checked.

Weight

Enter the catalog entry’s weight. Required if Tangible Item is checked.

Inventory - eCommerce’s inventory system is a provider model, allowing you to connect with third-party inventory systems.

Disable Inventory

Check this box if you do not want to track inventory activity for this catalog entry. As examples, it is a service contract or a subscription to confidential content on your site.

In Stock

Enter the number of items on hand for this catalog entry.

This number is automatically adjusted when an order containing this entry is submitted. For example, there are 100 items in stock. When an order for 10 is submitted, the In Stock value changes to 90.

If the amount placed on an order exceeds the In Stock amount, the site visitor see this message “The item ... is not available for purchase. Please remove from cart before submitting order.”

On Order

The number of items that have been ordered but not yet delivered appears.

Reorder

Enter the In Stock quantity at which you need to reorder this item. When the In Stock quantity reaches this level, an event is triggered which can be used by an external inventory system to generate a new order.

Entering a Catalog Entry’s Price Information

Use the Pricing screen to enter price information for catalog entries.

Use the following table to complete the Pricing screen.

Field

Description

Currency selector

Use this dropdown to select a currency for the prices. See Also: Alternate Currency Pricing

Only enabled currencies appear. See Also: Enabling Currencies

List price

Enter the catalog entry’s list, or manufacturer’s suggested retail, price.

The list price appears on most eCommerce controls (see examples below) but is not used in any calculations.

Cart server control

Product Search server control

Our Sales Price

Enter the catalog entry’s sale price. This price is used to calculate line item totals, coupon discounts, shipping costs, etc.

The sales price appears on most eCommerce controls. See examples above.

Add Pricing Tier button

Tier Pricing

Recurring Billing (appears only for subscription-based products)

Creating a Subscription

Alternate Currency Pricing

By default, the Pricing screen converts prices to every enabled currency (see screen below), using the exchange rate. Site visitors who select a non-default currency see these prices. See Also: Updating the Exchange Rate

The Float checkbox (checked by default) indicates that prices change as the exchange rate changes.

If you do not want to float a catalog entry’s price, but instead fix it for a currency, select the currency, uncheck Float, edit the price, and publish. From then on, if a site visitor selects that currency and catalog entry, the price set on this screen is used. The exchange rate is ignored.

For example, a television costs 700 Euros, regardless of its cost in US dollars or the exchange rate. To incorporate this, do not check the Float checkbox.

When you first select EUR on the Pricing screen, the default currency’s prices are converted using the exchange rate. For example, the television’s sale price is $1000 US dollars, and today’s exchange rate is .7811. When you select Eur from the Pricing screen’s currency selector, the television’s cost is set at 781.10 Euros. You change the price to 700.00 Euros.

From that point on, the Euro price only changes if an authorized user accesses this screen and changes it manually.

Tier Pricing

eCommerce supports tier pricing, that is, a pricing schedule that adjusts according to order quantity. Typically, the price is reduced as more items are ordered. For example, if a visitor orders 1-5, items are $10.00 each; 6-10, $9.00 each; 11 or more, $8.50 each.

Note: Tier pricing is not supported for subscription products, nor for complex products. See Also: Creating a Subscription, Creating a Complex Product

To set up tier pricing, follow these steps.

1. In the Workarea, open the catalog folder containing the entry to which you want to apply tier pricing.

2. Edit the catalog entry.

3. Click the Pricing tab

4. Click Add Pricing Tier (shown below).

5. The following screen section appears.

6. In the left column, enter the quantity of items above which the tier price is used.

7. In the right column, enter the price to be used when an order quantity exceeds the number in the left column.

8. Enter as many tiers as necessary.

Note: To remove a tier, check the box to its left, then click Remove Pricing Tier.

Tier Pricing and Non-Default Currencies: When Floated

If a non-default currency is floated, then that currency’s pricing tiers mirror the default currency’s pricing tier values. The amounts are adjusted by the exchange rate.

These values appear on pricing screen in view-only mode and cannot be changed. This is illustrated below.

If pricing tiers are set up for the default currency and the user unchecks the Float box, he is notified that the pricing tiers can now be edited. Next, Tier Pricing fields are loaded with the existing values but the user can change values, remove existing tiers, and add new ones.

Tier Pricing and Non-Default Currencies: When Not Floated

If a non-default currency is not floated, its pricing tiers are independent of the default currency’s. That is, they do not exist initially regardless of whether they exist for the default currency. If the user clicks Add Pricing Tier, Tier Pricing fields appear and let the user enter number of units and corresponding tier price per unit.

If pricing tiers are set up for a non-default currency and the user checks the Float box, the pricing tiers are changed to mirror those of the default currency. If the default currency has no pricing tiers, then that currency has none. You cannot independently edit a non-default currency’s pricing tiers if Float is checked.

Entering a Catalog Entry’s Attributes

Attributes are additional pieces of information that help describe a catalog entry. To illustrate the concept, the following attributes are applied to furniture in Ektron CMS400.NET’s sample site.

In the Workarea, you select a catalog entry then click the Attributes tab to enter or modify attribute values. In the above example, you could change model year to 2009, or style to Woodland. You cannot however change fields, field names, or data types.

Note: If no attributes are assigned to the product type on which a catalog entry is based, you will not see an Attributes tab when working with that catalog entry.

On your Web site, a catalog entry’s Attribute field names and values appear by default on the Product server control, as shown below.

Origin of Attributes

Attribute fields, data types, and default values are created as part of a Product Type. See Also: Attributes

When you create a catalog entry, you base it on a product type. The product type’s Attribute information is imported to the catalog entry.

What Happens to a Catalog Entry’s Attributes When Moved

Like metadata that follows Ektron CMS400.NET content, if a catalog entry is moved to another folder, its attributes stay with it.

Entering a Catalog Entry’s Media

Use the Media tab to add product images that appear on the following server controls.

Product (the smallest thumbnail may appear)

Product List

Product Search

Recommendation

See Also: Images in eCommerce

Adding a New Image

Follow these steps to add a new image. See Also: http://www.w3schools.com/tags/tag_IMG.asp

1. Click the Media tab.

2. Click Add New Image .

3. Enter an image Title. This is a required field.

4. Enter the image’s Alt text. This is a required field.

5. Click Browse and navigate to the image you want to add.

6. Click Upload.

7. The image is uploaded to the siteroot/uploadedimages folder.

Note: When an image is uploaded to the Media tab, the original image and any thumbnails associated with it are added to the Library. For example, if you add an image named “TestImage” (actual file name: “case.jpg”) with a 150px and 50px thumbnails, you see the following entries in your library (File Name - Path):
TestImage - /~siteroot~/uploadedImages/case.jpg
case[filename]150 - /~siteroot~/uploadedImages/case[filename]150.jpg
case[filename]50 - /~siteroot~/uploadedImages/case[filename]50.jpg

8. The image appears on the screen, below any existing images.

9. Determine if you want the image’s smallest thumbnail to appear on the product server control by selecting Yes or No next to Gallery Display. (See example below). See Also: Product Server Control, thumbnails

10. If you want to designate the image as the product icon, click Set as Product Icon. See Also: Product List, Product Search, and Recommendation server controls

To learn about the image thumbnails, see Determining Thumbnail Size.

Editing an Existing Image

Note: You cannot change an existing image. If you need to do this, delete the image you do not want, then add the correct one. You can only edit the Title and Alt Text.

1. Click the Media tab.

2. Move the cursor to the field that you want to edit.

3. Click the pencil icon to the right of the field (shown below).

4. Update the text as needed.

5. Click OK ().

Determining Thumbnail Size

When you create a catalog entry, you base it on a Product Type. The selected product type’s Media Defaults information determines the sizes of thumbnails created for each image assigned to the Media tab. See Also: Media

If the image is less than both thumbnail dimensions (height and width), it appears full size.

If the image is greater than the thumbnail’s dimensions, the image is reduced proportionately, scaling its dimensions to the thumbnail size.

The Default Image

If you do not assign an image to a catalog entry, but one is assigned to appear on a server control, the following default image is used.

If you want to change the default image, edit the following file:

siteroot/WorkArea/images/application/Commerce/productImageBackground.gif

Entering a Catalog Entry’s Items

Use the Items tab to add additional information to the current entry. It is used in these situations.

to select the catalog entries that make a product into a complex product. See Also: Creating a Complex Product

to select the catalog entries that make up a bundle. See Also: Creating a Bundle

See Also: Product Classes

to select the groups and their options that make up kits. See Also: Creating a Kit

Note: You can only choose a catalog entry whose language matches the language of the original item.

to select a subscription-based catalog entry’s user groups. See Also: Assigning Groups to a Subscription-Based Catalog Entry

Folder View Menu options

The following menu options are available when you open a catalog folder.

Menu option

Description

New Menu

Catalog

Create a new catalog folder underneath the current one. See Also: Creating a Catalog Folder

product types assigned to folder

Create a new catalog entry based on one of the displayed product types. Your product types may not match the ones shown below.

Product types are assigned to a catalog’s via the Product Types screen. See Also: Product Types

View Menu

All types, products, kits, bundles

Lets you change the display of catalog entries. You can see all entries in folder, or only those of a selected product class. See Also: Product Classes

Language

Limits display of catalog entries to one language.

Also determines the language of any new catalog entries you create in this folder.

Archive

Displays archived catalog entries. See Also: Archived

Catalog Properties

Lets you view and edit catalog folder information. See Also: Creating a Catalog Folder

Delete Menu

Note: You cannot delete a catalog entry that has been placed on any order. The order’s status is irrelevant.

Lets you delete a catalog folder or a catalog entry within it.

See Also: Deleting a Catalog Entry, Deleting a Catalog Folder

Catalog

Deleting Folders

Entries

See

Deleting a Catalog Entry

Deleting Several Content Items in a Folder

Action Menu

Move entry

Viewing and Restoring Previous Content

Note: You can only move catalog entries -- you cannot copy them.

Search

The Search Published Tab

Content View Menu Options

The following menu options are available when you are viewing a catalog entry.

Menu option

Description

Action Menu

Edit

Edit the catalog entry. See Also: Tabs on the Catalog Entry Screen

Delete

See

Deleting a Catalog Entry

Deleting Content  

Link Search

Locates all content that includes a Quicklink to the displayed catalog entry.

This feature is useful before deleting a catalog entry, because it informs you of every entry that will include a “dead” link if you delete that entry. You should then edit those catalog entries and remove or change the obsolete Quicklinks.

Add Task

Assigning and Reviewing Tasks

View Menu

Content History

Lists every version of the content available in Ektron CMS400.NET. After viewing the View Content History window, you can click any version to see its detail.

See Also: Viewing and Restoring Previous Content

View Approvals

Access the catalog folder’s approval chain. See Also: WorkFlow

View Permissions

Access the catalog folder’s permissions table. See Also: Folder Permissions

Cross Sell

Lets you assign cross sell items to this catalog entry. See Also: Adding Cross Sell and Upsell Recommendations to a Catalog Entry

Up Sell

Lets you assign up sell items to this catalog entry. See Also: Adding Cross Sell and Upsell Recommendations to a Catalog Entry

View Properties

Lets you

view the

- catalog entry’s product type See Also: Product Types

- Flagging Definitions assigned to the catalog entry’s folder See Also: Flagging

view and edit the Content Searchable setting - The search only considers content if this field is checked. By default, this field is checked when an entry is created.

Reports Menu

Content Statistics

Content Rating

Analytics

Provides a visual display of order information for a selected catalog entry. See Also: eCommerce Analytics

Editor View Menu Options

The following options are available when you are editing a catalog entry’s content.

Menu Option

Description

Action Menu

Save

Save the content without leaving the editor. It is a good idea to save your work frequently.

Check in

Save and check-in the document. This action returns the changed content to the database and exits the editor. It does not submit the content into the approval chain. Rather, it allows you and other users to continue changing it.

Submit or Publish

Submit the content into the approval chain. This action also returns the new or updated content to the database and exits the editor.

Publish the content to the Web site.

Note: Only the last approver in the approval chain sees this button. If no approval chain is assigned to the content’s folder, every authorized user sees this button. See Also: WorkFlow

This action also returns the changed content to the database and exits the editor.

Undo Checkout

Close the editor without saving changes.

Change Menu

Comment

Briefly describe the content, or comment on changes made when editing content. The history comment appears on the View Content and Content History screens.

Template

Lets you specify one or more templates for catalog entries in this folder. These entries use the specified template when appearing on your Web site. See Also: Creating/Updating Templates

Displaying Catalog Entries on your Web Site

The eCommerce Module provides three server controls for displaying catalog entries on your Web site.

Product Server Control

Product List Server Control

ProductSearch Server Control


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.