Controller override in Magento

Controller override in Magento

September 12, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Controller override in Magento

How to Override Magento Core Controllers: A Step-by-Step Guide

As seasoned Magento developers, we often face the need to override core controllers to extend or modify their functionality. Let’s dive into step-by-step instructions for overriding a controller using your provided example.

Understanding the Controller Structure

In Magento, controllers are organized under the controllers directory within each module. For the core Mage_ImportExport module, the controllers are located at /app/code/core/Mage/ImportExport/controllers/Adminhtml.

The specific controller you want to override is Mage\ImportExport\controllers\Adminhtml\ExportController.php. This contains the logic for handling export operations in Magento’s admin interface.

Setting up Your Custom Module

To start overriding, we first need a custom module where we’ll define our override. Let’s assume yours is named company_module and resides under /app/code/local/.

The directory structure should look like this:

/app/code/local/
└── company_module/
    ├── etc/
        └── config.xml
    └── controllers/
        └── Adminhtml/
            └── ExportController.php

Defining the Controller Override in config.xml

In your config.xml file located under /company_module/etc/, you’ve already defined a rewrite for the core controller. The relevant section is:

<global>
    <rewrite>
        <company_module>
            <from><![CDATA[#^/controller/adminhtml/#]]></from>
            <to>/controller/adminhtml/</to>
        </company_module>
    </rewrite>
</global>

This configuration tells Magento to rewrite the adminhtml controller path by replacing it with our custom module’s path.

Implementing Your Custom Controller

Now, let’s move on to your custom controller located at /app/code/local/company_module/controllers/Adminhtml/ExportController.php.

<?php
require_once 'Mage/ImportExport/controllers/Adminhtml/ExportController.php';
class Company_ImportExport_Controller_Adminhtml_ExportController extends Mage_ImportExport_Adminhtml_ExportController
{
    public function indexAction()
    {
        echo "I am called";die;
    }
}
?>

You’ve included the require_once statement to load the core controller, and then you’re extending it with your custom class. However, there’s a subtle issue here.

The Problem: Incorrect Namespace

The problem lies in how you’ve defined your namespace for the extended class. When overriding a core class, Magento expects the namespace to match exactly. In your case:

  • The core controller uses Mage_ImportExport_Adminhtml_ExportController.
  • Your custom controller defines company_module_ImportExport_Controller_Adminhtml_ExportController.

The issue is with the company_module portion in your class name. Since you’re extending a core class, Magento expects it to be prefixed with Mage, not Company.

The Solution: Correct Namespace and Inheritance

To resolve this, update your custom controller like so:

<?php
require_once 'Mage/ImportExport/controllers/Adminhtml/ExportController.php';
class Mage_ImportExport_Adminhtml_ExportController extends Company_ImportExport_Controller_Adminhtml_ExportController
{
    public function indexAction()
    {
        echo "I am called";die;
    }
}
?>

In this updated version:

  1. We keep the require_once statement as is.
  2. The custom class name matches the core controller exactly, using the correct Mage_ImportExport_Adminhtml_ExportController.
  3. The class extends your module’s custom Company_ImportExport_Controller_Adminhtml_ExportController.

By following this structure, Magento will correctly recognize and apply your override.

Conclusion

Overriding Magento controllers requires careful attention to namespace conventions and correct configuration of rewrites in the config.xml file. By adhering to these best practices, you can successfully extend core functionality without modifying the original code.

Remember, for more detailed information on Magento development practices, always refer to our comprehensive guides at Laravel Company.

Extensions Admin Configuration Import/Export

Our network