Hyva Compatibility
OCMLabs FAQ works on Luma and Blank themes out of the box using Magento’s standard RequireJS pattern. Hyva themes do not ship RequireJS, so Hyva stores install a small companion module that replaces the storefront rendering layer with Alpine.js.
Installation
Section titled “Installation”See Installation > Hyva theme for the Composer and enable commands.
Both modules must be installed together on a Hyva store. The core OCMLabs_Faq module provides the admin grid, data layer, configuration, and JSON-LD schema output. The companion OCMLabs_FaqHyva module provides the Hyva-compatible frontend template.
What changes
Section titled “What changes”| Aspect | Luma / Blank | Hyva |
|---|---|---|
| Frontend JS | RequireJS faqAccordion widget | Alpine.js directives on the accordion markup |
| Template | faq-tab.phtml (module) | Overridden by OCMLabs_FaqHyva |
| Accessibility | WCAG 2.1 Level AA | Same (the Hyva template preserves the ARIA structure) |
| JSON-LD schema | Emitted from core module | Unchanged - emitted from core module |
| Admin experience | Identical | Identical |
Admin management (grid, edit form, configuration, ACL) is completely unchanged. The only difference is how the accordion is rendered and scripted on the product page.
Accessibility on Hyva
Section titled “Accessibility on Hyva”The Hyva template preserves the heading-wrapped button pattern, the labelled region roles, and the focus indicator styling described in Accessibility. The audited WCAG 2.1 Level AA conformance applies on Hyva as well.
Fallback behaviour
Section titled “Fallback behaviour”If OCMLabs_Faq is installed on a Hyva store without OCMLabs_FaqHyva, the accordion falls back to the Luma template, which will not work on Hyva (RequireJS is absent). Install both modules together.