About this plugin
SeaTempMap is a website: a live sea temperature map of the world’s coasts. It shows today’s water temperature anywhere in the ocean, a 10-day sea forecast, the UV index and long-term monthly averages – free, in 30 languages, at seatempmap.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. If yours is missing, email [email protected] with the name and we will look at adding it. For a coast that is not on the list, build the same card for any point on Earth at seatempmap.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. Hotels and holiday-rental sites that want the card to be theirs can add a Widget Pro licence from seatempmap.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 ), bar ( off hides the colour scale), offseason ( on ). Without a licence these are ignored and the card stays free rather than breaking. Preview every option and find beach ids at seatempmap.com/embed . External services This plugin relies on seatempmap.com, a third-party service, to provide the temperature data and to draw the card. The plugin itself only outputs a placeholder element. The card is drawn by widget/v1.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 .