Installation

The WordPress Integration module has two components that must both be installed: the Magento module and the WordPress plugin.

Step 1: Install the Magento Module

Via Composer (recommended)

composer require orangecollar/module-wordpress-integration
bin/magento module:enable OrangeCollar_WordPressIntegration
bin/magento setup:upgrade
bin/magento cache:flush

Manual installation

1. Download the module and extract it
2. Copy the contents to app/code/OrangeCollar/WordPressIntegration/ in your Magento root
3. Run the enable and upgrade commands:

bin/magento module:enable OrangeCollar_WordPressIntegration
bin/magento setup:upgrade
bin/magento cache:flush

Step 2: Install the WordPress Plugin

See the WordPress Plugin Installation page for full instructions.

In summary:

1. Upload oc-magento-bridge.zip via WordPress Admin > Plugins > Add New > Upload Plugin, or copy the plugin folder to wp-content/plugins/oc-magento-bridge/
2. Activate the plugin
3. Copy the generated API key from Settings > OC Magento Bridge

Step 3: Connect Magento to WordPress

1. In Magento Admin, go to Stores > Configuration > Orange Collar > WordPress Integration
2. Enter your WordPress URL (e.g., https://blog.example.com)
3. Paste the API key from the WordPress plugin settings
4. Click Test Connection to verify
5. Save the configuration
6. Flush the Magento cache: bin/magento cache:flush

Hyva Compatibility

If you use the Hyva theme, install the companion module:

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

This replaces the default Luma/Blank templates with Tailwind CSS and Alpine.js templates optimized for Hyva. See the Hyva Compatibility page for details.

Verifying Installation

After installation and configuration, visit https://yourstore.com/blog (or your configured base URL). You should see the WordPress post listing.

If you see a 404, check the Troubleshooting page.