WordPress Troubleshooting

Solutions to common problems with the Synoveo WordPress plugin.

Connection Issues

"Connection Failed" Error

Symptoms: Red "Disconnected" status, unable to sync

Solutions:

1. Verify your Client ID and Secret are correct
2. Check your domain matches the API key domain
3. Ensure your server can reach api.synoveo.com
4. Check for firewall blocking outbound HTTPS

// Test API connectivity
add_action('init', function() {
  $response = wp_remote_get('https://api.synoveo.com/health');
  var_dump(wp_remote_retrieve_response_code($response));
});

"Invalid Credentials" Error

Symptoms: Credentials rejected on save

Solutions:

1. Regenerate credentials in Synoveo dashboard
2. Copy/paste carefully (no extra spaces)
3. Ensure the API key hasn't been revoked

"Domain Mismatch" Error

Symptoms: Connection rejected due to domain

Solutions:

1. Check the domain in your API key settings
2. Must match your WordPress site URL exactly
3. Include or exclude www. consistently

Sync Issues

"Sync Failed" Error

Symptoms: Sync starts but fails to complete

Solutions:

1. Check your plan has the required fields
2. Verify location is verified in Google
3. Check sync is enabled for the location
4. Review error details in Synoveo → Logs

"No Data to Sync" Error

Symptoms: Sync completes but nothing changed

Solutions:

1. Check data sources are enabled
2. Verify plugin integrations are detected
3. Ensure content exists to sync (products, posts, etc.)

"Rate Limited" Error

Symptoms: Too many sync attempts blocked

Solutions:

1. Wait for rate limit to reset (usually 1 hour)
2. Reduce sync frequency
3. Consider upgrading your plan

Auto-Post Issues

"Posts Not Publishing to Google"

Solutions:

1. Verify you have Pro plan or higher
2. Check auto-post is enabled
3. Ensure the post type is selected for auto-post
4. Check post has a featured image
5. Review Synoveo → Post History for errors

"Image Not Included in Post"

Solutions:

1. Set a featured image on the WordPress post
2. Image must be JPEG or PNG
3. Minimum size: 400x300 pixels
4. Check image URL is publicly accessible

Reviews Issues

"Reviews Not Displaying"

Solutions:

1. Check shortcode syntax: [synoveo_reviews]
2. Verify API credentials are connected
3. Ensure location has reviews in Google
4. Clear WordPress cache

"Stale Reviews"

Solutions:

1. Reviews cache for 12 hours
2. Clear page cache to see updates
3. Wait for cache refresh

Plugin Conflicts

Common Conflicts

Debug Mode

Enable debug mode to troubleshoot:

// In wp-config.php
define('SYNOVEO_DEBUG', true);
define('WP_DEBUG_LOG', true);

Check /wp-content/debug.log for detailed errors.

Server Requirements

PHP Extensions

Required extensions:

• curl
• json
• mbstring

Check with:

<?php phpinfo(); ?>

Memory Limit

Minimum 128MB recommended:

// In wp-config.php
define('WP_MEMORY_LIMIT', '256M');

Getting Help

If you're still stuck:

1. Enable debug mode and collect logs
2. Note your WordPress, PHP, and plugin versions
3. Contact support at support@synoveo.com