Reference Guide

This field mostly determines if attribute related data (like a price change when the customer selects an option) is loaded when the product page is loaded. Loading the attribute related data with the page (preloading) means it may take longer for the page to appear in the customer's browser. If you don't preload the attribute related data, the page will load faster, but if the customer selects an attribute that requires a price change (for example) another call has to be made to get that information.

• Do Not Preload: Choose this option if you want the page to load faster in User Reference Guide 292 Copyright 2005-2016, Miva Inc. All Rights Reserved. Publication Date: 03/31/2016 Miva Merchant Version 9.0005 the customer's browser. Information required by attribute selection will be retrieved in another call.
• Preload Drop Down Lists Do Not Contain Select One: Choose this option if you want to load page and attribute related data at the same time. If you are using drop-down lists and you've modified the Page tab template code to include a "Select One" option, your "Select One" option will not be displayed.
• Preload Drop Down Lists Contains Select One: You only need to select this option if:
• You want to preload page and attribute related data.
• You are using drop-down lists.
• You've modified the Page tab template code to include a "Select One" option.
• You want your "Select One" option to appear as the default choice.

Dependency Resolution controls how attribute drop-down lists are populated based on the current selection or a preset selection.. To use this field you must be tracking inventory at both the store level and the product level (see Track Inventory).

This field doesn't have much effect unless you are using Drop-down Lists as your option display type. For drop-down lists, Dependency Resolution changes the contents of one list depending on what you selected in another list. For example, if you select medium in the Size list, you might only see "Black" and "White" in the Color list, because those are the only colors available in medium. If you are using radio buttons to display options, the behavior will be the same no matter what you select for Dependency Resolution. Every product option will be displayed, but products that you don't carry or which are out of stock will be greyed out.

Select one of the following values for Dependency Resolution:

• First selected attribute shows all options: The option you select in the first drop-down list determines the contents of all other drop-down lists. If the first drop-down list is size and you select Medium, and the second drop-down list is color, only the color choices you have for medium shirts will be displayed.
• Cascade: The contents of a list is modified by selections above, but not below. Let's say you had three attributes: size, color, and fabric. The contents of the second drop-down list would be modified by what you selected in the first drop-down list, but the contents of the second list would not be affected by what was selected in the third list.
• Most recently selected attribute shows all options: Whatever attribute option you select first changes the contents of all other attributes. For example, if Color is the second attribute and you chose "Blue", the contents of the first attribute Size would only show sizes that are available in blue.

The Inventory Element allows the attribute machine to update the product page with real time inventory information.

If you go to: > User Interface > Pages > Edit Page PROD > Product Display Layout section > Advanced Mode

There is a HTML div element in the default template code which controls the display of your inventory information:

The contents of the Inventory Element field must match that div id.

Choose whether you want to display short inventory messages or long inventory messages for products that have Attributes. To set the message length for products that do not have attributes, see Inventory Level Message in the Product Display Layout section.

There are three inventory messages that can show up in a product page: "in stock", "low stock", and "out of stock". For each message, you can create a long version and a short version, depending on how much information you want to give the customer.

You can create default versions of these messages:

• See Catalog > Inventory Tab > Inventory Settings Section. And you can customize the inventory messages at a product level:
• See Catalog > Edit Product > Inventory Tab.

If you set this field to "short", the short version of your inventory message will be displayed, and "long" will display the long version of your inventory messages.

The Price Element field allows the attribute machine to update the product page with real time pricing information.

If you go to: > User Interface > Pages > Edit Page PROD > Product Display Layout section > Advanced Mode

There is an HTML element in the default template:

If you want the attribute machine to update the product price based on the attributes that the customer selects, the Price Element field must match that div.

See Pricing Elements and Pricing Displays. If the product is receiving some kind of discount, the attribute machine can display prices like this: $10.00 $7.00

• The $10.00 is the Additional Price Element. It's the original price of the product before any discounts are applied. You might want to show this price to customers so that they can see in the product page that they are getting a discount.
• The $7.00 is the Price Element. It's the price of the product after discounts are applied.

If you go to: > User Interface > Pages > Edit Page PROD > Product Display Layout section > Advanced Mode

There is an HTML element in the default template:

If you want the attribute machine to update the Additional Price Element based on the attributes that the customer selects, the Additional Price Element field must match that element.

See Pricing Elements and Pricing Displays. If the product is receiving some kind of discount, the attribute machine can display prices like this: $10.00 $7.00 $3.00

• The $10.00 is the Additional Price Element. It's the original price of the product before any discounts are applied. You might want to show this price to customers so that they can see in the product page that they are getting a discount.
• The $7.00 is the Price Element. It's the price of the product after discounts are applied.
• The $3.00 is the Discount Element. It's the dollar value of the savings.

If you go to: > User Interface > Pages > Edit Page PROD > Product Display Layout section > Advanced Mode There is an HTML tag in the default template:

If you want the attribute machine to update the Discount Element based on the attributes that the customer selects, the Discount Element field must match that element.

See Pricing Elements and Pricing Displays. The Price Element field as a kind of container. Generally, it is used to show the customer how much a product will cost after discounts have been applied. But you can use the Displayed Price field to have some additional control over what price customers see in a product page.

• Retail Price: If you select Retail Price, the Price Element field will display whatever you put in the Cost field when you created the product.
• Base Price If you select Base Price, the Price Element field will reflect discounts from legacy Price Groups, but not discounts from the new "nonlegacy" Price Groups that were introduced in Version 9. (See Price Groups in Version 9.)
• Sale Price If you select Sale Price, the Price Element field will reflect discounts from any Price Group, legacy or non-legacy.

In general you should use the "Sale Price" option because it will reflect discounts from both legacy and non-legacy Price Groups.

See Pricing Elements and Pricing Displays. The Additional Price Element field as a kind of container. Generally, it is used to show the customer how much the product cost before discounts were applied. But you can use the Additional Price Display field to have greater control over what price is shown.

• None: No value will be displayed by the Additional Price Element field.



• Retail Price: If you select Retail Price, the Additional Price Element field will display whatever you put in the Cost field when you created the product.



• Base Price (includes any legacy Price Group discounts but does not reflect sales, coupons or discounts applied in the basket): If you select Base Price, the Additional Price Element field will reflect discounts from legacy Price Groups, but not discounts from the new "non-legacy" Price Groups that were introduced in Version 9. (See Price Groups in Version 9.)

If you go to:

> User Interface > Pages > Edit Page PROD > Product Display Layout section > Advanced Mode

There is a HTML div element in the default template:

If you want Swatch - Drop-down List to change attributes based on the swatch selection, the Swatch Element field must match that div.

The customer will see this message if:

• You configured Attributes to use a Text Field and
• The attribute is required, and
• The customer left the attribute text field blank when they submitted the page.

The customer will see this message if:

• You configured Attributes to use Radio Buttons, and
• The attribute is required, and
• The customer did not select a radio button option when they submitted the page.

Do Not Include Category Code / Include Category Code

If:

• You set this field to "Include Category Code", and
• A customer in your on-line store is viewing a category page and then clicks on an individual product.

The URL of the product page will be modified so that it includes the category that the customer clicked on. If you were modifying the template code of your product pages, and you wanted to know what category the customer had clicked on to reach the product page, you would be able to extract the category from the product page URL.

Examples

Do Not Include Category Code (Short Links not enabled)

Include Category Code (Short Links not enabled)

Controls the formatting of products in the category page.

Expanded means that the entire image box is displayed:

Line Item formatting looks like this:

Select the fields that you want to display on the page.

If you have created Custom Fields and you would like to reference a custom field in the template code:

1. Check the box next to a custom field.
2. Click the Update button. Click on the Advanced Mode link at the bottom of the page. You can now reference the custom field in the product layout list template code.

By default, discounts from Price Groups show up in pages that use the Basket Contents item, but not in product or category pages. The Displayed Price field give you control over what prices are shown in category pages.

• Retail Price: in any category page, show the price that you entered for the product when you created the product. This option won't show any options from any Price Groups.
• Base Price (includes any legacy Price Group discounts but does not reflect sales, coupons or discounts applied in the basket): this option will show, in category pages, only those discounts that come from legacy Price Groups. This option is mainly kept around for grandfathering, since this option was added in PR8.)
• Sale Price (includes legacy Price Groups and predicted discounts): this item will display discounts from any type of Price Group, legacy or otherwise.

In a category page, this page can be used to show the original price and the discounted price.

• None:
• Retail Price: see above.
• Base Price (includes any legacy Price Group discounts but does not reflect sales, coupons or discounts applied in the basket): see above.
• Display Predicted Discounts

This list box shows all of the Image Types that you've created, and the option "None". For example, if you've created Image Types of Front, Back, and Side, the list box will look like this:

If you choose "None", no image is displayed. If you choose one of the Image Types, images that you assigned to that Image Type will be displayed.

Controls what inventory messages (if any) you want to display on category pages in your on-line store.

You can create default versions of these messages:

• See Catalog > Inventory Tab > Inventory Settings Section.



And you can customize the inventory messages at a product level:

• See Catalog > Edit Product > Inventory Tab.

In some pages of your on-line store you can show a drop-down list that allows your customers to sort the products that are being displayed. The pages where you can enable sorting are:

• CTGY (Category Display) > Category Product List Layout section > Sorting Options control
• PLST (Product List) > Product List Layout section > Sorting Options control
• SRCH (Search) > Search Results Layout section > Sorting Options control

Use the On and Off radio buttons to display or hide the sorting drop-down list. Use the checkboxes to select what options will appear in the sorting dropdown list.

One of the options that appears in the "Sort By" drop-down list is "Default". To see what the default order is for one of your categories:

1. Go to > Catalog > Categories.
2. In the Categories screen, edit a Category.
3. Select the Products tab.
4. Click the Show Records button and select Show Assigned.



5. Click Edit Display Order

If you have at least two products in that category, you will see something like this:



Whatever order the products have in the Products tab is how they will appear in your store, if the sort order is set to default. Note that selecting a sort order other than default can slow the display of pages in your on-line store.

The default sort order for categories is to list products in the order that they were added to the category.

If you check the "Reverse Default Display Order" checkbox, the products will be listed in the reverse default sort order, so the product that you most recently added will appear at the top of the list, instead of at the bottom.

But see also: Sorting Records.

Set the number of product columns to display when the customer is viewing a category page. A two column display looks like this:

If you select "Do not paginate products", all products in the category that the customer has selected will appear on the same page. This can be a disadvantage if the category has a lot of products in it and the customer has a slow internet connection.

If you enable pagination, you can select the initial number of products that will appear on the page. If the category has more than one page of products, "Next" and "Previous" buttons will appear at the bottom of the screen so that customers can scroll through the pages.

Note that, if you also enable the "Items Per Page Filter" (see below) a dropdown list will appear at the top of the screen that allows your customer to choose how many products appear on each page. The customer setting If you select "Do not show page count", no page numbers will appear on a category page, just the "Next" and "Previous" buttons. If you enable page numbers, clickable page numbers will appear at the top of the screen.

If you select "Do not show page count", no page numbers will appear on a category page, just the "Next" and "Previous" buttons.

If you enable page numbers, clickable page numbers will appear at the top of the screen. In the sample figure below, display of page numbers was set to 2.

If you enable the Items Per Page filter, a "View" drop-down list will appear at the top of the category page. Customers can select from this drop-down list the number of products that they want to appear on each page. The setting that customers select in this drop-down list overrides what you select in Pagination.

Choose whether you want to display short inventory messages or long inventory messages for products that do not have Attributes.

To set the message length for products that have attributes, see Inventory Message in the Attribute Machine section.

In order for the Image Machine to provide the features associated with Additional Images:

This checkbox must be enabled.

The Image Machine must be assigned to a page, for example Edit Page: Product Display > Items tab > product_display_imagemachine checkbox.

If you select this option then all of the Additional Images associated with a product: thumbnails, scaled images, and master images, are loaded when the page loads. This means the page takes longer to load, but there is a faster response time when the customer clicks on one of the Additional Images.

If you don't enable this option, only the first additional image and the thumbnails will load when the page loads. This makes the page load faster, but the customer will have to wait if they click on one of the other Additional Images.

No Constraints: The image will be displayed in the main image bounding box at whatever size was uploaded.

Resize to fit within bounding box: An invisible bounding box is drawn in the product Main Image page. Images larger than the bounding box are scaled down. Images smaller than the bounding box are untouched.

Enable click to closeup: If you enable this option, when the user clicks on the product image, a pop-up window will appear on screen containing a larger bounding box (you can set the dimensions of this larger bounding box below). See Master image for an example. Images larger than the bounding box are scaled down. Images smaller than the bounding box are untouched.

No constraints: The image will be displayed in the closeup bounding box at whatever size was uploaded.

Resize to fit within bounding box: An invisible bounding box is drawn in the Closeup page. Images larger than the bounding box are scaled down. Images smaller than the bounding box are untouched.

PR8

Item name: view_order

Tab Name: View Order Layout

V9

Item name: view_order

Collapsible Section Name: Order Contents