RedKirin Calendar Flex for Google Calendar
| 开发者 | redkirin |
|---|---|
| 更新时间 | 2026年11月4日 19:27 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- 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).
- 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.phpor the parts intoyour-theme/redkirin-calendar-flex-for-google-calendar/. - Shortcode:
[redkirin_calendar id="123"]. - Live preview in the editor that follows unsaved changes.
- 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.
安装:
- Upload the plugin ZIP via Plugins → Add New → Upload Plugin, or copy the
redkirin-calendar-flex-for-google-calendarfolder into/wp-content/plugins/. - Activate the plugin.
- In Google Calendar, open the calendar's settings, enable Make available to public and copy the Public address in iCal format.
- Go to RedKirin Calendar Flex for Google Calendar → Add New, paste the ICS URL, press Test connection, adjust the display options and save.
- Paste the shortcode shown on the edit screen into a post, page or shortcode widget.
屏幕截图:
常见问题:
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.
更新日志:
- 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.
- New "Custom color" theme: enter any color code and the calendar palette is derived from it.
- Month view on narrow screens now shows the event titles instead of dots, like on desktop.
- 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.
- Initial release.