24/7 Support: 800.608.6482

Reference Guide

Try our new AI assistant by clicking the chat icon in the lower right corner.

This Version is Out of Date

You can find the updated Miva 10 Reference Guide here

Back To Reference Guide

ReadyTheme

Product Listings

A Product Listing is similar to a category. It's a group of products that appears on the storefront page of your ReadyTheme. For example, you might create a Product Listing to show customers your newest products, or a list of seasonal items.

Just like Images and Banners, your ReadyTheme can come with one or more preconfigured Product Listings. The location of the Product Listing is fixed, but you change the name of the listing and the products that it contains. If you wanted to change the location of an existing Product Listings, or add a new one, you would have to manually edit the template code of your storefront page (SFNT).

Base ReadyTheme

To Edit a ReadyTheme Product Listing

  1. Go to Menu> ReadyTheme > Product Listings tab
  2. In the Product Listings tab, double-click on one of the Product Listing records.
  3. In the Edit Product Listing dialog box:

    3.1. Make any necessary changes.

    3.2. Click Save

Edit Product Listing

The Edit Product Listing dialog box shows a slightly different group of fields, depending on whether you select or Advanced Mode.

Versions

Advanced Mode

Code: The code uniquely identifies this Product Listing record in the admin interface.
Name: A display name for the Product Listing record. It is only shown in the admin interface.
Description: Use this field to add a note to describe the purpose of the Product Listing.
Product Links: See Product Links.
Custom Fields: If you have created Custom Fields and you would like to reference a custom field in the template code:
  1. Select a custom field.
  2. Click Select. You can now reference the custom field in the template code.
Calculate Predicted Discounts and Sale Price See Display Predicted Discounts.
Product Images: For information about "Main": See Image Types For information about "No Constraints" and "Resize to Fit…" See Main Image.
Default Sort Method: See Default Sort Metho
Reverse Default Display Order
Number of Products: The number of products that you want to display in this Product Listing. For example, you can link a Product Listing to a Category that has 100 products, but if you set this field to 5, only 5 products will be displayed in this Product Listing.
Products To Display:
  • All Products: The software will display every product in your store in the Product Listing, however, you can limit the display with the Number of Products field.
  • Products in Category: The software will display all of the products in the category that you select, however, you can limit the display with the Number of Products field.

You can also create a special category just to use in your Product Listing. For example:

  1. Go to Menu> Catalog > Categories tab and create a new category called "New Arrivals".
  2. Edit the new category and add products that you've recently added to your store.
  3. Go back to Menu> ReadyTheme > Product Listings tab > edit a Product Listing dialog box.
  4. In the Edit Product Listing dialog box > Products to Display field, select the New Arrivals category that you just created.
  5. You can also change the name of the Product Listing as it appears in your store. In our example, we're using the base ReadyTheme, which comes with a Product Listing called "Featured Products".
  6. Make sure the Edit Product Listing dialog box is in Advanced Mode, then change the HTML tag that contains the name of the Product Listing. In our example, we'll change "Featured Products" to "New Arrivals".

    7. Edit Product Listing

Notes: Versions: See Appendix 2: Common Fields in the Admin Interface.

Point and Click Mode

Code: The code uniquely identifies this Product Listing record in the admin interface.
Name: A display name for the Product Listing record. It is only shown in the admin interface.
Description: Use this field to add a note to describe the purpose of the Product Listing
Format:

Changes the way that products are displayed in the Product Listing.

  • Expanded:

    Expanded

  • Line Item:

    Line Item

Product Links: See Product Links.
Product Fields Select the product fields that you want to display.
Custom Fields:

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 template code.
Displayed Price: Select the price that you want to display for the products.
Additional Price Display: See Additional Price Element.
Display Predicted Discounts See Display Predicted Discounts.
Buttons: Check these boxes if you want the Product Listing to show the Add to Basket or Buy Now buttons.
Image: See Miva Merchant Images - A Brief History.
Inventory Message: See Inventory Messages.
Default Sort Method: Choose a sort order for the products in the listing.
Reverse Default Display Order
Product Columns: Set the number of display columns for the Product Listing.
Number of Products: The number of products that you want to display in this Product Listing. For example, you can link a Product Listing to a Category that has 100 products, but if you set this field to 5, only 5 products will be displayed in this Product Listing.
Products To Display: See Products To Display
Notes: Versions: See Common Fields in the Admin Interface.

Looking for Developer Docs?

We have a whole section for that, including: Developer Training Series, Template Language docs, Module Development tutorials and much, much more.

Head to the Developer Section

Copyright © 1997 – 2024 Miva®, Miva Merchant®, MivaPay®, MivaCon®, Camp Miva®, Miva Connect®, Miva, Inc. All Rights Reserved.