RedKirin Calendar Flex for Google Calendar

By redkirin

0+ active installationsVersion 1.0.7

Display public Google Calendar feeds as a fully customizable month, week or day calendar. No API key, no OAuth, no iframe.

Description

RedKirin Calendar Flex for Google Calendar turns one or more public Google Calendar ICS feeds into a calendar that is rendered with your own HTML, CSS and JavaScript on your WordPress site. Google’s embed iframe is not used, so the calendar inherits your theme and can be styled freely.

Features

  • Register up to five public Google Calendar ICS URLs per calendar, each with its own display name and color.
  • Month, week and day views with previous / today / next navigation, optionally switchable by visitors.
  • Limit navigation to the present and future, or to a number of months ahead.
  • Optional Japanese public holidays (fetched from Google’s public holiday calendar, observances excluded).
  • Event details in an accessible modal (keyboard, ESC, focus management), which can be turned off per calendar.
  • Recurring events (RRULE, RDATE, EXDATE, RECURRENCE-ID, cancelled instances) and time zones are handled server side.
  • Server-side caching (default 60 minutes) with stale fallback when Google is unreachable.
  • Base stylesheet built on CSS custom properties, five color themes plus a custom color code, and a switch to disable the base CSS entirely.
  • Theme template overrides: copy month.php, week.php, day.php or the parts into your-theme/redkirin-calendar-flex-for-google-calendar/.
  • Shortcode: [redkirin_calendar id="123"].
  • Live preview in the editor that follows unsaved changes.

Not included (by design)

  • Private calendars, Google API keys or OAuth. Only the public ICS address of a calendar is supported.
  • Real-time synchronization. Google updates public ICS feeds with a delay of up to several hours, and the plugin caches the data.

This plugin is not affiliated with, endorsed by, or sponsored by Google LLC. Google Calendar is a trademark of Google LLC.

External services

This plugin retrieves calendar data from Google’s public ICS feeds.

  • Service: Google Calendar public ICS feeds (calendar.google.com).
  • What is sent: Your WordPress server requests the ICS URL(s) that an administrator entered in the plugin settings, and, when the “Show Japanese public holidays” option is enabled, Google’s public Japanese holiday calendar URL. Requests include the server’s user agent string and, for conditional requests, the ETag / Last-Modified values of the previous response. No visitor data is sent; visitors’ browsers never contact Google.
  • When: When a calendar is displayed and the cache (default 60 minutes) has expired, when an administrator presses “Refresh now” or “Test connection”, and when the live preview in the editor is updated.
  • Terms and privacy: Google Terms of Service, Google Privacy Policy.

Installation

  1. Upload the plugin ZIP via Plugins → Add New → Upload Plugin, or copy the redkirin-calendar-flex-for-google-calendar folder into /wp-content/plugins/.
  2. Activate the plugin.
  3. In Google Calendar, open the calendar’s settings, enable Make available to public and copy the Public address in iCal format.
  4. Go to RedKirin Calendar Flex for Google Calendar → Add New, paste the ICS URL, press Test connection, adjust the display options and save.
  5. Paste the shortcode shown on the edit screen into a post, page or shortcode widget.

FAQ

Why do new events not appear immediately?

Two caches are involved: Google regenerates public ICS feeds with a delay (often several hours), and this plugin caches the downloaded data for 60 minutes by default. The plugin cache is cleared automatically whenever a calendar or the plugin settings are saved. You can also clear it manually with Refresh now on the calendar edit screen or Clear All Caches on the calendar list.

Can I show a private calendar?

No. Only public ICS addresses are supported. Making a calendar public in Google Calendar is required.

Can I use ICS feeds from services other than Google?

By default only calendar.google.com and www.google.com are allowed for security reasons. Developers can extend the list with the rkgcf_allowed_ics_hosts filter.

How do I change the design?

Choose one of the built-in color themes, or pick Custom color and enter any color code (for example #0a3d62): the other shades are derived from it automatically. For full control, override the CSS custom properties on .rk-calendar (for example --rk-calendar-primary, --rk-calendar-border, --rk-calendar-radius), target a single calendar with .rk-calendar-123, or turn off the base CSS and style the stable rk-calendar__* classes yourself. A download button for the base stylesheet is available on the edit screen.

Can I change the HTML?

Yes. Copy any file from the plugin’s templates/ folder into your-theme/redkirin-calendar-flex-for-google-calendar/ keeping the same relative path (for example parts/event.php) and edit it there.

What happens when the plugin is uninstalled?

Cached data is always removed. Calendars and settings are removed only if Delete all data on uninstall is enabled in the plugin settings.

Screenshots

Changelog

1.0.7

  • Weekday date numbers are now black in every color theme (Sunday, Saturday and holidays keep their colors).

1.0.6

  • Custom color theme: the text on the accent color (weekday header, today badge, active buttons) is now white for all but near-white base colors.

1.0.5

  • Refreshed default design: solid weekday header in the theme color, pill-shaped buttons, softly tinted event chips, and tinted Sunday, Saturday and holiday cells.
  • Event titles are no longer cut off with an ellipsis: they wrap and show in full. The colored dot in front of each event was removed.
  • The period title now stays on the same row as the navigation buttons on narrow screens.
  • Public holidays are listed below the day’s own events.
  • New per-calendar option “Show event details when an event is clicked”.
  • Fixed the week view on narrow screens, which was broken in 1.0.4.

1.0.4

  • Month view on narrow screens: cells no longer have a fixed height. Every row now matches the tallest cell, so months with few events take much less space.

1.0.3

  • New “Custom color” theme: enter any color code and the calendar palette is derived from it.

1.0.2

  • Month view on narrow screens now shows the event titles instead of dots, like on desktop.

1.0.1

  • The feed cache is now cleared automatically whenever a calendar or the plugin settings are saved.
  • Added a “Clear All Caches” button to the calendar list.

1.0.0

  • Initial release.