Skip to main content

Troubleshooting IMPress for IDX Broker API and Cron Issues in WordPress

Overview

This guide walks through common troubleshooting steps for diagnosing:

  • IDX page creation issues
  • Failed API calls
  • Plugin communication problems
  • Scheduled cron task failures

using:

  • WP Crontrol
  • Query Monitor

These tools can help identify issues related to:

  • Cron jobs
  • HTTPS/SSL failures
  • Blocked outbound requests
  • Server configuration problems

Step 1: Install WP Crontrol

Install and activate:

  • WP Crontrol

Check IDX Cron Events

  1. Navigate to:
    • Tools → Cron Events
  2. Look for the IDX page creation cron event:
    • Commonly: idx_create_idx_pages
  3. Click:
    • Run Now

Review Results

After running the cron event:

  • Look for any errors or warnings displayed at the top of the page
  • If no issues appear, continue to the next troubleshooting step

Step 2: Install Query Monitor

Install and activate:

  • Query Monitor

Open Query Monitor

  1. In the WordPress admin bar, hover over the Query Monitor statistics near the IMPress menu
  2. This will open the Query Monitor console at the bottom of the page
  3. Select:
    • HTTP API Calls

This section displays all outbound API requests made by WordPress and plugins.

Step 3: Refresh IMPress Plugin Options

  1. Navigate to:
    • IMPress → Initial Settings
  2. Click:
    • Refresh Plugin Options

This forces the plugin to:

  • Re-run API requests
  • Reload IDX configuration data
  • Validate API communication

Step 4: Review HTTP API Calls

After refreshing plugin options:

  • Return to the Query Monitor HTTP API Calls tab
  • Review any failed requests or warnings

Common errors may indicate:

  • HTTPS communication failures
  • SSL verification problems
  • Blocked outbound requests
  • Timeout issues

Common Causes of API Failures

Potential server-related causes include:

  • Expired or invalid SSL certificates
  • Outdated cURL/OpenSSL versions
  • Firewall or hosting restrictions
  • Cloudflare or CDN blocking requests
  • Disabled loopback requests
  • REST API restrictions
  • Security plugins interfering with outbound requests
  • Password-protected staging environments

Example Scenario

If Query Monitor displays HTTPS request failures, the issue typically means:

The server is unable to successfully complete outbound HTTPS API requests.

This is often caused by:

  • SSL certificate configuration problems
  • Server-level networking restrictions
  • Improper cURL/OpenSSL support

Troubleshooting Tips

Cron event missing

  • Disable conflicting plugins temporarily
  • Verify WordPress cron is enabled
  • Check hosting restrictions on WP-Cron

HTTP API requests failing

  • Verify the site has a valid SSL certificate
  • Test outbound HTTPS connectivity from the server
  • Contact hosting provider if requests are blocked

IDX pages not generating

  • Run the cron event manually
  • Refresh plugin options
  • Confirm API credentials are valid

No HTTP API calls appearing

  • Confirm Query Monitor is installed and active
  • Refresh the page after triggering plugin actions

Best Practices

  • Keep WordPress, IMPress, and PHP updated
  • Use a properly configured SSL certificate
  • Avoid overly restrictive security/firewall plugins
  • Test API functionality after hosting or CDN changes

Additional Notes

  • Shared hosting environments commonly cause API communication issues
  • Staging sites may fail if password protection blocks outbound requests
  • This workflow is particularly useful for diagnosing intermittent IDX sync issues

🤖 Zendesk AI / Answer Bot Intents

Intent: IDX pages not generating

User might ask:

  • “Why aren’t my IDX pages being created?”
  • “How do I test IDX cron jobs?”

Answer:
Install WP Crontrol and manually run the idx_create_idx_pages cron event to verify IDX page generation is functioning correctly.

Intent: IMPress API errors

User might ask:

  • “Why is IMPress failing API calls?”

Answer:
Use Query Monitor to inspect HTTP API requests. Common causes include SSL issues, blocked outbound requests, or server configuration problems.

Intent: HTTPS API failure

User might ask:

  • “Why are HTTPS API requests failing?”

Answer:
This usually indicates a server SSL, cURL, firewall, or outbound networking issue preventing WordPress from communicating with IDX Broker APIs.

Intent: Refresh plugin options

User might ask:

  • “What does Refresh Plugin Options do?”

Answer:
It forces IMPress to reload IDX configuration data and re-run API requests, which helps diagnose communication or synchronization issues.

 
 
Powered by Zendesk