OCMLABS/MODULE-WORDPRESS · CONNECTION SETUP

Connection Setup

  • Magento
  • Adobe Commerce
  • Hyvä

The Connection group is the first thing to configure after installing the module. It tells Magento where your WordPress site is and how to authenticate with it.

Admin path: Stores > Configuration > OCMLabs > WordPress Integration > Connection

Settings

WordPress URL

The full URL to your WordPress installation, including the protocol.

  • Example: https://blog.example.com
  • No trailing slash
  • Must be reachable from the Magento server (not just from a browser)

API Key

The API key generated by the OCMLabs Content Bridge for Magento WordPress plugin. This key is sent with every request as the X-OC-Bridge-Key header.

CAUTION /

The key is stored encrypted in Magento’s core_config_data table using Magento’s built-in encryption. If you see a warning in the log about the key being stored unencrypted, re-save the configuration from the admin panel.

To find or regenerate the key: WordPress Admin > Settings > OCMLabs Content Bridge for Magento > API Key. The plugin settings page explains how the key is checked on each request.

Connection Timeout (seconds)

How long Magento waits for a response from WordPress before treating it as an error.

  • Default: 10 seconds
  • The API client retries failed requests on 5xx errors with exponential backoff

Test Connection

Click Test Connection to verify that Magento can reach WordPress and authenticate successfully. The test uses the URL and API key currently in the form, so you can check them before saving. If the API key field still shows the saved (masked) key, the saved key is used.

The test runs in two steps, so it can tell an unreachable URL from a rejected key:

  1. It requests the standard WordPress REST API (/wp-json/wp/v2/categories) at the URL. If there is no response, it reports No WordPress REST API response at that URL. Check the WordPress URL.
  2. It calls the Content Bridge endpoint /wp-json/oc-bridge/v1/options with the API key. If that fails, it reports The API key was rejected, or the Content Bridge plugin is not active.

If both succeed, it reports Connection successful! WordPress API is accessible. An empty field or a URL that does not start with http:// or https:// is reported before any request is made.

If the test fails:

  • Check that WordPress is reachable from the Magento server (not just from your browser)
  • Verify the API key matches what is shown in the WordPress plugin settings
  • Check that the OCMLabs Content Bridge for Magento plugin is active in WordPress
  • For Connection failed, the admin message is kept generic on purpose. The detail is logged to var/log/system.log, and API client errors to var/log/ocmlabs_wordpress.log

Store-View Scope

All connection settings can be configured per website and per store view. This allows you to connect different store views to different WordPress instances - for example, connecting a French store view to a French-language WordPress site.

See also

Related pages

In this module