New Listing - Featured Listing - All Listing configuration settings for Zen Cart v1.x.x

Configuration for New Products, Featured Products and All Products pages for Zen Cart v1.x.x

Please note: This content is for Zen Cart 1.x.x. For Zen Cart v2.0.0 and newer, see Listing Configuration Settings.

The New Products, Featured Products, and All Products pages are listing pages.

They are all configured using the same kinds of settings, but each one has its own configuration settings page; the pages are under Admin > Configuration, and are named New Listing, Featured Listing, and All Listing.

For example, Admin > Configuration > Featured Listing, the top settings are:

  • Display Product Image
  • Display Product Quantity
  • Display Product Buy Now Button
  • Display Product Name
  • Display Product Model
  • Display Product Manufacturer Name
  • Display Product Price
  • Display Product Weight
  • Display Product Date Added

and each of these values is set the same way, with a 4 digit value:

  • 0= off
  • 1st digit Left or Right
  • 2nd and 3rd digit Sort Order
  • 4th digit number of breaks after

Another way to describe this is that the digits are ABBC where

  • A is 1 for display on left, 2 for display on right
  • BB is the sort order (00-99)
  • C is the number of line breaks after the field is displayed (0-9).

Featured Products Settings

Note that each setting has a four digit value; each digit or combination of digits controls a separate aspect of the display.

The first digit controls whether that piece of the listing, say the product name, will show or not. You have to chose either a 1 or a 2 in order for it to show on the listing. Product name has a value of 2101, indicating it is to be shown. If that value was changed to 3101, it disappears from the page.

The first digit also determines whether the item is located on the left or right as in the image below where the 2101 was changed to 1101. Use “2” for right (as in the upper image) and “1” for left.

Featured Change Name Number

The second and third digit taken together determines the sort order of the items in the display. For example, changing the model number from 2101 to 2311 places it below the manufacturer name that has a number of 2302.

Featured Change Model Number

The fourth number determines the spacing between fields. If we just change the manufacturer number above from 2302 to 2301, the space between the manufacturer and model number disappears. Peeking under the hood, this setting controls how many line breaks are present, i.e, one, two or however many you may want.

Featured Change Manufacturer Spacing

The behavior of the Buy Now button on listing pages is discussed in add to cart.

The Product Listing pages have their own configuration, which is described in the product listing configuration page.

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 January 30, 2024 by Scott C Wilson (a2b8f0b).