About this plugin
SeaTempMap is a website: a live sea temperature map of the world’s coasts. com and in its Android and iOS apps.
This plugin is the official WordPress add-on to that map. It brings one piece of it – a live sea temperature card for a beach you choose – onto your own pages, with a block or a shortcode.
Guests want to know one thing before they book a beach holiday: how warm is the water. This plugin puts that number on your site, updated through the day.
The card shows the current sea temperature at the beach you choose, plus air temperature, weather and the UV index. Sea temperatures come from NASA satellite data, sampled at the swimming area rather than out at sea.
Any beach, and 174 of them already in the picker. The block and the shortcode choose from a curated list of 174 beaches and coastal cities, and that list keeps growing – new ones appear in the picker on their own, with no plugin update needed. com with the name and we will look at adding it.
com/embed and paste the code it gives you into a Custom HTML block – it is free too, and the card is identical.
How it looks
The card renders in an isolated shadow root, so your theme’s CSS cannot break it and its styling cannot leak into your page. It reads your page’s background and picks a light or dark card to match, or you can force either one.
Features
- 174 beaches and coastal cities in the picker – and any other coast in the world with the code from seatempmap.com/embed
- Celsius or Fahrenheit
- Light, dark, or automatic to match the visitor’s system
- Speaks 30 languages, following your page’s lang attribute by default
- Full card (sea, air, weather, UV) or a compact sea-only card
- Drop shadow on or off, so the card suits a flat design as well as a layered one
- Block editor block, and a [seatempmap] shortcode for classic themes and page builders
- Updates itself while the page is open. Nothing to maintain
- No account, no API key, no cost for the free card
Widget Pro (optional)
Everything above is free and always will be. com/embed under Settings → Sea Temp Map, which unlocks, per card:
- Your own name on the card instead of the beach’s
- A ten-day sea forecast strip, wide or folded into a grid for a sidebar
- An off-season face: below 18 °C the card becomes a weather card instead of showing water nobody will swim in
- The colour scale hidden, for a plainer card
- Our name and the link off the card entirely
The licence key is a site setting, not a per-post one: enter it once and every block on the site can use it. Without a key the Pro controls stay switched off and every card renders exactly as it does today – free, and carrying the credit link that pays for it.
Shortcode
[seatempmap dest="hvar"]
Attributes: dest (required, the beach id), units ( c or f ), theme ( auto, light, dark ), show ( both or sea ), shadow ( on or off ), lang (a language code, or leave empty to follow your page).
Top line, free: topline ( auto, custom, off ), eyebrow (your text, with topline="custom" ), clock ( on to show the beach’s local time).
With a Widget Pro licence saved in the settings: name (your own card name), forecast ( wide or grid ), design ( interactive or classic, for a forecast card), bar ( off hides the colour scale), offseason ( on ). Without a licence these are ignored and the card stays free rather than breaking.
com/embed.
External services
com, a third-party service, to provide the temperature data and to draw the card.
The plugin itself only outputs a placeholder element. js, which is the service’s own renderer rather than a copy of a general-purpose library hosted on a CDN. It is loaded from the service because it must stay in step with the data format the service returns; bundling a copy would break every site the moment the format changed.
What is sent and when
- On a page containing the widget, the visitor’s browser loads the card script from https://seatempmap.com/widget/v1.js and then requests https://seatempmap.com/api/widget with the beach id, unit and language you configured. As with any request to a third-party server, the visitor’s IP address and user agent are visible to it. No cookies are set, no identifiers are stored, and nothing about the visitor or your site’s content is sent.
- In the admin, your server requests https://seatempmap.com/api/widget/destinations to list the available beaches. This is cached for a day and sends nothing about your site.
- In the block editor, your own browser loads the same card script and requests the same https://seatempmap.com/api/widget endpoint, so the block shows you the real card rather than a mock-up of it. This happens only while you are editing a post that contains the block, and nothing about your site or the post is sent. The same happens on the plugin’s settings screen when you draw a test card there.
- If you have saved a Widget Pro licence key, cards on your site send that key and your site’s domain with the request above, so the service can tell whether this site is licensed. A licence is bound to one domain, which is why both are needed. Sites with no key send neither.
Service provided by Sea Temp Map: terms of service, privacy policy.