SDAweb Calendar Sync for Google Calendar

Hover popover on event chips (Month, Week, Mini) — a floating card with date, time, location, calendar, recurrence summary, and a click-through link, so visitors get the full event detail without leaving the page. Desktop hover + keyboard focus only; touch users keep direct click-through.

Mobile auto-degrade Month → Mini — below ~600px the full grid is replaced by the compact Mini-month view, so phone visitors get a clean, tappable calendar with no extra work from you. One wrapper, two layouts, no JS swap.

ICS subscribe dropdown — one tap to add your events to a visitor’s own calendar: Google Calendar (web), Apple Calendar / Outlook (webcal), Android Google Calendar app (intent), and Copy-link with toast confirmation. Mobile becomes a bottom sheet.

Live search + jump-to-date picker — optional chrome controls so visitors can filter or navigate quickly.

Multi-day event ribbons — week-spanning bars with arrow indicators when an event continues beyond the visible row.

Recurring event indicator — small ↻ icon with a plain-language cadence summary in the tooltip (“Repeats weekly until 31 December 2026”).

Per-display locale override — render a calendar in a specific language (e.g. nb_NO) even when the site language differs, so you can run a localized calendar on a site that’s in another language.

Two authentication paths

API key — for calendars marked “Make available to public” in Google Calendar. One field, paste, done.

Service Account JSON — for private calendars without per-user OAuth. Upload the JSON, share the calendar with the service-account email, you’re set.

Credentials are encrypted at rest using a key derived from your site’s authentication salt. They are never echoed back into the admin UI — only the masked value and (for service accounts) the public service-account email are shown.

Theme-aware out of the box The plugin reads your active theme’s theme.json color palette and uses your primary, accent, foreground, and background colors automatically. Per-display overrides let you set custom primary, accent, today-highlight, and link colors and force light/dark mode without touching code. Every design token is exposed as a CSS custom property so a developer can fully restyle the calendar from their theme stylesheet.

Five built-in theme presets One-click coordinated colour bundles: Default (clean blue), Warm earth (cream + deep red), High contrast (solid black on white for AAA-stricter sites), Forest (deep green), Sunset (warm coral + amber).

Accessibility built in WCAG 2.2 AA baseline with several AAA touches:

Live contrast warnings on every colour picker — the admin UI shows the WCAG ratio against both light and dark surfaces with pass/fail markers as you choose colours

Automatic high-contrast overlay via prefers-contrast: more

Focus-visible halo: a 4px white ring behind the primary outline so focus stays visible against any chip background

prefers-reduced-motion honored everywhere

ARIA roles and labels on the month grid, navigation, popovers, and view-toggle

Semantic HTML throughout

RTL-aware via CSS logical properties

Tabular numerals for day numbers and time labels so single- and double-digit values don’t drift

Built for the WordPress.org standard

Block editor first-class — server-side rendered, ServerSideRender preview, all the standard InspectorControls

Shortcode and classic widget on the same render pipeline

No bundled core libraries (no jQuery on front-end, no Guzzle, no Carbon, no Monolog)

No third-party authentication relay — your credentials only ever talk directly to googleapis.com

Translation ready via translate.wordpress.org once the plugin is published and indexed (no bundled .po/.mo — WordPress auto-loads locale files into wp-content/languages/plugins/ per the WP Plugin Handbook), plurals via _n(), JS strings via wp_localize_script

Free and GPLv2

For developers Extension hooks are documented in docs/hooks.md inside the plugin folder. The first-release set includes filters for event data, event URLs, query args, cache TTL, render output, palette resolution, plus actions for refresh and uninstall lifecycle.

Third-Party Services This plugin connects to the Google Calendar API to retrieve events from calendars you configure.

Service: Google Calendar API v3

Website: https://developers.google.com/calendar

Terms of Service: https://developers.google.com/terms

Privacy Policy: https://policies.google.com/privacy

Data sent: the calendar ID(s) you configure, plus either your API key or a JSON Web Token signed with your service account credentials. Event data is returned to your server and cached locally as WordPress transients. No event data is sent to any third party.

The ICS subscribe feature, when enabled, serves a self-hosted iCalendar (.ics) feed from your own site — built from the same calendar data already fetched via the Google Calendar API above — so subscribers can add it in Google Calendar, Apple Calendar, Outlook, or any other app that supports calendar subscriptions. No data is sent to any third party beyond the Google Calendar API connection already disclosed.