Add a Custom Tab to Product View Page using Custom Module - Magento

Add a Custom Tab to Product View Page using Custom Module - Magento

August 7, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Add a Custom Tab to Product View Page using Custom Module - Magento

Adding a Custom Tab to Product View Page Using Custom Module in Magento

Introduction

In this tutorial, we’ll guide you through the process of creating a custom module that adds a tab to the product view page in Magento. This tab will contain a form for users to enter certain information, which can be edited and viewed in the admin backend.

Prerequisites

Before starting, make sure you have:

  • A basic understanding of Magento’s architecture.
  • Familiarity with XML layout files and configuration files.
  • Access to the Magento file system through SSH or SFTP.

Step 1: Understanding the Current Layout

Default Tab Structure

By default, Magento allows you to add tabs to the product view page using the catalog_product_view_tabs block. This block is defined in the catalog.xml layout file located at:

app/design/frontend/<your_theme>/<your_package>/layout/catalog.xml

Here’s an example of how a tab is currently added:

<block type="catalog/product_view_description" name="product.description" as="description">
    <action method="setTitle" translate="title"><title>Description</title></action>
</block>

Your Custom Tab Structure

You have already started configuring your custom tab in the catalog.xml file. Here’s how it looks:

<reference name="content">
    <block type="catalog/product_view_tabs" name="product.info.tabs" as="info_tabs" template="catalog/product/view/tabs.phtml">
        <action method="addTab" translate="title" module="catalog">
            <!-- Your custom tab definition -->
        </action>
    </block>
</reference>

Step 2: Defining the Layout for Your Custom Tab

The cm_askquestion/list Block

Your current layout file (cm_askquestion.xml) defines a block named catalog.ask.question. This block is rendered using your custom template (list.phtml).

<reference name="product.info.tabs">
    <block type="cm_askquestion/list" name="catalog.ask.question" template="cm_askquestion/list.phtml">
        <block type="core/template" name="question.form" as="questionForm" template="cm_askquestion/form.phtml" />
    </block>
</reference>

The form.phtml Template

This is the form template that will be rendered when a user clicks on “Ask a Question”. However, it’s currently configured to work in a separate tab.

Step 3: Configuring Your Custom Tab

Opening the Form in the Same Tab

To open the form in the same tab when the link is clicked, you need to modify your list.phtml file. Update the JavaScript code that handles the click event:

$('add-question').observe('click', function(event){
    $('questionForm').toggle();
});

Step 4: Saving and Retrieving User Data

The Admin Grid

To make this data editable in the admin backend, you’ll need to create an admin grid. This involves extending the Mage_Adminhtml_Block_Catalog_Product block and adding a new grid.

The Database Table

You’ve already created a database table for storing the question data (cm_askquestion_question) using the tutorial link provided in your question.

Step 5: Configuring Your Module

Configuration File (config.xml)

This file is located at app/code/local/Companyname/Modulename/etc/config.xml. It’s used to define configuration parameters for your module. Here, you can specify the admin route and resource model for your custom grid.

Admin Routes

To add a new tab under the Catalog section of the admin backend, you’ll need to extend the Mage_Adminhtml_Catalog_ProductController controller. This is where you define the URL that handles the form submission (index/addQuestion).

Conclusion

Adding a custom tab to the product view page in Magento involves several steps:

  1. Defining the layout for your custom block.
  2. Configuring your custom tab to open in the same tab as the link.
  3. Creating an admin grid and database table for data storage.
  4. Modifying the configuration file for admin routing.

Remember, Magento’s architecture is modular and extensible, allowing you to add new functionality without modifying core files. If you have any further questions or need additional guidance, please don’t hesitate to ask!

For more detailed information on Magento module development, check out our comprehensive guide at Laravel Company to learn best practices and advanced techniques.

Catalog Extensions Themes Admin

Our network