SunnyTracker Widgets

外掛說明

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.

Made for photographers

The Photo light card shows the day’s blue and golden hours on a 24-hour bar, what is on now or next with a live countdown, and where the sun rises and sets – in degrees and as a compass point. The large size adds the moon phase with moonrise and moonset. For photo spot guides, workshops and photo tours, and for landscape, wedding or astro photography blogs.

As text in your theme’s style, [sunnytracker_times city="reykjavik" show="photo"] lists the blue and golden hours, sunrise and sunset with their direction, and the moon phase. In the “Sun & moon times” block it is one click: “Photography preset”.

Two blocks for the block editor

• SunnyTracker widget – a small card: sunrise & sunset with day length, moon phase with moonrise and moonset, golden hour, photo light, 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 and sunset with their direction, 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.

In your language: cards, text times, blocks and settings come in ten languages – English, German, French, Spanish, Italian, Polish, Dutch, Portuguese, Japanese and Chinese – and follow your site language, regional variants included. Improve the translations on translate.wordpress.org.

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, photo, 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, sunrise_direction, solar_noon, noon_altitude, sunset, sunset_direction, golden_hour_evening, blue_hour_evening, civil_dusk, nautical_dusk, astronomical_dusk, day_length, moonrise, moonset, moon_phase – or photo for the photographer’s selection
• 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
• lang – en, de, fr, es, it, pl, nl, pt, ja, zh: the language of the labels, the city name and the source link; without it the site language

A single value:

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

• field – one of the show fields above; city, lat, lon, tz, date and lang as for [sunnytracker_times]

All shortcodes and blocks take credit="yes" or credit="no" for the source link; without it the site-wide setting applies. In [sunnytracker_time] the time itself becomes the link, so the sentence around it stays as written.

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