Magento Toolbar -> Limit

Magento Toolbar -> Limit

September 22, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento Toolbar -> Limit

As an experienced developer, I understand your challenge of transitioning between different pagination styles within Magento. Today, we’ll explore how to transform the default dropdown pagination into simple HTML links for a specific category.

Understanding Magento’s Pagination Structure

Before diving into the code, it’s crucial to grasp Magento’s pagination mechanism. By default, the platform uses a dropdown menu for category limit selection and navigation. This is implemented through the Mage_Page_Block_Html_Pager class and its related templates.

The standard URL pattern for category limits looks like this:

www.store.com/category.html?limit=12

However, you’ve noticed that directly hardcoding this in your source won’t suffice, as it might interfere with Magento’s core functionalities. To proceed safely, we’ll need to create a custom function that generates the desired URL format.

Creating a Custom Function for Category URLs

To achieve this, let’s create a new helper class and method that will return the formatted category URL based on the current limit selection. Here’s how you can implement it:

  1. Create a new file app/code/local/YourCompany/CategoryUrl/etc/config.xml with the following content:
<?xml version="1.0"?>
<config>
    <modules>
        <YourCompany_CategoryUrl>
            <version>0.0.1</version>
        </YourCompany_CategoryUrl>
    </modules>
    <global>
        <helpers>
            <categoryurl>
                <class>YourCompany_CategoryUrl_Helper</class>
            </categoryurl>
        </helpers>
    </global>
</config>
  1. Create the actual helper class app/code/local/YourCompany/CategoryUrl/Helper/Data.php and add the following code:
<?php
class YourCompany_CategoryUrl_Helper_Data extends Mage_Core_Helper_Abstract {

    public function getCategoryUrlWithLimit($categoryId, $limit) {
        $category = Mage::getModel('catalog/category')->load((int)$categoryId);

        if (!$category->getId()) {
            return '';
        }

        $urlPath = $category->getUrlPath();
        $baseUrl = Mage::getBaseUrl(Mage_Core_Model_Store::URL_TYPE_WEB);
        $separator = '/';

        // Construct the URL with limit
        $url = $baseUrl . $urlPath;
        if (strpos($url, '?') === false) {
            $url .= '?';
        } else {
            $url .= '&amp;';
        }
        $url .= 'limit=' . $limit;

        return $url;
    }
}
  1. Now you can use the getCategoryUrlWithLimit method in your template files to generate the desired URLs.

Integrating the Custom Function into Your Template

To display the HTML links instead of a dropdown, update your category listing template (usually located at app/design/frontend/base/default/template/catalog/category/view.phtml) as follows:

<?php $_productCollection = $this->getLoadedProductCollection(); ?>
<?php $_helper = Mage::helper('categoryurl'); ?>

<div class="toolbar">
    <div class="pager">
        <?php if($_productCollection->getLastPageNumber() > 1): ?>
            <div class="pages">
                <strong><?php echo $this->__('Limit') ?>:</strong>
                <?php foreach($this->getAvailableLimit() as $_limit => $_title): ?>
                    <a href="<?php echo $_helper->getCategoryUrlWithLimit($_productCollection->getCurrentCategoryId(), $_limit); ?>"><?php echo $_title ?></a>
                <?php endforeach; ?>
            </div>
        <?php endif; ?>

        <!-- Add your custom pagination HTML here -->
    </div>
</div>

Conclusion

By following this comprehensive guide, you should now be able to create a function that accurately generates category URLs with specified limits without breaking Magento’s core functionalities. The key is to use the getCategoryUrlWithLimit method from your custom helper class in combination with updating the template file.

Remember, it’s essential to keep your code organized and maintainable by using extension files within the local scope (app/code/local). This approach ensures that your changes won’t be overwritten during Magento upgrades.

For more advanced customization options and best practices in Magento development, I recommend exploring our resources at LaravelCompany. We offer a wide range of articles and tutorials to help you master the platform’s intricacies effectively.

Catalog Extensions Themes Configuration

Our network