magento - How override sales order history block class (Mage_Sales_Block_Order_History)

magento - How override sales order history block class (Mage_Sales_Block_Order_History)

September 16, 2026 · Illustrated author avatarBy Stefan Bogdanescu
magento - How override sales order history block class (Mage_Sales_Block_Order_History)

Overriding the Sales Order History Block Class in Magento

As a senior developer at Laravel Company, I understand your frustration when trying to override block classes in Magento. Let’s dive into the problem you’re facing and find a solution.

The Current Configuration

You’ve taken the first steps correctly by creating the necessary configuration files for your custom module:

  1. config.xml: This file is used to define the blocks that will be rewritten.
  2. Emm_Sales.xml: This enables your module in Magento’s system configuration.

Both of these are placed in the correct directories (app/code/local and app/etc/modules, respectively).

The Issue with Block Overriding

The challenge lies in the actual implementation of the override for the history block class:

require_once 'Mage/Sales/Block/Order/History.php';

class Emm_Sales_Block_Order_History extends Mage_Sales_Block_Order_History 
{
    // No code here
}

Here are a few points to consider:

  • Require Statement: Your require statement is correct, but remember that Magento 2 uses namespaces. If you’re on Magento 2.x, the file would be require_once 'Magento/Sales/Block/Order/History.php';.

  • Class Name: Ensure your class name matches the expected format for Magento classes.

The Missing Piece

The issue seems to be in the actual implementation of the block override itself. When you extend a Magento block, you need to override specific methods to customize its behavior.

In your case, if you want to apply the filter from the StackOverflow answer you mentioned earlier, you would need to override the _getCollection() method:

public function _getCollection()
{
    $collection = parent::_getCollection();
    $collection->addAttributeToFilter('store_id', Mage::app()->getStore()->getId());
    return $collection;
}

This code extends the original method and adds a filter for the store_id attribute, ensuring that only orders from the current store view are displayed.

Best Practices for Block Overrides

Remember these best practices when overriding Magento blocks:

  1. Always call the parent method using parent::method_name() to ensure the original functionality is preserved unless you explicitly want to break it.
  2. Use Magento’s built-in class names and file paths to avoid conflicts with other extensions or future updates.
  3. Keep your override methods as clean as possible, avoiding unnecessary code duplication.

Conclusion

To successfully override the sales order history block in Magento:

  1. Ensure your configuration files are set up correctly (config.xml and Emm_Sales.xml).
  2. In your local override class (Emm_Sales_Block_Order_History.php), override the necessary methods like _getCollection() to apply your custom logic.
  3. Make sure you’re using the correct require statement for Magento 1 or Magento 2.

For more in-depth guides and best practices on Magento development, feel free to explore our resources at Laravel Company.

Remember, Magento’s architecture can be complex, but with a solid understanding of its core components like blocks and collections, you’ll find the power to customize it for your needs.

Magento 2 Extensions Configuration Orders

Our network