Here's how to add Buying Buddy to your WebStarts website. These instructions are designed to get you going. Once you get the Buying Buddy JavaScript library installed and these basic pages working please refer to the general help articles for more help and assistance.

Please Note:

1. Website Settings.
You must set your website type as a 'WebStarts' site in Website Settings.
This then ensures that you see the correct install code required for your WebStarts website

2. "Sorry this domain is not authorized"
Your Buying Buddy widgets are authorized to work on your IDX approved domain (and only on this domain).
When you are in WebStarts development area your site may be displayed using a WebStarts subdomain such as
"http://xxxxxxx.webstarts.com"
- and so instead of seeing the widgets you may see nothing displayed NOTE: You will probably not see the widgets being displayed in your WebStarts editor. So save the page and click the VIEW SITE button in the WebStarts editor header bar on the right to see a preview.
You may also see a message that says
"Sorry this domain is not authorized"
Seeing this message means that the widgets and Plugin JavaScript are indeed working correctly!

If you need your development domain to be authorized, please submit a help ticket and request a sandbox development domain and tell us the domain you need authorized.

Step-1: Add Buying Buddy JavaScript Code

In this step, we are going to add the Buying Buddy JavaScript library to your WebStarts site so that it loads on every page.

Step 1a: Get the Buying Buddy JavaScript Library Code

  1. Login to your Buying Buddy dashboard at leadsandcontacts.com.
  2. Navigate to: Websites & Widgets / Setup and Install
    Then click the "Plugin Installation" button to view the installation instructions.
  3. Select the appropriate website. Make sure that your site is set as a WebStarts site. For a WebStarts website you will be shown the JavaScript that is your Buying Buddy Plugin.
  4. COPY the plugin code.

Step 1b: Add to Your Site

Now login to your WebStarts website dashboard where you can edit your site.

In the top menu - click "Insert", then "HTML Code" as shown below:

You will see a warning message; click YES to proceed and you'll be shown the View Source panel (shown below).

Click the tab option to "View Site Head", and PASTE all of the code from your clipboard into this panel.
Click OK to save.

This method ensures that the Buying Buddy JavaScript is loaded on every page in your website. DO NOT MODIFY THE CODE.

Ensure that the Buying Buddy JavaScript is ONLY added once using the method described above.

Step 2: Add pages and widgets

2a: Create your plan for pages and widgets

You need to create 2 special foundation pages:

  • Results Page (with the "Results" widget)
  • Property Details Page (with the "Property Details" widget)

Plus, you will also need to add a Search Form widget on any other different page too.

Step 2b: Add Pages to your WebStarts website

Go back to your WebStarts site editor, and create 2 extra pages for your site.

Create two BLANK PAGES, and we suggest you give them appropriate titles, such as "results" and "details".

These 2 pages should NOT be displayed in the menu - so click the 'cog' icon for the page and check the box for "Hidden on menu".

Step 2c: Insert Buying Buddy Widget Code to Display Widgets

Now go back and EDIT these 2 pages where you need to have Buying Buddy widgets, e.g. the Results page that you created.

Click the page to Edit.
Then, in the left menu - choose "Add" - then scroll down the list to select "Embed Code".
You will see a warning message; click YES to proceed and you'll be shown the View Source panel (shown below).

In this case, click the tab and select "Paste Code". In the code panel, paste the <div> code for the Buying Buddy widget you want to show.

Widgets are available from this page in your Buying Buddy account. https://www.leadsandcontacts.com/widget-settings/widgets
If you have multiple domains make sure that you select the correct domain.

For example - in the image below this is the Results widget.

Once you have SAVED your pages, you can view this page and if all steps are successful you should the Buying Buddy results widget being displayed on the live authorized domain.

NOTE: You will probably not see the widgets being displayed in your WebStarts editor. So save the page and click the VIEW SITE button in the WebStarts editor header bar on the right to see a preview.

NOW REPEAT for the details page.
** Do not forget to do this! **
(Note: The details widget may display a SQL error if you preview it - ignore this.)

Finally, get the Buying Buddy widget code for the Search form and add to any other completely different page in your site.

Step 2d: Configure your Buying Buddy account so that page names match

It's important that the Buying Buddy system knows how to direct your leads (via emails etc.) back to these 2 pages to see search results and details of a specific property. So, its important to ensure these page names are set correctly in your Buying Buddy account.

Login to your Buying Buddy account at http://leadsandcontacts.com

Navigate to: Widgets > Website & Settings
Then click the "Website Settings" link for your website. and then scroll down to review the page addresses of the Widget Foundation pages

You will see that they are probably shown as just results and details - in which case you need to change these to say the actual names of the pages you created, and in the browser when viewing these pages you will see the full address like this:
(Note: With WebStarts, the page names use ".html")

NOTE: Use the actual page names for YOUR site - don't assume that they are the same as shown in this example!
See step-3 in this this article on Foundation Pages

Troubleshooting

"SQL Error" on Details Page

If you see this message then this is because you are attempting to view the Property Details widget on a page on its own without a reference to a property! Ignore this, the widget is installed correctly and this error is never seen.

"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. It is probably a subdomain that WebStarts has applied while you are in the editor of your website, e.g. "https://[some-subdomain].webstarts.com"

There are two options for dealing with this:

  1. 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.
  2. If you need to do more extensive development then you can request (via Help Desk) to add your WebStarts development subdomain as an extra (free) "authorized" domain on your account.
    We call this a 'sandbox' development URL and it would be authorized temporarily while you do development.

Step 3: Doing More

Your WebStarts site editor will allow you to create custom search forms and use all the capabilities of the Buying Buddy widgets.

You can now use Widget Themes to style widgets - or even add custom CSS too if you wish to.

If you need more help please contact us.

Admin