Magento 1.9 create new Hello World module

Magento 1.9 create new Hello World module

July 1, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento 1.9 create new Hello World module

Magento 1.9: Creating Your First “Hello World” Module

Introduction

Welcome, developers! Today we’re going to guide you through creating your first simple module in Magento 1.9. This step-by-step tutorial will help you understand the basics of Magento module development.

The Problem at Hand

Our user here has created a new module following proper steps but is struggling with getting it to display “Hello World” from their PHTML file when visiting the module URL (http://127.0.0.1/magento/helloworld).

Step-by-Step Solution

Step 1: Module Declaration

First, you need to declare your new module in app/etc/modules/M4U_HelloWorld.xml:

<?xml version="1.0"?>
<config>
    <modules>
        <M4U_HelloWorld>
            <active>true</active>
            <codePool>local</codePool>
        </M4U_HelloWorld>
    </modules>
</config>

Step 2: Module Configuration

Sub-Step 2.1: Controller Class

Create your controller class in app/code/local/M4U/HelloWorld/controllers/IndexController.php:

class M4U_HelloWorld_IndexController extends Mage_Core_Controller_Front_Action
{
    public function indexAction()
    {
        $this->loadLayout(array('default'));
        $this->renderLayout();
    }
}

Sub-Step 2.2: Block Class

Next, create your block class in app/code/local/M4U/HelloWorld/Block/HelloWorld.php:

class M4U_HelloWorld_Block_HelloWorld extends Mage_Core_Block_Template
{
    // necessary methods here
}

Sub-Step 2.3: Configuration XML File

Now, create your configuration XML file in app/code/local/M4U/HelloWorld/etc/config.xml:

<?xml version="1.0"?>
<config>
    <global>
        <modules>
            <m4u_helloworld>
                <version>0.1.0</version>
            </m4u_helloworld>
        </modules>
        <blocks>
            <helloworld>
                <rewrite>
                    <helloworld>M4U_HelloWorld_Block_HelloWorld</helloworld>
                </rewrite>
            </helloworld>
        </blocks>
    </global>
    <frontend>
        <routers>
            <helloworld>
                <use>standard</use>
                <args>
                    <module>M4U_HelloWorld</module>
                    <frontName>helloworld</frontName>
                </args>
            </helloworld>
        </routers>
        <layout>
            <updates>
                <helloworld>
                    <file>helloworld.xml</file>
                </helloworld>
            </updates>
        </layout>
    </frontend>
</config>

Step 3: Define Frontend Template

Sub-Step 3.1: Page Layout

Define your page layout in app/design/frontend/default/default/layout/helloworld.xml:

<?xml version="1.0"?>
<layout version="0.1.0">
    <helloworld_index_index>
        <reference name="root">
            <action method="setTemplate">
                <template>page/1column.phtml</template>
            </action>
        </reference>
        <reference name="content">
            <block type="helloworld/helloworld" name="hello" template="helloworld/helloworld.phtml"/>
        </reference>
    </helloworld_index_index>
</layout>

Sub-Step 3.2: Template File

Finally, create your template file in app/design/frontend/default/default/template/helloworld/helloworld.phtml:

<?php echo $this->__('Hello World!'); ?>

Common Mistakes to Avoid

  1. Missing or Incorrect XML Namespace: Ensure you have the correct namespace and version for your XML files.
  2. Case Sensitivity in File Names: Magento is case-sensitive, so ensure you maintain consistency with file names.
  3. Incomplete Paths: Double-check all file paths are complete and accurate.

Conclusion

Creating a simple “Hello World” module is a great starting point for understanding Magento development. By following these steps closely and double-checking your XML files, you should be able to get your module displaying correctly.

Remember, while this guide focuses on Magento 1.9, many of the principles remain applicable in later versions like Magento 2.x. If you’re looking to advance your skills, consider exploring more complex functionalities or visiting our Magento Development Resources for further learning.

Happy coding! Let us know if you have any questions or encounter other issues with your Magento development journey.

Magento 1 Extensions Themes Configuration

Our network