Product Listing configuration settings

Configuration for Product Listing pages

The Product Listing (or Index Listing) pages are listing pages showing all products in a specific category.

These pages have their own configuration settings page, which is described in Admin > Configuration > Product Listing.

On this page, the top settings are:

  • Display Product Image
  • Display Product Manufacturer Name
  • Display Product Model
  • Display Product Name
  • Display Product Price/Add to Cart
  • Display Product Quantity
  • Display Product Weight

Each of these values is set the same way, with a zero (indicating do not display this field on the listing page) or a positive number (indicating display this field in this order).

There are two things about the display of index listing pages that can be changed using admin controls:

a) How products are sorted when displayed on an index listing page:

By default, the sort order of products is done according to the sort order field on the products editing page.

This can be changed using Sort Order Default - Product Listing on the Admin > Configuration > Product Listing page. See sort order for more details. When this value is set, one of the fields above (name, price, quantity, etc.) will be used to sort the products.

In Zen Cart 2.0.0 and above, in the storefront, the sort order can also be changed using the Sort Order dropdown.

In Zen Cart 2.0.0 and above, the values for Sort Order Default - Product Listing correspond to the options shown in this dropdown, as shown in this table.

Listing Page Sort Order Dropdown

In Zen Cart 1.5.8 and below, the values for Display Product Listing Default are explained here.

b) How each product is displayed on the listing page.

The “Display” controls described above indicate whether a particular field is shown for a product. The layout in which they are shown has three columns per row of listed products:

  • the image is on the left
  • the price and add to cart box is on the right
  • in the center are product name, model, manufacturer, description, quantity and weight.

This behavior may be modified by changing the template file includes/modules/YOURTEMPLATE/product_listing.php.

In Zen Cart 1.x.x, the New Products, Featured Products, All Products and Specials pages are configured differently - see New Listing - Featured Listing - All Listing configuration settings for Zen Cart v1.x.x.

Note that since Zen Cart 2.0.0, the New Products, Featured Products, All Products and Specials pages have been configured the same as product listing pages. See Listing Configuration Settings.




Still have questions? Use the Search box in the upper right, or try the full list of FAQs. If you can't find it there, head over to the Zen Cart support forum and ask there in the appropriate subforum. In your post, please include your Zen Cart and PHP versions, and a link to your site.

Is there an error or omission on this page? Please post to General Questions on the support forum. Or, if you'd like to open a pull request, just review the guidelines and get started. You can even PR right here.
Last modified August 16, 2024 by Scott Wilson (f2d6b85).