Home » Magento, Magento 27 April 2016

Magento 2: Simple Hello World Module – Step-by-Step Beginner Tutorial

This beginner step-by-step tutorial shows how you can create a simple and basic HelloWorld module / extension in Magento 2. The necessary files are listed with the code.

This module just calls a block function in template file to print Hello World text.

Things to note:

In Magento 2, there is no code pool. So, no more confusion with app/code/local, app/code/core, and app/code/community. Your module will simply be in the directory app/code/YourNamespace/YourModule.

Also, everything related to your module will be inside your module directory (app/code/YourNamespace/YourModule). So, there is no more separate design folder (app/design/frontend/default/default/template) for templates or layouts, or no more separate folder for module configuration xml (app/etc/modules).

Here are the folders that can be in your module directory (app/code/YourNamespace/YourModule):

Block: contains PHP view classes
Controller: contains PHP controller classes
etc: contains configuration files; like modules.xml, routes.xml
Model: contains PHP model classes
Setup: contains classes for module database structure and data setup which are invoked when installing or upgrading.
Api: contains any PHP classes exposed to the API.
i18n: contains localization files.
Plugin: contains any needed plug-ins.
view: contains view files, including static view files, design templates, email templates, and layout files.

For more detail: Magento 2 module file structure

Here is the step-by-step guide on creating Magento 2 module/extension.

I have set the module’s namespace as Chapagain and module’s name as HelloWorld. So, our module is Chapagain_HelloWorld.

1) Create Module’s Configuration File


2) Create Module’s Frontend Router File


Note: frontName="helloworld" in the above code. This indicates that helloworld is used in the URL to access our module.

3) Create Controller Class

In Magento 2, we should create a separate controller class for each action. Each controller class will only have one method named execute().


for indexAction() of IndexController, we will create app/code/Chapagain/HelloWorld/Controller/Index/Index.php

for viewAction() of IndexController, we will create app/code/Chapagain/HelloWorld/Controller/Index/View.php

Here, we will create a controller class for indexAction for our module.


Here, the execute() method does the work of loadLayout() and renderLayout() in Magento 1.x.

4) Create Block Class

Here, I have written the constructor but haven’t used it much. We will be using the constructor a lot in Magento 2 for dependency injection purpose. But for now, let’s only focus on the getHelloWorld() function which returns Hello World text.


5) Create Design Layout File


As you can see above, helloworld.phtml template file is called for the block class HelloWorld. The title of the page is defined as Simple Magento 2 Module. We have also defined our page layout as 1column.

6) Create Design Template File

In template file, we can write custom HTML tags and also call the block function.

Here, we will call the getHelloWorld() function of our block class.


Note that, in Magento 2, we call the block object as $block.

7) Register your Module

You have to register your module in your Magento 2. This is done through Magento ComponentRegistrar class. You should create a new file named registration.php in your module’s directory.


8) Activate the Module

Finally, you have to activate your module. There are two ways to do so.

a) Editing app/etc/config.php

Open app/etc/config.php add a key/value (YourNamespace_YourModule => 1) in the array of that file.

b) Through command in terminal

– Open terminal
– Go to your Magento 2 root folder
– Run the following command:

If it doesn’t work, then you can try using sudo at the beginning of the command.

This will automatically add our module entry in the app/etc/config.php file.

9) Clean/Flush Cache

Last but not the least. Don’t forget to flush Magento 2 cache.

You can manually delete all files and folders inside the following directories:
var/cache/ (magento cache)
var/page_cache/ (full page cache)
var/generation/ (compiled code)

Or, you can delete them through command line:

Or, the best way to clean or flush cache is to use Magento command in terminal:

You can either use cache:clean OR cache:flush.

cache:clean = Deletes all items from enabled Magento cache types only. Disabled cache types are not cleaned.
cache:flush = Purges the cache storage. All cache types are flushed/deleted.

If it doesn’t work, then you can try using sudo at the beginning of the command.

To check the enabled/disabled status of all cache types, you can run the following command:

All done. Now, our Magento 2 ‘HelloWorld‘ module should have been installed. We can browse it in the URL.


Or, simply http://example.com/helloworld/

When you browse the above URL, you should get something like this in the browser:

Magento 2 Simple HelloWorld Module

Hope this helps. Thanks.

Magento 2

Get New Post by Email

Find me on

FacebookTwitterGoogle+LinkedInRSS Feed

Comments are closed.