Connection Setup

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 > Orange Collar > 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 OC Magento Bridge WordPress plugin. This key is sent with every request as the X-OC-Bridge-Key header.

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 > OC Magento Bridge > API Key.

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

After saving the URL and API key, click Test Connection to verify that Magento can reach WordPress and authenticate successfully. The test calls the /wp-json/oc-bridge/v1/options endpoint and checks for a valid response.

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 oc-magento-bridge plugin is active in WordPress

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.