Kowal Product Info - installation and configuration guide
Requirements
- Magento 2 with the
Magento_Catalog module enabled. - Access to the server console.
- Permissions to run
bin/magento commands. - Administrator access to the Magento panel.
Installation via Composer
- Add the module repository:
composer config repositories.product.info vcs https://github.com/kowalco/product-info
- If the repository is private, add a GitHub token:
composer config --global --auth github-oauth.github.com
- Install the module:
composer require kowal/module-productinfo
- Enable the module:
php bin/magento module:enable Kowal_ProductInfo
- Run the database update:
php bin/magento setup:upgrade
This command will add:
- the product attribute
kowal_product_info_display, - the
kowal_productinfo_icon_group and kowal_productinfo_icon tables.
- In production mode, rebuild DI and static assets:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
- Flush the cache:
php bin/magento cache:flush
Manual Installation
- Copy the module to the directory:
app/code/Kowal/ProductInfo
- Run:
php bin/magento module:enable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush
- In production mode, additionally run:
php bin/magento setup:di:compilephp bin/magento setup:static-content:deploy
Global Configuration
Admin panel:
Stores > Configuration > Kowal > Product info
Settings
The Ustawienia section controls the base icon block.
Wlacz - enables or disables the base block on the product page.Naglowek nad ikonami - heading displayed above the base icon set.
The sections from Informacja 1 to Informacja 7 define the base icon set.
For each information item, you can set:
Ikona - an SVG, PNG, JPG, JPEG, GIF, or WEBP file,Naglowek - text displayed next to the icon,Tresc - tooltip content.
The base block is displayed on the product page in the existing module layout.
Dynamic Icon Groups
The Dynamiczne grupy ikon section controls the new feature for assigning icon groups to products.
Wlacz dynamiczne grupy na karcie produktu - enables rendering of dynamic groups on the PDP.Maksymalna liczba grup na produkcie - limit of groups displayed on a single product page; 0 means no limit.
Per-Product Configuration
The following attribute is available on the product form:
Obecny blok ikon Product Info
Options:
Dziedzicz z konfiguracji - the product uses the global Wlacz setting.Wlacz na tym produkcie - the base icon block is shown even when it is globally disabled.Wylacz na tym produkcie - the base icon block is hidden even when it is globally enabled.
This setting applies only to the base icon block. Dynamic groups are managed separately.
Managing Dynamic Icon Groups
Admin panel:
Kowal > Product Info > Grupy ikon
Adding a Group
- Click
Dodaj grupe ikon. - Set
Status. - Enter
Nazwa techniczna. - Optionally enter
Naglowek na karcie produktu. - Optionally enter
Tooltip grupy. - Set
Priorytet; a lower value means a higher position on the product page. - Select
Store View; All Store Views means all store views. - Select
Typ dopasowania. - Fill in
SKU or ID kategorii, according to the selected match type. - Add icons in the
Ikony w grupie section. - Save the group.
Match Types
SKU lub kategoria - the group will appear if the product matches by SKU or by category.Tylko SKU - the group will appear only for products with the specified SKU values.Tylko kategoria - the group will appear only for products assigned to the specified categories.
SKU and category ID values can be entered separated by commas or with each value on a new line.
Configuring Icons in a Group
For each icon, you can set:
Status,Sort order,Tytul,Plik ikony,Sciezka lub URL ikony,Tooltip,Usun ikone.
An uploaded icon file overrides the manually entered path or URL for that row.
CMS/Page Builder Widget
The module provides the following widget:
Product Info
The widget displays the base information set from the global configuration in a horizontal layout. Dynamic icon groups are intended for product pages and are not rendered in CMS widgets by default.
Post-Configuration Test
After installation and configuration, check:
- A product with the
Dziedzicz z konfiguracji setting. - A product with the
Wlacz na tym produkcie setting. - A product with the
Wylacz na tym produkcie setting. - A product assigned to the category used in a dynamic group.
- A product with a specific SKU used in a dynamic group.
- A product that does not match any dynamic group.
- Tooltips for the base block and dynamic groups.
- Correct icon display after flushing the cache.
Cache and Change Deployment
After changing the configuration, icon groups, or icon files, flushing the cache is recommended:
php bin/magento cache:flush
After changes to LESS, JS, or template files in production mode, static assets must be rebuilt:
php bin/magento setup:static-content:deployphp bin/magento cache:flush
Uninstallation
Disable the module:
php bin/magento module:disable Kowal_ProductInfophp bin/magento setup:upgradephp bin/magento cache:flush
Data removal from the database is not performed automatically by the commands above. Before manually removing tables and the product attribute, create a database backup.