Busy Month\/Week\/Day\/mini calendars no longer lose their last days to the "Max events" limit. View-switcher links get their names back for screen readers on phones. No more fatal error on servers without mbstring.<\/p>","0.23.4":"
Upcoming now shows today's all-day events and running multi-day events; Day view shows multi-day events; events ending at midnight no longer spill into the next day. "Hide past events" now works and is switched off on existing displays so nothing changes.<\/p>","0.23.3":"
Security hardening: the Google API key is no longer shown in admin debug details when WP_DEBUG is on. Also keeps the saved events when Google answers with something that is not calendar data.<\/p>","0.23.2":"
Fixes view switching (dead "+N more" and popovers after switching to Month, broken Back button, stale mini calendar), "Refresh now" not reaching visitors, and calendars broken by a configuration import (repaired automatically).<\/p>","0.23.1":"
Privacy fix: the Subscribe (ICS) feed now respects the display's search and hide filters. Also keeps showing the last saved events when Google is unreachable, and fixes a page-truncation bug from unusual event titles. Recommended for all sites.<\/p>","0.23.0":"
Only ordinary events are shown now: birthdays, Gmail reservations and Workspace working-location \/ out-of-office entries no longer appear on public calendars. Service-account scope narrowed to events.readonly; no action needed.<\/p>","0.22.1":"
Fixes the Upcoming (compact list) view showing multi-day all-day events as single-day. It now shows the date range instead of "All day". Front-end fix.<\/p>","0.21.6":"
Fixes the styled hover popover falling back to the browser's plain tooltip after paging between months via the arrow navigation. Front-end fix; the styled popover now survives instant month navigation (and browser back\/forward).<\/p>","0.21.4":"
Fixes the Upcoming view showing fewer events than "Maximum events to show" when the calendar has events earlier the same day. Front-end fix; the view now reliably shows the configured number of upcoming events.<\/p>","0.21.3":"
The Displays editor's Live preview now shows a "Showing N events" count of what it rendered (the same as the front-end), so you can confirm a display's event count at a glance. Admin-only; no front-end change.<\/p>","0.21.2":"
Clearer Upcoming options: "Event time size" greys out (with a reason) when the meta line is off, and the event-name size\/weight controls are renamed to avoid confusion with the time control. Admin-only; no front-end change.<\/p>","0.21.1":"
Accessibility polish on the Displays view-filter: each button now announces its section count to screen readers, with correct singular\/plural. Admin-only; no front-end change.<\/p>","0.21.0":"
The Displays editor's view chips become a single filter bar that truly hides (not dims) settings that don't apply to the chosen view, with per-view counts and a live status line. Admin-only; all fields still save while filtered. No front-end change.<\/p>","0.20.0":"
Splits "Event chip style" into two independent settings \u2014 "List view: event row style" and "Month view: event chip style" \u2014 so you can style both views on one display. Existing displays, blocks, and shortcodes migrate automatically with no visual change.<\/p>","0.19.1":"
Fixes List view styling (week-heading pills + event accent bars) vanishing after an instant view-swap; a stray focus box around a heading after a swap on iOS \/ touch; and the Month\/Week\/Day\/Mini prev\/next arrows could switch the view instead of just changing the period.<\/p>","0.19.0":"
Polishes the List view's week\/day section headings (clearer typography) and removes a stray focus box that could appear around the first heading after an instant view-swap. Visual refinement only \u2014 no settings to change.<\/p>","0.18.1":"
Adds an optional dedicated colour for the Upcoming "Today \/ Tomorrow" pill. Default is unchanged (the pill follows the event colour) until you set it.<\/p>","0.18.0":"
Adds two opt-in Upcoming-view options: a time\/All-day text size and a dedicated date-badge colour. Defaults are unchanged, so existing displays look exactly the same until you set them.<\/p>","0.17.0":"
Adds three opt-in Upcoming-view options: date-badge size, Today\/Tomorrow labels, and day\/week grouping. Defaults are unchanged, so existing displays look exactly the same until you enable them.<\/p>","0.16.4":"
Adds an admin "Event text size" (and optional weight) control for the Upcoming view. Defaults are unchanged, so existing displays look exactly the same until you opt in.<\/p>","0.16.3":"
Completes the 0.16.2 fix for the mobile\/instant-view-swap path: the toggle date guard now lives in the shared anchor resolver, and the render cache is version-keyed so an upgrade self-busts stale HTML. Clear the calendar render cache once after updating.<\/p>","0.16.2":"
Bug fix: the view-toggle links could send a view switch to a garbage date (with no events) on the default no-date render, locking every view onto it. Toggles now follow the same resolved date as the grid and Prev\/Today\/Next, with a guard against out-of-range dates. No action required.<\/p>","0.16.1":"
New per-display "Link event titles" toggle \u2014 turn it off to show event titles as plain text (no link) when the Google event page isn't useful to visitors. Default on; existing displays unchanged.<\/p>","0.16.0":"
Internal hardening: the per-Display settings now flow through one shared schema, preventing the recurring class of "works in the admin preview but not on the front-end" bugs. No action required.<\/p>","0.15.1":"
Bug fix: the per-display Chip text color setting now applies on the front-end (not just in the admin preview). Also redacts the API key from error-log lines and tidies up leftover options on uninstall. No action required.<\/p>","0.15.0":"
Bug fix: long unspaced event titles no longer overflow the box in the Cards view. Also bundles the 0.14.x additions \u2014 Upcoming "Link placement" control, optional date-badge style, and the touch-device tagged-link fix. No action required.<\/p>"},"ratings":[],"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":3533428,"resolution":false,"location":"assets","locale":false}},"assets_banners":[],"assets_blueprints":{},"all_blocks":{"sdaweb-gcal\/calendar":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"sdaweb-gcal\/calendar","version":"0.23.5","title":"SDAweb Calendar","category":"widgets","description":"Display events from one or more Google Calendars. Choose a saved display or configure inline.","icon":"calendar-alt","keywords":["calendar","google","events","schedule"],"supports":{"html":false,"align":["wide","full"],"spacing":{"margin":true,"padding":true}},"attributes":{"displayId":{"type":"string","default":""},"calendars":{"type":"string","default":""},"view":{"type":"string","default":"list"},"days":{"type":"number","default":30},"daysBack":{"type":"number","default":0},"anchorDate":{"type":"string","default":""},"startDate":{"type":"string","default":""},"endDate":{"type":"string","default":""},"dateFormat":{"type":"string","default":""},"timeFormat":{"type":"string","default":""},"rangeMode":{"type":"string","default":"rolling"},"rangePreset":{"type":"string","default":""},"max":{"type":"number","default":50},"group":{"type":"string","default":"day"},"showEnd":{"type":"boolean","default":false},"showEventDate":{"type":"boolean","default":false},"showCalendar":{"type":"boolean","default":false},"calendarLabelMode":{"type":"string","default":""},"showFeedLegend":{"type":"boolean","default":false},"labels":{"type":"object","default":{}},"showLocation":{"type":"boolean","default":false},"showDescription":{"type":"boolean","default":false},"descriptionWords":{"type":"number","default":30},"hideAllDay":{"type":"boolean","default":false},"hideCancelled":{"type":"boolean","default":true},"hidePast":{"type":"boolean","default":false},"search":{"type":"string","default":""},"timezone":{"type":"string","default":""},"primaryColor":{"type":"string","default":""},"accentColor":{"type":"string","default":""},"darkMode":{"type":"string","default":"auto"},"linkTarget":{"type":"string","default":"same"},"viewToggle":{"type":"boolean","default":false},"viewToggleViews":{"type":"string","default":"list,month,card"},"viewTogglePosition":{"type":"string","default":"top-right"},"timeFormatMode":{"type":"string","default":"site"},"firstDayOfWeek":{"type":"string","default":"site"},"showWeekNumbers":{"type":"boolean","default":false},"recurrenceIndicator":{"type":"string","default":"icon"},"icsSubscribe":{"type":"string","default":"none"},"listWeekHeading":{"type":"string","default":"number"},"listHeadingStyle":{"type":"string","default":"relative"},"mobileDegrade":{"type":"string","default":"auto"},"miniDefaultPanel":{"type":"string","default":"today_upcoming"},"miniUpcomingMax":{"type":"number","default":30},"miniFullUrl":{"type":"string","default":""},"miniFullLabel":{"type":"string","default":""},"todayColor":{"type":"string","default":""},"linkColor":{"type":"string","default":""},"eventColorOverride":{"type":"string","default":""},"eventHover":{"type":"string","default":"rich"},"todayStyle":{"type":"string","default":"column"},"timePlacement":{"type":"string","default":"beside_date"},"listChipStyle":{"type":"string"},"monthChipStyle":{"type":"string"},"chipStyle":{"type":"string"},"listHeadingPosition":{"type":"string","default":"inline"},"cardGrouping":{"type":"string","default":"none"},"monthOverflowAction":{"type":"string","default":"popover"},"showSearch":{"type":"boolean","default":false},"showDatePicker":{"type":"boolean","default":false},"locale":{"type":"string","default":""},"maxEvents":{"type":"number","default":5},"showTitle":{"type":"boolean","default":false},"titleText":{"type":"string","default":""},"showLinkToFullCalendar":{"type":"boolean","default":false},"linkUrl":{"type":"string","default":""},"showMeta":{"type":"boolean","default":true}},"textdomain":"sdaweb-gcal-sync","editorScript":"file:.\/index.js","editorStyle":"file:.\/editor.css","render":"file:.\/render.php"}},"tagged_versions":["0.10.0","0.10.1","0.11.0","0.11.1","0.12.0","0.12.1","0.12.2","0.12.8","0.12.9","0.13.0","0.13.4","0.14.0","0.14.1","0.14.2","0.14.6","0.15.0","0.15.1","0.16.0","0.16.1","0.16.3","0.16.4","0.17.0","0.18.0","0.18.1","0.19.0","0.20.0","0.21.1","0.21.4","0.21.6","0.22.0","0.22.1","0.22.5","0.22.6","0.23.0","0.23.1","0.23.2","0.23.3","0.23.4","0.23.5","0.8.5","0.8.6","0.9.0","0.9.1","0.9.2","0.9.3","0.9.4","0.9.5"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Month grid with multi-day event ribbons and today highlight.","2":"Upcoming view with filled date badges and Today \/ Tomorrow labels.","3":"Mini-month compact grid with tap-to-expand event panel.","4":"Hover popover with event date, time, location, and click-through link.","5":"ICS subscribe dropdown \u2014 add events to Google, Apple, or Outlook in one tap.","6":"Admin colour picker showing live WCAG contrast warnings."}},"plugin_section":[],"plugin_tags":[5595,416,1486,4743,4062],"plugin_category":[40],"plugin_contributors":[257114,256141],"plugin_business_model":[],"class_list":["post-307966","plugin","type-plugin","status-publish","hentry","plugin_tags-agenda","plugin_tags-calendar","plugin_tags-events","plugin_tags-google-calendar","plugin_tags-schedule","plugin_category-calendar-and-events","plugin_contributors-rstake","plugin_contributors-sdaweb","plugin_committers-rstake"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/sdaweb-gcal-sync\/assets\/icon.svg?rev=3533428","icon":"https:\/\/ps.w.org\/sdaweb-gcal-sync\/assets\/icon.svg?rev=3533428","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"\n
SDAweb Calendar Sync turns any Google Calendar into a polished, on-brand events display on your WordPress site \u2014 without duplicate data entry. Keep scheduling in Google Calendar the way you already do; the plugin pulls those events in and keeps your site in sync automatically.<\/p>\n\n
It's for anyone who already runs their events in Google Calendar and wants them to look like a native part of their site instead of an embedded iframe \u2014 businesses, teams, venues, clubs, communities, and organisations of every kind.<\/p>\n\n
Insert a calendar with a Gutenberg block, a shortcode, or a classic widget. All three share one render pipeline, so the output is identical however you add it.<\/p>\n\n
Switch between views with one setting, or expose a visitor-facing view-toggle pill so visitors can switch themselves. Under the hood every view shares the same data layer, the same CSS-variable system, and the same accessibility baseline.<\/p>\n\n
Credentials are encrypted at rest using a key derived from your site's authentication salt. They are never echoed back into the admin UI \u2014 only the masked value and (for service accounts) the public service-account email are shown.<\/p>\n\n
The plugin reads your active theme's One-click coordinated colour bundles: Default<\/strong> (clean blue), Warm earth<\/strong> (cream + deep red), High contrast<\/strong> (solid black on white for AAA-stricter sites), Forest<\/strong> (deep green), Sunset<\/strong> (warm coral + amber).<\/p>\n\n WCAG 2.2 AA baseline with several AAA touches:<\/p>\n\n Extension hooks are documented in This plugin connects to the Google Calendar API to retrieve events from calendars you configure.<\/p>\n\n 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.<\/p>\n\n The ICS subscribe feature, when enabled, serves a self-hosted iCalendar (.ics) feed from your own site \u2014 built from the same calendar data already fetched via the Google Calendar API above \u2014 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.<\/p>\n\n\n You need a Google Cloud project to generate either an API key (for public calendars) or a service account (for private calendars). The plugin's Help tab walks you through both setups in 7\u20138 steps each. Setup is one-time per site.<\/p><\/dd>\n No. Calendar data is fetched directly from Yes. Use the Service Account authentication option. The plugin shows you the service account email; share your private calendar with that email in Google Calendar's sharing settings, and the plugin can read it.<\/p><\/dd>\n A WP-Cron job refreshes registered calendars in the background every 15 minutes. Cache lifetime is configurable upward in the plugin settings (15 minutes is the enforced minimum). You can also click \"Refresh now\" on any calendar in the admin to fetch immediately.<\/p><\/dd>\n Yes \u2014 the calendar HTML is part of the page output, so any page-cache plugin caches it like any other content. The cache will refresh on its own schedule. If you need immediate refresh after a calendar change, purge the page cache.<\/p><\/dd>\n Yes. Each display picks one or more registered calendars and merges them. Events are color-coded by calendar. A multi-feed legend strip can be enabled above the events; chips can be styled solid (single-feed) or pastel (multi-feed legibility).<\/p><\/dd>\n The plugin reads your active theme's Yes \u2014 built-in. WCAG 2.2 AA baseline includes Yes. Each display has an optional Locale override field \u2014 set it to In The most recent releases are listed here. The complete history is in\n docs\/CHANGELOG.md bundled with the plugin.<\/p>\n\ntheme.json<\/code> color palette and uses your primary<\/code>, accent<\/code>, foreground<\/code>, and background<\/code> 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.<\/p>\n\nFive built-in theme presets<\/h4>\n\n
Accessibility built in<\/h4>\n\n
\n
prefers-contrast: more<\/code><\/li>\nprefers-reduced-motion<\/code> honored everywhere<\/li>\nBuilt for the WordPress.org standard<\/h4>\n\n
\n
InspectorControls<\/code><\/li>\n.po<\/code>\/.mo<\/code> \u2014 WordPress auto-loads locale files into wp-content\/languages\/plugins\/<\/code> per the WP Plugin Handbook), plurals via _n()<\/code>, JS strings via wp_localize_script<\/code><\/li>\nFor developers<\/h4>\n\n
docs\/hooks.md<\/code> 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.<\/p>\n\nThird-Party Services<\/h3>\n\n
\n
\n
\/wp-content\/plugins\/<\/code> directory, or install it from the Plugins screen in WordPress.<\/li>\n\n
Do I need a Google account to use this plugin?<\/h3><\/dt>\n
Does this plugin send my data anywhere other than Google?<\/h3><\/dt>\n
googleapis.com<\/code> using the Google Calendar API. The plugin does not contact any SDAweb-controlled servers, analytics endpoints, or third-party relays. There is no telemetry.<\/p><\/dd>\nCan I display a private (non-public) calendar?<\/h3><\/dt>\n
How often does the plugin refresh events?<\/h3><\/dt>\n
Does it work with caching plugins?<\/h3><\/dt>\n
Can I add multiple calendars to one display?<\/h3><\/dt>\n
Will it work with my theme?<\/h3><\/dt>\n
theme.json<\/code> color palette automatically, so calendar colors match the site by default with zero configuration. If you use a classic theme without theme.json<\/code> (or want to override), every color is exposed as a CSS variable that you can override from your theme stylesheet. Five built-in theme presets give you coordinated palettes with one click.<\/p><\/dd>\nIs the plugin accessible?<\/h3><\/dt>\n
prefers-reduced-motion<\/code> and prefers-contrast: more<\/code> support, :focus-visible<\/code> outlines with a white halo (visible on any background), ARIA labelling on the month grid, navigation, popovers, and view-toggle, semantic HTML throughout, RTL-aware via CSS logical properties, and live contrast warnings in the colour-picker UI as you choose values.<\/p><\/dd>\nCan I show the calendar in a different language than the rest of the site?<\/h3><\/dt>\n
nb_NO<\/code>, sv_SE<\/code>, etc. and that calendar renders weekday names, month names, and built-in labels in that language regardless of the site's language. Useful when an English site hosts Norwegian-audience content.<\/p><\/dd>\nWhere are the extension hooks documented?<\/h3><\/dt>\n
docs\/hooks.md<\/code> inside the plugin folder. The plugin commits to keeping documented hooks stable within a major version.<\/p><\/dd>\n\n<\/dl>\n\n\n0.23.5<\/h4>\n\n
\n
kalender<\/code>), renaming a display does too, and records already stuck are repaired automatically on update. Names in Norwegian and other Latin-alphabet languages were never affected.<\/li>\n<\/ul>\n\n0.23.4<\/h4>\n\n
\n
0.23.3<\/h4>\n\n
\n