When a boater marks a trip as Unlisted or Public and ticks the “Allow embedding” checkbox, the plugin generates a permanent embed URL for that trip. That one URL is the foundation for every embedding method described here.
Getting the Links
Open the Boat Log map, select a trip, expand Trip settings, and set Visibility to Unlisted (anyone with the link) or Public (listed on your profile). Two items appear:
- Direct link — the full-screen URL
- Embed code — a ready-made
<iframe>tag
Both can be copied to the clipboard with the button next to them.
Method 1 — WordPress Block (Gutenberg)
If your blog runs WordPress, the Canal Maps Trip block is the cleanest option. It lives in the block editor alongside all the other blocks and renders the map as a responsive iframe directly in your post, with no HTML editing required.
How to use it:
- In the WordPress post editor, click + to add a new block and search for Canal Maps Trip.
- A dropdown lists every trip that is currently set to Unlisted or Public and has embedding enabled — select yours.
- Optionally adjust the Height (default 500 px) in the block sidebar.
- Publish. The map appears inline in the post.
Under the hood the block is registered as cm-boatlog/embed and rendered server-side, so the iframe URL is always fresh and there is nothing to update when trip details change.
The direct link shown in Trip settings carries a hint: “Use with the Canal Maps Trip block in WordPress.” That’s because the block reads from the same embed slug — you don’t need to copy anything; just pick the trip from the dropdown.
Method 2 — Raw Iframe (Blogger, Squarespace, any HTML editor)
For platforms that don’t support WordPress blocks, the embed code field provides a raw <iframe> tag ready to paste:
<iframe src="https://canalmaps.co.uk/?cbl_embed=1&trip=XXXX"
width="100{18927cf9920c99adb2e25af581d167b4d89018e576169afbe90d3c3eaa12ee45}" height="500" frameborder="0"
allowfullscreen loading="lazy"
title="Your Trip Name"></iframe>
On Blogger:
- Open the post in the Blogger editor.
- Switch to HTML view (the
< >button). - Paste the embed code where you want the map to appear.
- Switch back to Compose view to continue writing.
The map fills its container width and loads lazily, so it doesn’t slow down the rest of the page.
Method 3 — Direct Full-Screen Link
The direct link (canalmaps.co.uk/boat-log/trip/XXXX) opens the trip map as a full-screen, standalone page — no WordPress theme, no sidebar, just the map. It’s ideal for:
- Social media — paste the URL into a Facebook post, tweet, or WhatsApp message. Followers tap it and go straight to the interactive map.
- Passing to friends — anyone with the link can view an Unlisted trip without logging in.
- Embedding in other contexts — if you want to iframe it yourself with custom dimensions, this is the URL to use as the
src.
The page includes Open Graph meta tags (og:title, og:description) so that Facebook, Twitter/X, and iMessage generate a preview card when the link is shared.
Method 4 — oEmbed (Paste-and-Go in WordPress)
This one requires no action from the boater at all, and many WordPress users may use it without realising. WordPress automatically converts recognised URLs into embeds when you paste them into the block editor — the same way a YouTube URL becomes a video player.
Every Canal Maps trip embed page advertises an oEmbed endpoint via a <link> tag in its <head>:
<link rel="alternate" type="application/json+oembed"
href="https://canalmaps.co.uk/wp-json/cbl/v1/oembed?url=...">
The oEmbed response returns an iframe at 800 × 450 px. So on any WordPress site:
- Copy the direct link for a trip.
- Paste it on its own line in the block editor.
- WordPress fetches the oEmbed data and converts it into an embedded map automatically.
This is also how third-party WordPress sites can embed a Canal Maps trip without installing anything.
Visibility and Privacy
| Visibility | Who can see it | Embeddable |
|---|---|---|
| Private | Logged-in owner only | No |
| Unlisted | Anyone with the link | Yes (if enabled) |
| Public | Listed on profile + anyone | Yes (if enabled) |
Embedding must be explicitly enabled in Trip settings. A trip can be Public but still non-embeddable if the boater prefers not to allow iframe use.
Summary
| Method | Best for | Where to find the code |
|---|---|---|
| WordPress block | WordPress posts & pages | Block editor → Canal Maps Trip |
| Raw iframe | Blogger, Squarespace, HTML | Trip settings → Embed code |
| Direct link | Social media, WhatsApp, email | Trip settings → Direct link |
| oEmbed | Paste into any WordPress site | Automatic — just paste the URL |
All four methods point at the same underlying embed page, so the map always reflects the current state of the trip log.
That covers everything the plugin provides for sharing and embedding trips. Let me know if you’d like to add screenshots, adjust the tone, or post it directly to the site.