udforske.com

Boligvælger iFrame

WordPress plugin that embeds the Boligvælger — the interactive housing selector — on your site via an iFrame, with URL synchronisation, deep links and automatic height.

Latest version
Download plugin (.zip)

Installation

  1. Download the zip above.
  2. In WP admin, go to Plugins → Add New → Upload Plugin, choose the zip and install + activate.
  3. Configure the Boligvælger URL under Settings → Boligvælger iFrame — the settings page includes the full integration guide.
  4. Put the shortcode [boligvaelger] on a page.

Updates

Installed once, the plugin updates itself: new versions appear in WP admin under Dashboard → Updates, exactly like plugins from wordpress.org. Requires WordPress 5.8 or newer.

Test page for developers

bv-test.html is a standalone page that implements the Boligvælger's half of the postMessage protocol. Embed it with the plugin to see exactly how the integration behaves — before pointing at a real Boligvælger. It is hosted right here, so this shortcode works on any site with the plugin installed:

[boligvaelger url="https://wp-plugin.udforske.com" path="/bv-test.html"]

The page logs every bv:* message in both directions with timestamps and origins, loudly flags origin mismatches, auto-detects the WordPress origin from the referrer, and has buttons to simulate bv:navigate (with a ?data= payload), bv:goto and bv:ready. Embedded, it exercises the full cold-start handshake, URL synchronisation and auto-height; add a second embed with sync="off" to try multi-embed pages.

Protocol documentation lives in the plugin repository (docs/protocol.md) and on the plugin's settings page in WP admin.