Magento custom blocks

Magento custom blocks

July 9, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento custom blocks

Showing Popular Products Using AJAX in Magento: A Comprehensive Guide

As an experienced developer, I understand that you’re having trouble displaying popular products using AJAX on your Magento homepage while also including pagination for better user navigation. Let’s dive into the solution step-by-step.

Understanding the Problem

You’ve already set up a layout block to display the popular product template (popular.phtml). Inside this template, you’re fetching and filtering the product collection based on ordered quantities and name alphabetically. However, you’re facing two main challenges:

  1. Loading pagination toolbar: You want to add a pagination toolbar to your AJAX response but couldn’t do it directly in the popular.phtml or using the createBlock layout function.

  2. Limited number of products: Your current code shows only 5 or “N” number of products, and you need to implement proper pagination for all popular products.

Solving the Challenges

To solve these issues, we’ll need to modify your approach by creating a new block that handles both product collection and pagination. We’ll also use Magento’s built-in Pager class to generate the pagination toolbar.

Step 1: Create a New Block

First, create a new block in your module configuration file (config.xml):

<global>
    <blocks>
        <your_module>
            <class>Your_Module_Block</class>
        </your_module>
        <your_module>
            <class>Your_Module_Model</class>
        </your_module>
    </blocks>
</global>

Next, create the new block class (PopularProducts.php) in your module:

<?php

class Your_Module_Block_PopularProducts extends Mage_Core_Block_Template
{
    public function getPopularProducts()
    {
        $limit = 10; // Number of products per page

        $_productCollection = Mage::getModel('catalog/product')
            ->getCollection()
            ->addPriceData()
            ->addAttributeToSort('ordered_qty', 'DESC')
            ->addAttributeToSort('name', 'ASC')
            ->setCurPage($this->getCurrentPage())
            ->setLimit($limit);

        $_productCollection->load();

        return $_productCollection;
    }
}

Step 2: Modify popular.phtml

Now, update your popular.phtml file to use the new block and display the product collection:

<?php
$_products = $this->getPopularProducts();
$_pager = $this->getPager();

echo $_pager; // Display pagination toolbar

foreach ($_products as $_product) {
    // Your product rendering code here
}
?>

Step 3: Add Pagination to the Block

In your new block class (PopularProducts.php), add the following methods to handle pagination:

public function getCurrentPage()
{
    return $this->getRequest()->getParam('p', 1);
}

public function getPager()
{
    $_productCollection = $this->getPopularProducts();
    $collectionSize = count($_productCollection);

    if ($collectionSize > 0) {
        $pagerBlock = $this->getLayout()->createBlock('page/html_pager');
        $pagerBlock->setTotalNum($collectionSize)
            ->setLimit($this->getData('limit'))
            ->setCurPage($this->getCurrentPage());

        return $pagerBlock->toHtml();
    }

    return '';
}

Step 4: Use the New Block

Finally, update your layout XML file to use the new block:

<block type="your_module/popularproducts" name="popular_products" template="catalog/product/popular.phtml"/>

Remember that you’ll need to replace your_module with your actual module name.

Conclusion

By following this approach, you’ll be able to display popular products using AJAX while also including proper pagination for better user navigation. The key is to create a new block that handles both product collection and pagination using Magento’s built-in Pager class.

Don’t forget to check out our blog on Optimizing Magento Performance for more tips on improving your e-commerce website.

Happy coding! Let me know if you have any further questions.

Catalog Extensions Themes Configuration

Our network