WordPress Compatibility and Technical Notes

Contents

The following WordPress environments are incompatible with the Buying Buddy plugin.

Also review Solving Plugin Installation Issues and Troubleshooting Installation FAQs

(NOTE: Additional comments and notes for specific WordPress Themes and Builders are documented in the Installation Instructions for WordPress).

If you do believe you have discovered a conflict then we will be keen to understand the issue and investigate so that we can eliminate problems. Tools such as WP_DEBUG (https://wordpress.org/support/article/debugging-in-wordpress/) will generate messages and notices that can help with debugging and we would like to see these with your report of problems.

WordPress Themes / Builders

DIVI Theme

The latest versions of the DIVI theme loads Google Maps API. You STILL require a Google Maps API key - but this should be applied to your DIVI theme as follows:

March 30 2024.
These instructions have been updated

In summary, you should add the Google Map Key to the "Divi Options" and also to "Buying Buddy settings". Use the Divi Option to stop Divi loading the API script, which will be loaded by Buying Buddy instead. You'll see warning messages on the Divi modules - but these can be ignored.

Make sure that the Buying Buddy plugin loads the Google Maps API.
In the WordPress Plugins menu:
Open the Buying Buddy plugin. Then on the Dashboard page - go to Settings.
- Required Settings
  Make sure you have added your Google Map API key.
- Optional Settings
  Make sure that "Buying Buddy loads Google Map Library = YES"
  
  Click "Update Options".
Divi Theme Options
In the WordPress DIVI menu - go to "Theme Options"
- Add your Google Map API key to the "Google API Key" field as shown below
- Set "Enqueue Google Maps Script" to DISABLE
  Click "Save Changes"
  You may need to clear any cache.
Ignore Warnings on Divi Map Module
Now, when editing a Divi Map Module a warning message is shown that DIVI is not loading the Maps API Script.
- This warning can be ignored because the script will is loaded by the Buying Buddy plugin instead.

Real Spaces Theme

The Real Spaces theme loads Google Maps API. You STILL require a Google Maps API key - but this should be applied to your Real Spaces theme as follows:

March 30 2024
These instructions have been updated

Make sure that the Buying Buddy plugin loads the Google Maps API.
In the WordPress Plugins menu:
Open the Buying Buddy plugin. Then on the Dashboard page - go to Settings.
- Required Settings
  Make sure you have added your Google Map API key.
- Optional Settings
  Make sure that "Buying Buddy loads Google Map Library = YES"
  
  Click "Update Options"
Add your Google Maps API Key to the Real Spaces settings
Open the WordPress Real Spaces menu - then click the menu option for Map API Key.
- On the panel shown, add your Google Map API key and "Save Changes".
- MAKE SURE that Real Spaces is not loading the Google Maps API script.
  
  You may need to clear any cache.

Hosting Services

WP ENGINE

Please note that WP Engine has a built-in caching system and you MUST request exclusion of your designated 'results' page (or any page where you use the Results Widget) from the WP Engine Cache.
To do this, LOGIN to your WP Engine Portal. Then contact WP Engine support (e.g. using the chat button) to request these pages are excluded from the Cache.
Once they confirm this is done, in the WP Engine Portal - for your site, go to the "Caching" section, and "Clear All Caches".

GoDaddy Managed WordPress Hosting

Buying Buddy 'out of the box' can have issues with GoDaddy's Managed WordPress Hosting.
GoDaddy say: "The caching system that is built into Managed WordPress hosting prevents the Buying Buddy plugin from loading as required."

The issue is expressed in the Browser Console (F12) - see the 'Console' tab for JavaScript errors. You will see error message such as "MBB is not defined"

TO FIX THIS

The solution is to move your site to a different hosting provider, or use a GoDaddy CPANEL hosting plan, which doesn’t have caching built in.

WordPress Plugins

WP Rocket

You must exclude the Buying Buddy script from the "Load JavaScript Deferred" as follows:
- Go to WP Rocket settings
- Add the this into the field for "Excluded JavaScript Files" and save
https://d2w6u17ngtanmy.cloudfront.net/scripts/my-buying-buddy.5.0.js.gz

See the WP Rocket support article for full details.