Etechflow_RichSnippets

Hyvä-native structured-data module for Magento 2 / Adobe Commerce. Emits a single
cross-linked schema.org JSON-LD @graph per page plus OpenGraph + Twitter
Card meta. A leaner, self-owned alternative to Mirasvit_SeoMarkup.

Schema coverage

Entities are linked by @id (e.g. Offer.seller and WebSite.publisher resolve
to the single Organization node).

Architecture

• Block classes render via _toHtml() (Block/Product, Category, Cms, Meta)
  returning the <script>/<meta> string directly — no .phtml templates. This is
  deliberate: in production mode with HTML minification, new module templates require a
  preprocessed copy; rendering from PHP sidesteps that entirely.
• Schema-building logic lives in ViewModel/* (Product, Category, CmsPage, Site,
  Breadcrumbs, OpenGraph, Config) so it is unit-testable and reusable.
• Prices are tax-aware (honour tax/display/type) and use the active store currency.

Configuration

Stores → Configuration → Etechflow → Rich Snippets

Install

bin/magento module:enable Etechflow_RichSnippets
bin/magento setup:upgrade
rm -rf generated/code/* generated/metadata/*   # required: di:compile won't clean this itself
bin/magento setup:di:compile
bin/magento cache:flush
# then flip the master switch on:
bin/magento config:set etechflow_richsnippets/general/enabled 1

If replacing another provider (e.g. Mirasvit), disable its output first to avoid
duplicate schema. To avoid a duplicate breadcrumb, suppress the theme's native
breadcrumb JSON-LD (this module's breadcrumb is the full category path).

Tests

vendor/bin/phpunit -c dev/tests/unit/phpunit.xml.dist app/code/Etechflow/RichSnippets/Test/Unit

Changelog

All notable changes to this module are documented here.

v1.0.0 — 2026-06-05

Initial public release.

Hyva-native rich snippets (schema.org JSON-LD @graph) + OpenGraph + Twitter Card meta. Lean alternative to Mirasvit_SeoMarkup. Tax-aware pricing.