Add multiple tabs and forms in backend of a custom module in magento just like customer backend porsitions

Add multiple tabs and forms in backend of a custom module in magento just like customer backend porsitions

July 15, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Add multiple tabs and forms in backend of a custom module in magento just like customer backend porsitions

Creating a Custom Module with Multiple Tabs in Magento

Creating a custom module in Magento that mirrors the functionality of the customer backend involves setting up multiple tabs for different forms within your module’s admin interface. Here’s how you can achieve this using the Mage_Customer module as a reference.

1. Understanding the Customer Module Structure

The Mage_Customer module is a great starting point since it already has the tab-based structure we’re aiming to replicate. Let’s take a look at its relevant files and directories:

  • /app/code/core/Mage/Customer/controllers/Adminhtml
    • CustomerController.php: Handles customer-related actions in the admin section.
  • /app/code/core/Mage/Customer/etc/adminhtml.xml
    • Contains the configuration for the admin interface, including tabs and forms.

2. Setting Up Your Custom Module

Assuming you’ve already created your custom module (let’s call it CustomMod), navigate to:

/app/code/local/CustomMod

Ensure that your module has the following files and directories:

  • /etc
    • config.xml: Contains configuration settings for your module.
    • adminhtml.xml: Defines the admin interface components, such as tabs and forms.

3. Configuring Tabs in adminhtml.xml

Open the adminhtml.xml file located at /app/code/local/CustomMod/etc/adminhtml.xml. This is where you’ll define your custom tabs.

Here’s an example of how to add a custom tab for the ‘Account Information’ and ‘Personal Information’ forms:

<adminhtml>
    <menu>
        <custommod translate="title" module="custommod">
            <title>Custom Module</title>
            <sort_order>100</sort_order>
            <children>
                <regs translate="title" module="custommod">
                    <title> Registrations </title>
                    <action>adminhtml/reg/index</action>
                    <sort_order>10</sort_order>
                </regs>
             </children>
        </custommod>
    </menu>

    <acl>
        <resources>
            <all>
                <title>Allow Everything</title>
                <resource>
                    <custommod translate="title" module="custommod">
                        <title>Custom Module</title>
                        <sort_order>100</sort_order>
                        <children>
                            <regs translate="title" module="custommod">
                                <title>Registrations</title>
                                <sort_order>10</sort_order>
                            </regs>
                        </children>
                    </custommod>
                </resource>
            </all>
        </resources>
    </acl>

    <layout>
        <updates>
            <custommod_install>
                <file>install.xml</file>
            </custommod_install>
        </updates>
    </layout>

    <adminhtml>
        <routers>
            <reg>
                <use>admin</use>
                <args>
                    <module>CustomMod_Reg</module>
                    <frontName>reg</frontName>
                </args>
            </reg>
        </routers>
    </adminhtml>
</adminhtml>

4. Defining the Admin Form

To create forms for each tab, you’ll need to define them in your module’s config.xml file under the <adminhtml> node:

<adminhtml>
    <forms>
        <reg_form>
            <arguments>
                <model>custommod/reg</model>
            </arguments>
            <elements>
                <!-- Define form fields here -->
            </elements>
        </reg_form>

        <personal_form>
            <arguments>
                <model>custommod/personal</model>
            </arguments>
            <elements>
                <!-- Define form fields here -->
            </elements>
        </personal_form>
    </forms>
</adminhtml>

5. Creating the Controller Actions

Finally, create a CustomerController.php file in your module’s controller directory (/app/code/local/CustomMod/controllers/Adminhtml) to handle the admin actions for each tab:

class CustomMod_Adminhtml_CustomerController extends Mage_Adminhtml_Controller_Action
{
    public function indexAction()
    {
        $this->_title($this->__('Customer'))->_title($this->__('Manage Customers'));

        $this->loadLayout();
        $this->_setActiveMenu('customer');
        $this->_addContent($this->getLayout()->createBlock('custommod/adminhtml_customer'));
        $this->renderLayout();
    }

    // Add other actions for editing, saving, and deleting customers here
}

Conclusion

Creating a custom module with multiple tabs in the Magento admin interface involves setting up configuration files, defining forms, and creating controller actions. By following this guide and using the Mage_Customer module as a reference, you can achieve a similar tab-based structure for your own custom modules.

For more advanced techniques and best practices in Magento module development, be sure to check out our comprehensive guides at Laravel Company.

Extensions Admin Configuration Customers

Our network