Two housekeeping fixes: service-account token-exchange success log gated on WP_DEBUG (was firing every ~55 min unconditionally); readme upgrade notice for 0.8.3 trimmed to meet Plugin Check character limit.<\/p>","0.8.5":"
Adds a per-row Delete button to Tools \u2192 Backups so individual snapshots can be removed without waiting for the retention cap to evict them.<\/p>","0.8.4":"
Companion fix to 0.8.3 \u2014 preserves the Auto-resolved chip text color on hover. Without this fix, hovering a Solid chip in Month view reset the title to the link\/accent color, often dropping below the WCAG contrast Auto mode just protected. No action required after upgrade.<\/p>","0.8.3":"
Fixes Month-view Solid chip readability for mid-luminance feed colors (greens, yellows, mints): chip text now auto-picks dark text when white fails WCAG AA. Adds a per-display Solid chip text color dropdown. No action required after upgrade.<\/p>","0.8.2":"
Adds three new title-appearance controls (size, weight, uppercase) to the Upcoming view so its title can match surrounding sidebar\/footer headings without site CSS overrides. Existing displays render unchanged.<\/p>","0.8.1":"
Fixes URL parameters bleeding across calendar instances on the same page (switching the main calendar to Month would also flip a footer widget into Month \u2014 and look awful in the narrow footer column). Recommended for everyone with multiple calendars on the same page.<\/p>","0.8.0":"
Month-view "+N more" is now interactive \u2014 a real a11y improvement (was unreachable by keyboard and screen readers). New "Day overflow" setting picks between an in-place popover (default) or navigating to the Day view for that date.<\/p>","0.7.4":"
Cards view now correctly indicates multi-day events: same-month events show a "4\u20138" date range; cross-month events stack the start and end dates with an arrow. With Hotfix for 0.7.2: moves Admin polish: Edit Display selects no longer clip behind the Live preview when the option text is long.<\/p>","0.7.0":" Adds a "Card grouping" option (off \/ by day \/ by week \/ by month) to the Cards view. Existing displays render identically until you opt in.<\/p>","0.6.10":" Fixes per-display label overrides being silently dropped by the shortcode pipeline (same root cause as 0.6.9). Adds Event color override to the Gutenberg block UI. Fixes the admin Live Preview falling back to List when a display's saved view is Upcoming. Recommended for everyone.<\/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.13.0","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":true},"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"},"chipStyle":{"type":"string","default":"linear"},"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.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":"All six views \u2014 List, Month grid, Card grid, Week, Day, Mini-month \u2014 sharing one render pipeline.","2":"Month grid with today highlighted, multi-day event ribbons spanning across cells, ISO week numbers, and the hover popover shown on a chip.","3":"Mini-month view with dot-density grid and below-grid panel showing today + upcoming events with a \"Load more\" button.","4":"ICS subscribe dropdown \u2014 one-click hand-offs to Google, Apple\/Outlook, Android, and copy-link.","5":"Block editor experience \u2014 SDAweb Calendar block with full Inspector controls and live preview.","6":"Calendars admin tab \u2014 list of registered calendars with health status, last refresh, and actions.","7":"Add calendar form, Service account flow with JSON paste field and explanatory help.","8":"Test connection result showing the next three real event titles directly in the form.","9":"Displays editor with live preview pane and theme-presets selector.","10":"Help tab showing the in-app service-account setup walkthrough."}},"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 pulls events directly from the Google Calendar API and renders them on your site through a Gutenberg block, a shortcode, or a classic widget. All three share one render pipeline so output is identical regardless of how you insert a calendar.<\/p>\n\n All views share the same data layer, the same CSS-variable system, and the same accessibility baseline. Switch between them with one setting, or expose a visitor-facing view-toggle pill so visitors can switch themselves.<\/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, links visitors directly to Google's public iCal feed ( 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\ncard_grouping = day<\/code>, multi-day events also appear under every day they cover (matching Week and Mini view behaviour).<\/p>","0.7.3":"CHANGELOG.md<\/code> from the plugin root into docs\/<\/code> to avoid Plugin Check's unexpected_markdown_file<\/code> warning. No code changes.<\/p>","0.7.1":"Six views, one render pipeline<\/h4>\n\n
\n
Smart UX out of the box<\/h4>\n\n
\n
Two authentication paths<\/h4>\n\n
\n
Theme-aware out of the box<\/h4>\n\n
theme.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
calendar.google.com\/calendar\/ical\/...\/public\/basic.ics<\/code>) \u2014 the plugin does not proxy or store that data.<\/p>\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.13.0<\/h4>\n\n
\n
0.12.9<\/h4>\n\n
\n
https:\/\/example.com\/kalender\/<\/code> to English https:\/\/example.com\/calendar\/<\/code>. Plugin source language is English; example strings should match. Affects three input fields on the display edit form (Upcoming \"See all\" URL, Footer link URL, Mini-month full-calendar URL) plus the equivalent control in the Gutenberg block inspector. No functional change.<\/li>\n<\/ul>\n\n0.12.8<\/h4>\n\n
\n
$context<\/code> reference in View_Nav::render()<\/code> that emitted a PHP warning on every prev\/next anchor render \u2014 invisible when display_errors<\/code> is off, but if on it injected into the response body and corrupted the JSON the swap module received.<\/li>\n<\/ul>\n\n0.12.7<\/h4>\n\n
\n
View_Nav::render()<\/code> referenced an undefined $context<\/code> variable (the function takes $display_slug<\/code> directly, not a context object). PHP 8+ emitted a Warning per request; when display_errors<\/code> is on in the host's PHP config, that warning text gets injected into the response body \u2014 corrupting the JSON returned to the swap module (\"display totally messed up\" after a swap). View_Nav::render()<\/code> now takes $page_url<\/code> as an explicit parameter; the four callers (Day\/Week\/Month\/Mini renderers) pass $context->page_url<\/code>. No more undefined-variable reference.<\/li>\n<\/ul>\n\n0.12.6<\/h4>\n\n
\n
\/wp-json\/sdaweb-gcal\/v1\/render<\/code>) instead of the page URL, because add_query_arg()<\/code> with no explicit base falls back to $_SERVER['REQUEST_URI']<\/code>. Invisible to JS users (the swap module parses params from the href query string and ignores the pathname), but would have broken any non-JS path through the swapped HTML and produced incorrect URLs in any context that read raw hrefs (e.g. RSS-style aggregators, accessibility tools that surface link targets). Client now sends page_url=window.location.href<\/code> as a REST param; server validates same-origin and uses it as the base for all toggle\/nav anchor URLs. Per-page-URL cache partitioning added to the render cache + ETag so cached responses don't cross-contaminate across host pages.<\/li>\n<\/ul>\n\n0.12.5<\/h4>\n\n
\n
parseLinkIntent<\/code> was reading the saved-display slug from root.dataset.sdawebGcalId<\/code>, which actually holds the synthesised DOM identifier (sdaweb-gcal-<hash><\/code>), not the saved-display slug \u2014 REST endpoint correctly rejected it as unknown \u2192 400 \u2192 swap fell back to native nav. Now reads sdaweb_gcal_id<\/code> from the link's query string (the authoritative source) with the root dataset as a fallback. (2) Hover\/focus prefetch's .catch()<\/code> was returning null<\/code>, which leaked through to applySwap()<\/code> and crashed on data.html<\/code>. Now re-throws so swap()'s own catch handles the fallback cleanly. (3) applySwap<\/code> and announceToScreenReader<\/code> gained null guards as defense-in-depth so any future malformed payload bails gracefully instead of throwing. The pushState<\/code> URL is now also correct (it uses params.slug<\/code>, which is now the proper value).<\/li>\n<\/ul>\n\n0.12.4<\/h4>\n\n
\n
.mjs<\/code> in their MIME map) served the script module as application\/octet-stream<\/code>, and browsers silently refuse to execute modules whose Content-Type isn't a JavaScript MIME type. No error logged (the refusal happens before any module code runs), so symptoms were \"module file present, all bytes correct, zero console errors, no click interception.\" Renamed swap.mjs<\/code> \u2192 swap.js<\/code>. WordPress's script-modules API adds type=\"module\"<\/code> regardless of file extension; the .js<\/code> extension is universally JS-MIME-mapped on every host. Diagnosed via Claude-for-Chrome inspection of the live response headers on stavdal.me.<\/li>\ndata-sdaweb-gcal-view-toggle=\"<view-slug>\"<\/code> in addition to the existing BEM class. Swap module's click delegate matches by either \u2014 defense in depth against future class refactors or theme-side class manipulation. Diagnostic logs from 0.12.2 remain gated by ?sdaweb_gcal_swap_debug=1<\/code>.<\/li>\n<\/ul>\n\n0.12.2<\/h4>\n\n
\n
?sdaweb_gcal_swap_debug=1<\/code> to the URL, or by setting window.SdawebGcalSwap.debug = true<\/code> before the module loads. Silent by default \u2014 no production impact. Surfaces the cause of \"module loads but clicks fall through to full-page navigation\" reports without requiring code changes for diagnosis.<\/li>\n<\/ul>\n\n0.12.1<\/h4>\n\n
\n
cache: { hit, age_seconds }<\/code> field derived from Render_Cache hit\/miss state; Link: <home_url>; rel=\"canonical\"<\/code> header so caching layers indexing the JSON point back to the human site; swap:render:abort<\/code> diagnostics event via connection_aborted()<\/code> on client disconnect.<\/li>\nwindow.SdawebGcalSwap.debug<\/code> + the Diagnostics activity log.<\/li>\nwp sdaweb-gcal rest-render <slug><\/code> CLI command for dispatching the REST endpoint internally + dumping JSON response to stdout \u2014 drives the new REST snapshot tests.<\/li>\nwp sdaweb-gcal architecture-check --fixture=<path><\/code> CLI command \u2014 assert REST inner-HTML normalises to shortcode-pipeline inner-HTML for the same display config. Catches future drift between the two render paths.<\/li>\nrest-list-grouped-by-day<\/code>, rest-month-grid<\/code>, rest-cards-anchor<\/code>) + shared events fixture. Test runner extended to handle both HTML and JSON snapshots and to run the architecture regression check as a final pass.<\/li>\ntests\/boot-regression.html<\/code> \u2014 browser-runnable assertion that swap.mjs's boot path attaches its click listener correctly regardless of when DOMContentLoaded fires. Catches the bug class where a deferred ES module misses the DOMContentLoaded event and silently leaves the click delegate unwired.<\/li>\n<\/ul>\n\n0.12.0<\/h4>\n\n
\n
\/wp-json\/sdaweb-gcal\/v1\/render<\/code> for fetching individual view fragments. Public read; returns JSON with inner HTML + ETag + Cache-Control headers. 304 Not Modified support saves bandwidth on repeat navigations.<\/li>\nSave-Data<\/code> and runs in requestIdleCallback<\/code> so it never competes with user-driven work. Per-root LRU(6).<\/li>\naria-busy<\/code> during fetch, screen-reader announcement after swap via a per-root live region, focus moves to the new view's primary heading, prefers-reduced-motion<\/code> skips the transition animation.<\/li>\nswap:render:ok\/304\/fail<\/code> events into the v0.11.0 #12 ring buffer. Set window.SdawebGcalSwap.debug = true<\/code> from the browser console for client-side timing logs.<\/li>\n0.11.1<\/h4>\n\n
\n
__()<\/code> call as the sniff requires). No runtime behavior change.<\/li>\n<\/ul>\n\n0.11.0<\/h4>\n\n
\n
View_Footer_Link<\/code>-sibling helper Link_Target::attrs()<\/code>, so the display's \"Open links in\" setting governs all link surfaces consistently. Mini-month full-link and Upcoming top-row \"See all\" now also honour the setting (previously hardcoded to same-window). Footer link remains decoupled per 0.10.1.<\/li>\n