Before you roll up your sleeves and start installing, review the following checklist to make sure you are ready to go!
Buying Buddy DOES NOT WORK IN AN IFRAME.
Do not place Buying Buddy widgets in an Iframe or in a fixed height container.
What You Need to Get Started
To get Buying Buddy working on your website, you will need the following:
This is an overview only. See the detailed instructions for your type of website.
- The "Welcome Email" sent to you with login access to your Buying Buddy dashboard
- Get the Plugin
- For WordPress - install the Buying Buddy WordPress plugin from the WordPress plugin directory
- For Wix: Add the Buying Buddy App from the Wix Apps Marketplace
- For all other websites - add the plugin JavaScript library
- Wix and WordPress
Installing the Buying Buddy Plugin / App will set up all the required pages with widgets for you.
For All Other Sites
You will need to add two normal pages to your website that will be used by the Buying Buddy system. These will show search results and property details and should not be shown in your website menu.
We call these "Foundation Pages".
The URL addresses of these two pages must be added to your Plugin Installation and Settings in your Buying Buddy dashboard. - Installation must be on an "Authorized Domain" which is setup in your Buying Buddy dashboard. This is the domain that your MLS has approved for IDX display. If you see a "Sorry this domain is not authorized" message, then you are attempting to display widgets on an unauthorized domain. See notes below.
"Sorry this domain is not authorized"
If you see a message that says "Sorry this domain is not authorized", then this means that the Widgets and Plugin JavaScript are indeed working correctly, BUT that your page address is a domain that is not authorized to display Buying Buddy Widgets. This can occur because you are using a development or sandbox domain, or your website system (Squarespace etc) is showing you a preview using a development subdomain etc.
There are two options for dealing with this:
- Make sure your actual domain name is applied and working - and then view the "live" site in which case widgets will be displayed correctly. You can then choose to ignore this message while in development.
- If you need to do more extensive development then you can request (via Help Desk) to add your development subdomain as an extra (free) "authorized" domain on your account.
We call this a 'staging' / development URL and it would be authorized temporarily while you do development.
How To Block "You Must Register" Messages while Installing
When you are installing the Buying Buddy widgets and trying to get them all working, there is nothing more annoying than seeing "Please Register!" messages all the time!
These messages are showing because of the "Lead Capture Settings" set up in your Buying Buddy account.
There are 2 methods for dealing with this:
- Adjust your Lead Capture Settings to allow "unlimited searches" and "unlimited property views" etc. See this article for details.
Of course, this will then need to be reset when you go live. - To temporarily prevent the system from requiring you to register / login, you can specify a URL parameter to turn lead capture off as you browse and test your website.
?bfg_user=truewill turn OFF forced signup for your current session.
For example:
http://www.mysite.com/?bfg_user=true
Do Not Defer Loading of the Buying Buddy Plugin
Do not defer loading or "lazy load" the Buying Buddy plugin.
Beware of using third party 'optimizing tools' that will promise speed gains by optimizing your site (these are extremely common in WordPress).
If you use such add-ons or plugins, always make sure that the Buying Buddy is NEVER deferred and always excluded from manipulation by such systems.
Beware of Caching and Cache systems
There are many ways to implement page caching - from CDN systems like Cloudflare and other 3rd party systems, to various website plugins. These are all designed to store a version of your page so that load time is reduced when requested.
Although Cache systems will not affect the results of an actual "search" being made, Cache systems will interfere with the accuracy of results shown on the various "Display" widgets, for example if you have a page to show your features listings, or a landing page for a city etc.
Any type of Cache can have a serious effect on the way Buying Buddy functions and includes at least these types of issues:
- Photos not updating for your listings
- Open House times and dates not accurate
- Prices inaccurate
- Property status inaccurate (e.g. it sold but still shows active)
- Disclaimer text shows incorrect update dates and times
- Search engines will not see the latest listings and will therefore impact the indexing of listing pages for SEO (WordPress / PHP)
We recommend the following types of action:
- configure your caching system to not cache pages with Buying Buddy display widgets.
- adjust settings for your cache to reduce the time of caching to a few hours rather than days.
If you do see broken layouts, fonts or icons that are the wrong sizes or anything weird and strange like this, then please report this to us so that we can take a look and get such issues fixed.
We want Buying Buddy to look AWESOME on your website!
Page Layout Considerations
For BEST results we recommend that you have a website that is fully Mobile Responsive.
Although widgets are fully mobile responsive, we suggest that you may want to create containing <div> sections for the widgets in your site. If the widget has a general height and width, then make sure this is accommodated and defined in the containing <div>.
If you have a WordPress site then review the various page templates available and choose page layouts that are appropriate for the Buying Buddy widget being displayed. For example, a wide page layout is best when showing search results.
Buying Buddy Widgets in Tabs
If you have a tabbed section on a page and you are placing Buying Buddy widgets in the tabs, then you will need to use some extra JavaScript to force the Widget to reload when the tab is clicked. See Displaying Widgets in Tabs for details on how to do this.
Special Notes for For WordPress
If you use WordPress builder plugins, always paste in Buying Buddy widgets into a text block.
Using Widgets
In WordPress, widgets are shortcodes.
Always use the specified WordPress shortcodes for a widget if it is available as this will ensure the full SEO capabilities of Buying Buddy are incorporated when pages load.
Avoid Conflicts with other Builders and Plugins:
Read WordPress Builders and Plugins Compatibility and Notes
WARNING!
If your website has JavaScript errors then the Buying Buddy plugin may not work!
Click here to see Installation Troubleshooting help.
See WordPress troubleshooting topics.
Get Started with Installation and Setup
Now see the detailed instructions for your type of website.