OCMLABS/MODULE-WORDPRESS · INSTALLATION

Install the WordPress Integration module and connect it to WordPress

  • Magento
  • Adobe Commerce
  • Hyvä

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

How-to: connecting WordPress to Magento step by step, 1:17

Requirements

  • Magento Open Source or Adobe Commerce 2.4.8 - 2.4.9
  • PHP 8.3 - 8.4
  • WordPress 6.0 or higher with the OCMLabs Content Bridge for Magento plugin (PHP 8.1 or higher on the WordPress server)

Step 1: Install the Magento Module

Composer access to the package is granted with purchase through the OCMLabs Packagist repository.

TERMINAL
$ composer require ocmlabs/module-wordpress
$ bin/magento module:enable OCMLabs_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/OCMLabs/WordPressIntegration/ in your Magento root
  3. Run the enable and upgrade commands:
TERMINAL
$ bin/magento module:enable OCMLabs_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. In WordPress Admin, go to Plugins > Add New, search for OCMLabs Content Bridge for Magento, and click Install Now. It is also available from WordPress.org.
  2. Activate the plugin
  3. Copy the generated API key from Settings > OCMLabs Content Bridge for Magento

Step 3: Connect Magento to WordPress

  1. In Magento Admin, go to Stores > Configuration > OCMLabs > 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:

TERMINAL
$ composer require ocmlabs/module-wordpress-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.

Upgrading from 1.x

Version 2.0.0 renames the module’s PHP namespace from OrangeCollar to OCMLabs. The Composer package name does not change.

TERMINAL
$ composer require ocmlabs/module-wordpress:^2.0
# Hyva stores only:
$ composer require ocmlabs/module-wordpress-hyva:^2.0
$ bin/magento module:enable OCMLabs_WordPressIntegration
$ bin/magento setup:upgrade
$ bin/magento cache:flush

setup:upgrade moves your saved settings from orangecollar_wordpress/* to ocmlabs_wordpress/* automatically. Check these by hand:

  • Theme overrides and custom code. Rename references to OrangeCollar_WordPressIntegration (templates, layout XML), OrangeCollar\WordPressIntegration (PHP classes) and orangecollar_* layout handles to their OCMLabs_ / ocmlabs_ equivalents. See Layout Handles.
  • Default Post Image. The upload folder moved from pub/media/orangecollar/wordpress/ to pub/media/ocmlabs/wordpress/. If you uploaded a default image, move the folder: mv pub/media/orangecollar/wordpress pub/media/ocmlabs/wordpress.
  • Log file. The log is now var/log/ocmlabs_wordpress.log (previously orangecollar_wordpress.log).

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.

See also

Related pages

In this module