Skip to content

JaJuMa-GmbH/hyva-flags

Repository files navigation

Hyvä Flags for Magento 2 & Mage-OS with Hyvä Themes by JaJuMa

Hyvä Flags extension by JaJuMa provides country & language icons as SVGs for Magento 2 & Mage-OS sites using Hyvä Themes.



Compatible with

Hyvä Themes Mage-OS Magento

Features

Hyvä Flags for Magento & Mage-OS with Hyvä Themes

  • includes almost 1000 country & language flag icons:
    • Square Flag Icons (1:1 ratio)
    • Rectangle Flag Icons (3:2 + 4:3 ratio)
    • Official Flag Sizes &
    • Circle Flag Icons
  • provides 5 ViewModels for adding country & language flag icons in code
  • allows adding country & language flag icons in CMS content from Backend.

Further Info, Extension Description & Manual

Demo

Country & language flag icons for Hyvä Themes Demo:

Icon List

List view and detail view with all included icons for copy & paste the code to use the icons in your project:

Note
Need more Icons for Your Hyvä Themes project?
➡️ Check our Awesome Hyvä for Hyvä Themes module for Font Awesome 5 & 6 Icons

Installation

Install via composer as any other Magento extension from github:

composer require jajuma/hyva-flags

or get it from Extension Website for manual installation in app/code/ as any other Magento extension.

Using country & language flag icons in Hyvä Themes with JaJuMa "Hyvä Flags" module

How to use country & language flag icons in Hyvä Themes in view models

JaJuMa "Hyvä Flags" module provides 5 view models:

  • Flagicons11
  • Flagicons32
  • Flagicons43
  • FlagiconsCircle
  • FlagiconsOfficial

Require one of the view models in your template:

/** @var \Jajuma\HyvaFlags\ViewModel\Flagicons11 $flagicons11 */
$flagicons11 = $viewModels->require(\Jajuma\HyvaFlags\ViewModel\Flagicons11::class);
/** @var \Jajuma\HyvaFlags\ViewModel\Flagicons32 $flagicons32 */
$flagicons32 = $viewModels->require(\Jajuma\HyvaFlags\ViewModel\Flagicons32::class);
/** @var \Jajuma\HyvaFlags\ViewModel\Flagicons43 $flagicons43 */
$flagicons43 = $viewModels->require(\Jajuma\HyvaFlags\ViewModel\Flagicons43::class);
/** @var \Jajuma\HyvaFlags\ViewModel\FlagiconsCircle $flagiconscircle */
$flagiconscircle = $viewModels->require(\Jajuma\HyvaFlags\ViewModel\FlagiconsCircle::class);
/** @var \Jajuma\HyvaFlags\ViewModel\FlagiconsOfficial $flagiconsofficial */
$flagiconsofficial = $viewModels->require(\Jajuma\HyvaFlags\ViewModel\FlagiconsOfficial::class);

Then render the icons like this:

<?= $flagicons11->acHtml('text-red-100', 24, 24) ?>
  • The method name is the camel cased icon name, followed by Html.
  • In an IDE you should have autocompletion for all available methods.
  • The parameters are optional, and change the class (in single quotes) followed by 2 values for width and height attributes of the SVG element.
  • It is recommended to set all of them, so that the images are not rendered in huge sizes if CSS fails to load.

or you may also pass additional attributes like this as an array:

<?= $flagicons11->acHtml('w-10 h-10', 24, 24, ['style'=>'position:relative']) ?>

How to use country & language flag icons in Hyvä Themes in CMS content

Awesome Hyvä module adds an icon directive to render icons in filtered content like CMS blocks or pages. So you may add icons in text / code blocks like this:

{{icon "flagicons/1x1/ac" classes="text-red-100" width=12 height=12}}
  • "classes" parameter is used for setting any css class.
  • "width"/"height" parameters are used for setting width/height attributes for icons.
  • Hint: You may get the code snippets for copy & paste for each icon on the demo - see link below.

License

The code is licensed under the MIT License (MIT)

Alternative Flag Icons for Hyvä Themes

Credits

Credits for the SVG icons:

Other Services by JaJuMa

© JaJuMa GmbH | www.jajuma.de