How to create admin->system->configuration menu in Magento 1.7?

How to create admin->system->configuration menu in Magento 1.7?

July 18, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to create admin->system->configuration menu in Magento 1.7?

Configuring an Admin Menu for Magento 1.7

Creating a custom admin menu in Magento 1.7 allows you to streamline your store management and provide easy access to specific configuration options. This guide will walk you through the process of creating a new menu item under admin->system->configuration for your custom module.

Creating the Configuration File

First, you need to create a configuration file that defines your custom menu. In your module’s root directory, create a etc folder and inside it, an adminhtml.xml file:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Store:etc/config.xsd">
    <default>
        <my_module>
            <section>
                <group>
                    <label>My Custom Config</label>
                    <sort_order>10</sort_order>
                    <show_in_default>1</show_in_default>
                    <show_in_store>1</show_in_store>
                </group>
            </section>
        </my_module>
    </default>
</config>

In this example, we have created a section called my_module with a single group named My Custom Config. You can customize the label and sort order as needed.

Defining the Menu Item

Next, you need to define your custom menu item. In your module’s root directory, create an etc/adminhtml/acl.xml file:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Adminhtml:etc/acl.xsd">
    <acl>
        <resources>
            <resource id="your_module">
                <title>Your Module</title>
                <sort_order>100</sort_order>
            </resource>
            <resource id="your_module::your_configuration_path">
                <title>My Custom Config</title>
                <sort_order>1</sort_order>
                <children>
                    <resource id="your_module::your_configuration_path:your_section_identifier">
                        <title>Your Section Title</title>
                        <sort_order>10</sort_order>
                    </resource>
                </children>
            </resource>
        </resources>
    </acl>
</config>

Here, we have defined a new resource for our module and created a child resource for the configuration path. The your_configuration_path should match your section identifier from the previous step.

Integrating with Your Module

Finally, you need to integrate this menu into your module’s admin interface. In your module’s root directory, create an etc/adminhtml/menu.xml file:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Backend:etc/menu.xsd">
    <menu>
        <add id="your_module::your_configuration_path"
             title="My Custom Config"
             module="your_module"
             sortOrder="1000"
             parent="Magento_Backend::content"
            action="your_module/index/configure" />
    </menu>
</config>

In this file, we are adding a new menu item with the identifier your_configuration_path under the Content menu in the admin interface. The action attribute should point to the controller that handles your configuration form.

Conclusion

By following these steps, you can successfully create a custom admin menu for your Magento 1.7 module. This allows you to provide a user-friendly interface for managing your module’s configurations directly from the admin->system->configuration area.

Remember, it is essential to replace your_module and other placeholders with the actual identifiers of your module throughout this process. Also, ensure that your module follows Magento’s coding standards and best practices for optimal performance and security.

For more advanced configuration and menu management techniques in Magento, I recommend exploring our comprehensive guide on Admin Configuration Management at Laravel Company.

Magento 1 Extensions Admin Configuration

Our network