README

Integrates the Tabler Icons free SVG icon set into Hyvä Themes, exposing outline and filled styles as dedicated SvgIcons view models. Browse the included icons in the SVG directory or preview them at tabler.io/icons.

Note

This module only includes the free Tabler Icons set.

Installation

composer require aimanecouissi/module-hyva-tabler-icons
bin/magento module:enable AimaneCouissi_HyvaSvgIcons AimaneCouissi_HyvaTablerIcons
bin/magento setup:upgrade
bin/magento cache:flush

Usage

In Hyvä PHTML templates

Require the view models for the styles you need and call their helper methods to render icons:

<?php

use AimaneCouissi\HyvaTablerIcons\ViewModel\TablerIconsFilled;
use AimaneCouissi\HyvaTablerIcons\ViewModel\TablerIconsOutline;
use Hyva\Theme\Model\ViewModelRegistry;

/** @var ViewModelRegistry $viewModels */

$tablerIconsOutline = $viewModels->require(TablerIconsOutline::class);
$tablerIconsFilled = $viewModels->require(TablerIconsFilled::class);
?>

<?= $tablerIconsOutline->shoppingCartHtml('w-6 h-6', 24, 24, ['aria-label' => 'Cart']) ?>
<?= $tablerIconsFilled->starHtml('w-5 h-5 text-yellow-400', 20, 20, ['aria-hidden' => 'true']) ?>

Methods are generated from SVG filenames and fully documented via PHPDoc on each view model, so your IDE can autocomplete them.

In CMS content

The module registers two icon prefixes for Hyvä SvgIcons: tablericons-outline and tablericons-filled. Icons can be used directly in CMS pages, blocks, and widgets:

{{icon "tablericons-outline/shopping-cart" classes="inline-block w-6 h-6" width=24 height=24}}
{{icon "tablericons-filled/star" classes="inline-block w-5 h-5 text-yellow-400" width=20 height=20}}

Uninstall

bin/magento module:disable AimaneCouissi_HyvaTablerIcons
composer remove aimanecouissi/module-hyva-tabler-icons
bin/magento setup:upgrade
bin/magento cache:flush

Changelog

See CHANGELOG for all recent changes, including icon set version updates.

License

The Tabler Icons SVG icons are created by Tabler and licensed under MIT.

Warning

Individual brand icons may be subject to their own trademark and usage guidelines. Trademark usage is the responsibility of the end user. Please consult individual brand guidelines before displaying logos in commercial contexts.

This module's source code is separately licensed under MIT.