[WordPress] 外掛分享： Live Sea Temperature Widget by SeaTempMap

內容簡介

Live Sea Temperature Widget by SeaTempMap 是一款 WordPress 外掛，提供即時海水溫度資訊，幫助使用者在選擇海灘度假前了解水溫。此外掛可在網站上顯示選定海灘的海水溫度、空氣溫度、天氣和紫外線指數，並隨時更新。

【主要功能】
• 提供即時海水溫度資訊
• 支援 174 個海灘及沿海城市
• 可選擇攝氏或華氏顯示
• 自動適應網站主題的顏色風格
• 支援 30 種語言顯示
• 可自訂顯示完整資訊或簡潔海水卡片

外掛標籤

開發者團隊

原文外掛簡介

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.