Home

Welcome to the Products' Pagination wiki!

These articles apply to v3.0.0 and later of the Zen Cart plugin. It's designed to work with the Zen Cart 1.5.8 and 2.0.x distributions only and supports the built-in responsive_classic and Bootstrap templates.

Note: A template-override is required for the product-information pages' display. See this Wiki article for additional information.

This plugin replaces the default previous/next navigation for your store’s product information pages:

• document_general_info
• document_product_info
• product_free_shipping_info
• product_info
• product_music_info

and optionally (via admin configuration) the previous/next navigation for these other pages in your store:

• account_history
• search_result (for Zen Cart versions prior to 1.5.8, known as advanced_search_result)
• featured_products
• index (a.k.a. the product listing page)
• product_reviews
• products_all
• products_new
• reviews
• specials

The updated display looks similar to

Links to the first and last products in the category (or page groups for the "other" pages) are always displayed and you control the maximum number of links to be shown. When you hover over a link on a product-information page, the name of the product associated with that link is displayed by the browser.

There are optional (default: false) controls in your admin's Configuration :: Products Pagination that enable you to display a page-select drop-down where your visitors can choose which page of the display to go to next and/or an item-count drop-down where your visitors can choose how many items to view per display page. These controls appear only on the "Other pages to link" and look similar to

Starting with v2.0.0, you also control whether the plugin's pagination links are active when your site is viewed by a mobile device. To enable that handling, the plugin makes use of the presumed preexisting file /includes/classes/Mobile_Detect.php and is also aware of the layoutType handling provided by Zen Cart's responsive_classic template.