Dealer Locator
Product based dealer locator website code implementation
Step 1: Include script within website
The example below demonstrates what's needed to integrate the Buy Now widget with your site. Simply update desired parameters then copy the snippet into your website.
- <script id="omacro-widget-buynow" src="https://buynow.omacro.com/embedded/bn.loader.js?company=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&country=auto&validate=false&debug=false" async></script>
The company parameter is prefilled with your company identifier, no need to change this value. All snippet parameters are appended to the script source and must conform to the standards of uniform resource identifiers .
- company required
- This is your Omacro supplied company identifier. This ID was assigned when your company account was originally created which will never change. The snippet example above already includes your company identifier.
- country
- This is a two digit ISO country code ISO 3166-1 alpha-2 code or auto . If not supplied a map will be presented to allow the user to select their country. When provided and not set to auto the user is immediately presented results for the specified country. When set to auto the country will be automatically determined by the users IP Address.
- validate
- When true the snippet will verify that each product identifier available on the page is valid and returns a product. Once validation is complete the snippet will add the respective CSS class to the trigger element: obn-validate-pass or obn-validate-fail . While validation is pending the trigger element will have the CSS class obn-validate-pending .
- debug
-
When
true
the snippet will assist with debugging by logging all activity and notifications to your browser console. It's recommended to disable this feature once debugging is complete.
-
-
Step 2: Assign product trigger(s) to buttons
The example below demonstrates a simple anchor tag (link) being used as a product trigger. You can easily use existing, or new elements, on your website by simply adding the required product parameter.
- <a href="#obn" data-product="Your Product Identifier">Product Link</a>
Trigger parameters take priority over snippet parameters, this allows for parameters to be set globally with exceptions if needed. All trigger parameters are HTML data attributes which require they start with ' data- '.
- product required
- This is the product identifier. This could be a GTIN (UPC, EAN or ISBN), SKU, model name or Omacro ID. We strongly suggest using a GTIN, ideally UPC.
- country
- This is a two digit ISO country code ISO 3166-1 alpha-2 code or auto . If not supplied a map will be presented to allow the user to select their country. When provided and not set to auto the user is immediately presented results for the specified country. When set to auto the country will be automatically determined by the users IP Address.
- validate
- When true the snippet will verify that that each product identifiers available on the page is valid and returns a product. Once validation is complete the snippet will add the respective CSS class to the trigger element: obn-validate-pass or obn-validate-fail . While validation is pending the trigger element will have the CSS class obn-validate-pending .