Kowal Custom Tab - installation and configuration

Requirements

• Magento 2.4 or newer.
• Access to Magento CLI.
• Composer configured to download private Kowal packages.
• Installed base module kowal/base.
• Administrator permissions for the Magento panel.

Installation via Composer

Add the package repository:

composer config repositories.custom.tab vcs https://github.com/kowalco/magento-2-custom-tab

If the repository requires authorization, configure a token:

composer config --global --auth github-oauth.github.com 

Install the module:

composer require kowal/module-customtab

Run the Magento update:

php bin/magento setup:upgrade

In a production environment, run DI compilation and static content deployment according to the project process:

php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy

Flush the cache:

php bin/magento cache:flush

Installation verification

Check whether the module is active:

php bin/magento module:status Kowal_CustomTab

If the module is inactive, enable it:

php bin/magento module:enable Kowal_CustomTabphp bin/magento setup:upgradephp bin/magento cache:flush

Module configuration

In the Magento panel, go to:

Stores > Configuration > Kowal > Custom Tab

Set the Enable module option to Yes, then save the configuration and flush the cache if Magento asks you to do so.

Managing tabs

In the admin panel, go to:

Kowal > Custom Tabs > Custom Tab

Click Add new CustomTab to create a new tab.

Fill in the fields:

• Name - the tab name visible on the frontend.
• Field type - the content source type.
• Attribute code - the product attribute from which the tab content should be loaded.
• Status - tab activity status.
• Sort Order - the tab display order.

Save the tab.

Translating the tab name

The default tab name is saved for store_id = 0.

To add a translation for a specific Store View:

1. Open an existing tab for editing.
2. Use the Store View switcher in the upper-right area of the form.
3. Select the Store View for which you want to change the name.
4. Clear Use Default Value next to the Name field.
5. Enter the tab name for the selected language version.
6. Save the form.

If Use Default Value remains selected, the module will use the default value from store_id = 0.

Frontend behavior

The module adds tabs to the product details section. A tab appears only when the product has a completed value in the attribute specified in the tab configuration.

For the tab name, the module applies fallback:

1. Name for the current Store View.
2. Default name from store_id = 0.
3. Value from the main tabs table, kept for compatibility.

The tab content is filtered by the Magento CMS mechanism, so it may contain HTML tags and widgets supported by Magento.

Updating an existing installation

After updating the module to a version with multilingual support, run:

php bin/magento setup:upgradephp bin/magento cache:flush

The new per-Store View values table will be added by the Magento declarative schema. After the first save of an existing tab, its default name will also be persisted as a store_id = 0 record.

Troubleshooting

If a tab does not appear on the frontend:

• Check whether the module is enabled in the configuration.
• Check whether the tab has Status set to Yes.
• Check whether the product has a completed value in the attribute specified in the Attribute code field.
• Flush the Magento cache.
• Make sure the theme layout still renders the product.info.details block.

If the name translation does not appear on the frontend:

• Check whether you are editing the correct Store View.
• Check whether Use Default Value is cleared for the Name field.
• Save the tab and flush the cache.