WordPress Troubleshooting

Solutions to common issues when using Intufind with WordPress.

Connection Issues

API key not working

Symptoms: "Invalid API Key" error, can't connect

Solutions:

1. Copy key correctly — Ensure no extra spaces before/after the key
2. Check key format — Should start with if_sk_
3. Verify subscription — Check status at intufind.com/dashboard
4. Generate new key — If lost or compromised, create a new one

# Test API connectivity from your server
curl -I https://api.intufind.com/health

"Could not connect to server"

Symptoms: Connection timeout, API unreachable

Solutions:

1. Check outbound HTTPS — Your server must allow outbound connections on port 443
2. Firewall rules — Whitelist api.intufind.com and cdn.intufind.com
3. Test connectivity:

curl https://api.intufind.com/health

4. Check Intufind status — Visit status.intufind.com

Connection drops intermittently

Solutions:

1. Check server resource limits (memory, connections)
2. Review error logs for timeout messages
3. Increase PHP max_execution_time if syncs are timing out
4. Contact your host about connection stability

Chat Widget Issues

Widget not appearing

Check these in order:

1. Widget enabled? — Go to Intufind → Chat and verify toggle is on
2. Connected? — Check Intufind → Status for API connection
3. Clear caches — Clear all caching plugins, CDN, and browser cache
4. JavaScript errors? — Open browser console (F12 → Console tab) and look for errors
5. Ad blocker? — Some ad blockers block chat widgets

Debug steps:

// Open browser console and check if Intufind loaded
console.log(window.Intufind);

If undefined, the script isn't loading. Check for blocking by security plugins.

Widget appears but doesn't respond

1. Check Status page for API connection
2. Verify content is synced in Knowledge
3. Test in incognito mode (rules out browser extensions)
4. Check browser console for API errors

Widget styling issues

Chat appearance is configured in your Intufind Dashboard, not WordPress. Log in and adjust settings there.

Search Issues

Search returns no results

Check:

1. Content synced? — Go to Intufind → Status and verify content is indexed
2. Correct content types? — Check Knowledge page for enabled post types
3. Search enabled? — Verify in Intufind → Search
4. Content published? — Drafts and private posts aren't indexed

Test: Try a simple search for a known product/post title.

Search returns wrong results

1. Re-sync content — Go to Knowledge and trigger a manual sync
2. Improve descriptions — Better product/post descriptions = better results
3. Check exclusions — Ensure relevant items aren't excluded

Old WordPress search still working

Your theme or a plugin may be bypassing Intufind:

1. Clear all caches
2. Check for other search plugins (SearchWP, Relevanssi, etc.)
3. Verify your theme doesn't have custom search handling

Search is slow

1. Increase cache duration — Longer cache = faster repeat searches
2. Check API latency — Run speed test from Status page
3. Reduce results limit — Fewer results = faster response

Sync Issues

Content not syncing

Check:

1. Content is published (not draft/private/pending)
2. Post type is enabled in Knowledge
3. Item isn't excluded individually
4. Auto-sync is enabled

Force sync:

1. Go to Intufind → Knowledge
2. Click Sync Now for the specific content type
3. Monitor progress on Status page

Sync stuck or taking too long

For large sites (10,000+ items):

1. Sync runs in batches — this is normal
2. Don't navigate away during manual syncs
3. Check server resources:

// Add to wp-config.php for long syncs
ini_set('max_execution_time', 300);
ini_set('memory_limit', '512M');

Changes not reflecting

After editing content:

1. Wait 1-2 minutes — Auto-sync has a small delay
2. Manual sync — Edit the post → check sidebar for sync status
3. Clear search cache — Results are cached per your settings

Custom post type not appearing

1. Post type must be registered as public => true
2. Must be registered on init hook with priority ≤ 10
3. Check the post type appears in Knowledge settings

WooCommerce Issues

Products not syncing

1. Verify WooCommerce is active
2. Check Products is enabled in Knowledge
3. Products must be published with valid prices
4. Trigger manual product sync

Order lookups not working

Requirements:

1. Customer must be logged in
2. Customer must have orders on their account
3. Order support must be registered (check Status page)

Debug:

1. Go to Intufind → Status
2. Check Order Support shows "Registered"
3. If not, click Retry Registration

Recommendations not showing

1. Check Intufind → Recommendations is enabled
2. Verify products are synced
3. Need minimum ~20 products for good recommendations
4. Clear page caching

Order Support Issues

Order lookups not working

1. Customer must be logged in — Order lookups require authentication
2. WooCommerce must be active — Order support only works with WooCommerce
3. Check Status page — Go to Intufind → Status and verify "Registered" status
4. Click Retry Registration — If status shows "Not Registered"

"Not Registered" status

1. Verify WooCommerce is active
2. Click Retry Registration on the Status page
3. Check for error messages

Security plugins blocking order lookups

Some security plugins may interfere:

• Wordfence — Whitelist Intufind in firewall settings
• iThemes Security — Check API restriction settings
• All In One WP Security — Review firewall rules

Customer seeing "please log in" errors

1. Clear browser cookies and refresh
2. Have customer log out and back in
3. Verify the customer's account is active

Plugin Conflicts

Known compatibility issues

Testing for conflicts

1. Deactivate all plugins except Intufind (and WooCommerce if needed)
2. Switch to a default theme (Twenty Twenty-Four)
3. Test if issue persists
4. Reactivate plugins one-by-one to identify the conflict

Security plugin whitelisting

Add these to your security plugin's whitelist:

• api.intufind.com
• cdn.intufind.com

Performance Issues

High server load during sync

1. Schedule syncs off-peak — Set sync hour to 2-4 AM in Knowledge
2. Batch size — Syncs automatically batch; don't start multiple syncs
3. Server resources — Ensure adequate PHP memory (256MB+)

Slow admin pages

1. Ensure caching is working
2. Check server resources (memory, CPU)
3. Review server error logs

Data Management

Changing your API key

If you need to rotate or change your API key:

1. Go to Intufind → Settings
2. Click the Change button next to your masked key
3. Enter the new API key
4. Click Save

This preserves all your indexed content and settings.

Starting fresh

If you want to completely reset and start over:

1. Go to Intufind → Settings
2. Click Disconnect
3. Confirm the action

After disconnecting, you can reconnect with the same or a different API key to start fresh.

What disconnect deletes

Debug Mode

For advanced troubleshooting, enable WordPress debug logging:

// Add to wp-config.php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Then check /wp-content/debug.log for Intufind-related errors.

Getting Help

If issues persist after trying these solutions:

1. Check system status — status.intufind.com
2. Export logs — Go to Status page and export diagnostic info
3. Contact support — Contact us with:
   • WordPress version
   • PHP version
   • WooCommerce version (if applicable)
   • Theme name
   • List of active plugins
   • Error messages and screenshots
   • Debug log excerpts

We typically respond within 24 hours on business days.