Troubleshoot common WordPress Integration issues

Blog Shows 404

Check 1: Is the module enabled?

$ bin/magento module:status | grep OrangeCollar
# Expected: OrangeCollar_WordPressIntegration - Module is enabled

If disabled, run:

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

Check 2: Is the module configured?

Go to Stores > Configuration > Orange Collar > WordPress Integration and verify:

• WordPress URL is set and reachable
• API Key is set

Check 3: Flush the cache

$ bin/magento cache:flush

WordPress API Returns 401 Unauthorized

The API key does not match. Verify:

1. The key in Magento admin (Stores > Configuration > Orange Collar > WordPress Integration > Connection > API Key) matches the key shown in WordPress Admin > Settings > OC Magento Bridge
2. The OC Magento Bridge plugin is active in WordPress
3. The API key was not regenerated in WordPress after being saved in Magento

WordPress API Is Unreachable from Magento Server

The “Test Connection” button in Magento admin shows an error, or the blog shows blank content.

• Verify the WordPress URL in Magento config is the server-accessible URL, not a local dev URL
• Check firewall rules between the Magento server and the WordPress server
• Check that the WordPress server is not blocking requests from the Magento server’s IP
• Increase the connection timeout if the WordPress server is slow to respond

Blog Content Shows Blank or Partial

Content processor issue

Check that ContentProcessor is not stripping valid content. Enable Magento debug logging and check var/log/orangecollar_wordpress.log.

Cache issue

Flush the cache and reload. If the content appears after a flush but disappears again, there may be a cache tag issue.

Webhook Purge Fails (403 Forbidden)

• Verify the webhook URL in WordPress settings matches your Magento store URL exactly (including HTTPS)
• Verify the API key in WordPress settings matches the API key in Magento configuration
• Check that the Magento webhook endpoint is not blocked by a WAF or CDN rule
• Ensure Enable Webhook Cache Purge is set to Yes in Magento config

Permission Errors in Docker

$ docker compose exec -T php chown -R www-data:www-data /var/www/html/var /var/www/html/generated

Port Conflicts in Docker

Change MAGENTO_PORT or WORDPRESS_PORT in magento2-wordpress-docker/.env.

Checking Logs

• Magento system log: var/log/system.log
• WordPress integration log: var/log/orangecollar_wordpress.log
• PHP error log: depends on your server configuration