Skip to content

Naming Conventions

Magento Module:

The module name consists of the Hyva namespace and the concatenation of the original module namespace and module name.

For example:

  • Original: Smile_ElasticSuite
  • Compat Module: Hyva_SmileElasticSuite

Composer Package:

The composer vendor name is hyva-themes.

The full package name is hyva-themes/magento2-<original-module>.

For example:

  • Original: smile/magento-elasticsuite
  • Compat Module: hyva-themes/magento2-smile-elasticsuite

Other Vendor Names

The naming convention described here applies to packages hosted on gitlab.hyva.io with the vendor name hyva-themes.
For compatibility modules hosted in external repositories, for example GitHub, another vendor name is used.
There hyva should be included in the package name instead.

For example, the original module my-org/magento-integration Hyvä compatibility module should be something like my-org/magento-hyva-integration.

Folder Structure:

Hyvä modules and compatibility modules use the following folder structure and minimal set of files:

magento2-example-module/
├── LICENSE.md
├── README.md
├── composer.json
└── src
    ├── etc
    │   ├── frontend
    │   │   └── di.xml
    │   └── module.xml
    └── registration.php

3 directories, 6 files

Any tests go into a tests/ directory on the same level as src/.

The basic folder structure including the LICENSE.md and README.md files are already present in new Compatibility Module repositories.

The LICENSE.md file is a copy of the Hyvä Themes Software User License and must not be changed.

The README.md file contains basic information about the original module. You can add any additional information that might be required for the Compatibility Module to work.