Magento - create a helper class

Magento - create a helper class

July 17, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento - create a helper class

Magento: Creating a Helper Class for Global Functionality

Hello developers! I hope this post finds you well and ready to dive into some powerful Magento magic. Today, we’re going to tackle a common challenge: creating a helper class with a reusable function that can be accessed from any *.phtml file in your Magento store.

Understanding the Challenge

Let’s say you have an awesome new feature like a custom login system or dynamic product pricing calculation. You want this functionality to be available everywhere, but creating individual functions for each PHTML file would be repetitive and messy. That’s where helper classes come into play!

Step 1: Create Your Helper Class

First things first—let’s create our helper class. Open up your terminal and navigate to the app/code folder of your Magento installation.

cd app/code

Now, let’s create a new module if you haven’t already:

mkdir -p your_module/Helper

Replace “your_module” with the name of your custom module (remember to follow Magento’s naming conventions).

Step 2: Define Your Helper Method

Open up your newly created app/code/your_module/Helper folder and create a file called Data.php. This will be our helper class.

<?php
namespace Your\Module\Helper;

use Magento\Framework\App\ObjectManager;

class Data extends \Magento\Framework\DataObject implements \Magento\Framework\Option\ArrayInterface
{
    public function prtHelloWorld($arg1)
    {
        return "Hello world: {$arg1}!";
    }
}

In this example, we’ve created a method called prtHelloWorld that accepts an argument and returns a greeting message. Don’t forget to replace Your\Module\Helper with the appropriate namespace for your module.

Step 3: Make Your Helper Available

To make our helper available globally, we need to register it as a singleton in our module’s configuration.

Open up app/code/your_module/etc/module.xml:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Module/etc/module.xsd">
    <module name="Your_Module"
           setup_version="1.0.0"
           sequence="999999"
           provider-type="url"
           active="true"
           code_pool="community"/>
</config>

Next, open up app/code/your_module/etc/di.xml:

<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <preference for="Your\Module\Helper\Data"
               type="Magento\Framework\View\Element\Template"
               />
</config>

The preference tag tells Magento to replace the default _getSession method with our custom prtHelloWorld function.

Step 4: Call Your Helper Function

Now that everything is set up, you can call your helper function from any PHTML file in your store!

Open up one of your PHTML files (e.g., app/design/frontend/Vendor/theme/Magento_Theme/templates/html/test.phtml) and add the following code:

<?php echo $block->getData('prtHelloWorld', 'John Doe'); ?>

The function call is wrapped in a PHP block using $block which represents the current block instance.

Step 5: Compile Your Magento Store

After making these changes, you need to compile your store for the new helper to take effect:

php bin/magento setup:di:compile

Conclusion

And that’s it! You now know how to create a powerful helper class with reusable functionality in Magento.

Remember to always follow naming conventions and keep your code clean. This approach can significantly improve your development efficiency by allowing you to reuse common functions across your entire Magento store.

Don’t forget to check out our other Magento tutorials on Laravel Company for more tips, tricks, and best practices!

Happy coding!

Catalog Extensions Themes Pricing

Our network