Skip to content
OCMLabs Docs

Hyva Compatibility

A companion module provides Tailwind CSS and Alpine.js templates for use with the Hyva theme.

Requirements

Section titled “Requirements”
  • Hyva theme installed and active
  • OrangeCollar WordPress Integration module installed
  • PHP 8.1+

Installation

Section titled “Installation”

Install the companion module alongside the base module:

Terminal window
composer require orangecollar/module-wordpress-integration-hyva
bin/magento setup:upgrade
bin/magento cache:flush

The Hyva module replaces all default Luma/Blank templates with Tailwind CSS and Alpine.js equivalents. No additional configuration is required.

What is Included

Section titled “What is Included”

The Hyva companion module (magento2-wordpress-integration-hyva/) includes:

  • Tailwind CSS templates for all blog page types (listing, post view, category, tag, author, search)
  • Alpine.js for interactive elements (search, mobile sidebar, collapsible menu)
  • Hyva-compatible widget templates
  • Sidebar block templates styled to match Hyva’s design system

Template Overrides

Section titled “Template Overrides”

To customize Hyva templates in your theme, copy them from: app/code/OrangeCollar/WordPressIntegrationHyva/view/frontend/templates/

to your theme at: app/design/frontend/Your/HyvaTheme/OrangeCollar_WordPressIntegrationHyva/templates/

Notes

Section titled “Notes”
  • The Hyva companion module depends on OrangeCollar_WordPressIntegration and will not install without it
  • If both the base module and Hyva module are installed but the Hyva theme is not active, the standard Luma/Blank templates are used
  • Tailwind CSS classes used in these templates are covered by the Hyva purge safelist - no additional configuration is needed