How can we help you?



Setup and Configuration

Related articles

Install and customise widget

Install Widget Code

Agents will need to generate widget code and client id and supply the generated client ID to the Developer.

After the developer has received the Client ID from the agent, install the code below with the Client ID on your website by following the steps in this article or using Google Tag Manager.

The widget code needs be inserted as high as possible in website's <head> section, preferably after <head> tag. This can be done either by yourselves if you run your website support in-house, or can be sent to your web development team if you outsource web maintenance. If you use Google Tag Manager to manage tags, refer to this guide for installation.

Tip
Internally, widgets rely on jQuery (JavaScript library). If your website also uses jQuery, place OneDome widget code below other/your jQuery script tags. OneDome widgets will detect existing jQuery and will not load it again.

Widgets can be added to multiple or all pages on your website, but it cannot currently be added to multiple domains. If you want to use the widget on another domain, for example another agency, then you will need to register for it separately.

Customising Widget

Widget accent colours (buttons, selected elements, loader, etc.) can be customised according to your brand. Just enter the suitable hexadecimal colour codes when installing.

<script>
    var OneDomeWidgetConfig = {
        client_id: "11111111-1111-1111-1111-111111111111",
        color: "#ffc300",     // your accent background colour
        textColor: "#212121"  // your accent text colour
    }
    </script>
    <script type="text/javascript" src="https://cdn.onedome.com/widgets/onedome-external.min.js">
</script>

If you do not know the hexadecimal colour of your website, try asking your web designer/developer or using eyedropper browser plugins such as ColorZilla.

Triggering Widgets

Finally, you need to link widgets to the elements on your website so that users can interact with them. Buttons, images, text links and virtually any element on your website can be used as a widget trigger.

We currently provide 4 widgets for estate agencies. Use one of the "onclick" actions listed below to trigger respective widget:

1. Instant Valuation

<button onclick="return oneDomePopup('instantValuation')">
    Instant Valuation
</button>

2. Book Valuation

<button onclick="return oneDomePopup('bookValuation')">
    Book Valuation
</button>

3. Book Viewing

<button onclick="return oneDomePopup('bookViewing')">
    Book Viewing
</button>

4. Make Offer

<button onclick="return oneDomePopup('makeOffer')">
    Make Offer
</button>