SunnyTracker Widgets

Description

Show your visitors when the sun rises and sets – on a campsite, hotel, wedding venue, sailing club, fishing or photography blog. Everything updates itself every day.

Two blocks for the block editor

• SunnyTracker widget – a small card: sunrise & sunset with day length, moon phase with moonrise and moonset, golden hour for photographers, or a countdown to the next solar or lunar eclipse. Light, dark or following the visitor’s mode, three sizes, ten languages, your accent colour. Try them all on sunnytracker.com/widgets.
• Sun & moon times – the day’s times as plain text in your theme’s fonts and colours: sunrise, sunset, solar noon, sun height at noon, civil, nautical and astronomical twilight, blue and golden hour, day length, moonrise, moonset and moon phase. Pick the fields, list or table, today or tomorrow. Search engines read it like the rest of your page.

Both blocks have a city search built in. For a place outside town – a campsite, a beach, a venue – use coordinates instead.

Shortcodes for the classic editor, page builders and text widgets, including a single time inside a sentence: “Sunset tonight: [sunnytracker_time city="hamburg" field="sunset"]”.

Sidebar widget for classic themes under Appearance → Widgets.

Settings → SunnyTracker sets the default city, language and colours for the whole site.

Times are calculated by SunnyTracker with the NOAA solar algorithm (refraction included) and Meeus lunar theory. Polar night and midnight sun are handled. No account and no API key needed.

Shortcodes

Card:

[sunnytracker city="berlin" type="golden-hour" theme="dark" size="large" lang="de" accent="3b82f6"]

• city – the city’s slug as in its SunnyTracker address (sunnytracker.com/new-york → new-york)
• type – sunrise (default), moon, golden-hour, solar-eclipse, lunar-eclipse
• theme – light, dark, auto
• size – compact, default, large
• lang – en, de, fr, es, it, pl, nl, pt, ja, zh
• accent – colour as hex without #

Times as text:

[sunnytracker_times city="berlin" show="sunrise,sunset,day_length,moon_phase" layout="table" date="tomorrow"]

[sunnytracker_times lat="54.18" lon="7.89" tz="Europe/Berlin" name="Heligoland harbour"]

• show – any of astronomical_dawn, nautical_dawn, civil_dawn, blue_hour_morning, golden_hour_morning, sunrise, solar_noon, noon_altitude, sunset, golden_hour_evening, blue_hour_evening, civil_dusk, nautical_dusk, astronomical_dusk, day_length, moonrise, moonset, moon_phase
• layout – list (default) or table
• date – today (default), tomorrow or YYYY-MM-DD
• title – yes (default) or no for the heading with place and date
• lat, lon, tz – coordinates and time zone instead of a city; name – the place name for the heading

A single value:

[sunnytracker_time city="berlin" field="sunset" date="tomorrow"]

All shortcodes and blocks take credit="yes" or credit="no" for the source link; without it the site-wide setting applies.

External services

This plugin relies on SunnyTracker (www.sunnytracker.com), which computes the sun and moon times. Without it the plugin shows nothing.

• Cards (block “SunnyTracker widget”, shortcode [sunnytracker], sidebar card): the visitor’s browser loads the card as an iframe from www.sunnytracker.com each time a page with it is viewed. Like any web request this sends the visitor’s IP address, browser user agent and the address of the page it is embedded in, plus the chosen city and display options. SunnyTracker counts these views anonymously; it sets no cookies and stores nothing on the visitor’s device.
• Text times (block “Sun & moon times”, shortcodes [sunnytracker_times] and [sunnytracker_time]): your web server requests https://www.sunnytracker.com/api/v2/sun with the chosen city or coordinates, time zone and date, at most once per place and day (answers are cached). Nothing about your visitors is sent. The request carries your site’s address in the user agent.
• City search in the block editor: your web server sends the typed search text to https://www.sunnytracker.com/api/v2/cities. Only logged-in editors can use it.

SunnyTracker: privacy policy – legal notice – API documentation