=== ICS Calendar === Contributors: room34 Donate link: https://room34.com/payments Tags: calendar, iCal, ICS, iCalendar, Google Calendar, Outlook, Office 365, Mac calendar, iOS calendar, calendar feed, feed, embed calendar, event, events, booking, vacation, holiday, schedule, gig list, church calendar, Airbnb, rental, availability, sync Requires at least: 4.9 Tested up to: 5.7.2 Requires PHP: 7.0.0 Stable tag: 7.7.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Easily embed live updating iCal (ICS) feeds from Google Calendar, Outlook, Apple, etc. Multiple color-coded feeds, list/month/week views and more. == Description == Using a simple shortcode, you can embed any iCalendar-compatible feed (Google Calendar, Microsoft Outlook, macOS/iOS Calendar and many more) seamlessly into your WordPress site. Continue to manage your events in the calendar software you're already using! You'll automatically have an up-to-date calendar in your website with no extra work. Display your calendar in month, list or week view. Many additional customiation options are available. See our [User Guide](https://icscalendar.com/user-guide/) for full details. **No API keys required!** **Works with ANY calendar software** that generates a public iCalendar subscription link. __Live Preview__ You can preview your own calendar in any ICS Calendar view at our website: [icscalendar.com/preview](https://icscalendar.com/preview/) __Timezone Support__ __If your event times are off by an hour after Daylight Saving Time begins:__ Please check your WordPress timezone setting (__Settings > General > Timezone__) and make sure it is set to a city name, not a UTC offset. See FAQ for additional details. As of version 6, customized timezone adjustments are supported. Events will default to displaying in the timezone of your site's general settings. Use the `tz` setting and specify a region/city named timezone, as such: `tz="America/Chicago"` __Language Support__ All date strings (days of the week, months, etc.) are automatically translated into your site's configured language (under **Settings > General > Language**) and date/time formats using core WordPress functionality. All text content for the calendar itself is displayed as-is from the feed. The small amount of additional front-end displayed text generated by the plugin defaults to U.S. English, but also supports the following translations: Chinese (Simplified), Danish, Dutch, Finnish, French (Belgium, Canada, France and Switzerland), German (Austria, Germany and Switzerland), Greek, Hungarian, Italian (Italy and Switzerland), Japanese, Korean (South Korea), Norwegian (Bokmål and Nynorsk), Portuguese (Brazil and Portugal), Spanish (Spain and Mexico) and Swedish. Please contact us if you would like us to add support for your language! __ClassicPress Compatible__ ICS Calendar uses some functionality introduced in WordPress 5.x, but those functions are replicated, as needed, in the `compatibility.php` file, allowing ICS Calendar to function with WordPress 4.9 and [ClassicPress](https://www.classicpress.net/). _This plugin includes the PHP ICS Parser library by Jonathan Goode, John Grogg and Martin Thoma (MIT license)._ == Installation == Once the plugin is installed and activated, use the shortcode below to insert a calendar into your pages. See FAQ for details. `[ics_calendar url="YOUR_ICAL_FEED_URL"]` Be sure you are using the _subscribe_ URL (i.e. for importing into a calendar program), not the URL for viewing a calendar in a web browser. == Frequently Asked Questions == __How do I find my calendar's ICS feed URL?__ Different calendar systems have different ways to obtain the feed URL. You may need to consult your calendar software's documentation for assistance. You will also need to make sure that your calendar is public. Private calendars cannot be accessed by this plugin. _Documentation quick links:_ * [Google Calendar](https://support.google.com/calendar/answer/37083#link) * [Microsoft Outlook](https://support.office.com/en-us/article/share-your-calendar-in-outlook-on-the-web-7ecef8ae-139c-40d9-bae2-a23977ee58d5) * [Calendar.app (Mac/iOS)](https://www.macobserver.com/tips/quick-tip/icloud-configure-public-calendar) __How do I insert a calendar into my page?__ Use this shortcode: `[ics_calendar url="YOUR_ICAL_FEED_URL"]` Be sure you are using the _subscribe_ URL (i.e. for importing into a calendar program), not the URL for viewing a calendar in a web browser. Additional customization options and usage documentation can be found under the __ICS Calendar__ link in the WordPress admin sidebar. If you are using the Classic Editor, you can also use the __Add ICS Calendar__ button to build the customized shortcode automatically from a set of options. __Can I combine multiple calendars?__ Yes! You can combine multiple calendars by including more than one feed URL in the `url` parameter. __Separate the calendar URLs with one space.__ Do not include any other delimiter characters, as they will be interpreted as part of the URL. __Why isn't my calendar loading?__ This may be due to your server's configuration. This plugin requires either the PHP cURL extensions, or the `allow_url_fopen` PHP setting to be turned on. Check your PHP configuration or your server administrator if you think this may be the issue. __Why isn't my calendar updating?__ For performance, this plugin uses WordPress transients to store retrieved calendar data for one hour between requests to the calendar source server. If you have updated events that are not showing up in your page, you can force the plugin to reload the ICS feed every time by adding `reload="1"` to the shortcode. Be sure to remove this when you no longer need to force reload. __Why are event times an hour off after Daylight Saving Time begins?__ PHP has two different ways of defining timezones: as a number of hours offset from GMT/UTC (e.g. "UTC-5"), or as a continent/city combination (e.g. "America/Chicago"). Timezones using UTC offsets do not handle Daylight Saving Time correctly (as noted in the [PHP documentation](https://www.php.net/manual/en/timezones.others.php)). Please check your WordPress timezone settings (__Settings > General > Timezone__). If it is set to a UTC offset, change it to the city closest to your location, in the same timezone. As of version 6.0 you can also set the timezone within the shortcode using the `tz` parameter. (Again, be sure to use a named region/city timezone, not a UTC offset.) __Feature requests and such...__ The paid [ICS Calendar Pro](https://icscalendar.com) add-on includes additional layout options, tools for customizing the calendar's appearance more easily than directly editing CSS, an improved insertion tool, and more. We are also constantly adding new features and refinements to _both_ the free and paid versions. If you have suggestions for features you'd like to see or any other additional input, please let us know by following the support link on the admin page or in the [WordPress support forums](https://wordpress.org/support/plugin/ics-calendar/)! The base plugin will always be free to use. == Screenshots == == Changelog == = 7.7.2 - 2021.06.23 = * Added logic to prevent rendering of invalid `` tags containing a `src` value that is a link to a Google Drive file. Images attached to events on Google Calendar are treated as Google Drive file links rather than direct images and are not accessible without logging into a Google account that is authorized to view the image. We are looking for a workaround, but in the meantime this will prevent these types of broken images from appearing in rendered calendars. = 7.7.1.2 - 2021.06.13 = * Fixed broken "Show past events" link in week view (mobile breakpoint). = 7.7.1.1 - 2021.06.10 = * Fixed "Undefined variable: d" PHP notice that was appearing on week view since a11y changes added in version 7.6.0. * Note: Stable tag for version 7.7.1 was inadvertently not updated, so updating to this version will also make the version 7.7.1 changes available, which may not have been previously. = 7.7.1 - 2021.06.07 = * Restructured `r34ics_maybe_make_clickable()` to support link formatting common in Microsoft Teams (Office 365) meetings, and improved use of `r34ics_is_html()` in determining whether or not to add HTML line breaks. = 7.7.0 - 2021.06.07 = * Refactored `R34ICS::display_calendar()` method: moved date range calculation and array sorting out of `foreach()` loop to improve performance on calendars with multiple feeds, and to avoid PHP warnings that may have occurred in edge cases where no feed was loaded. **Please note: These changes have eliminated timezone overrides for date range calculations, which could result in some calendars starting or ending one day off from the intended dates, especially if your feed timezone is different from your site's default timezone.** Please report any issues in the [WordPress support forums](https://wordpress.org/support/plugin/ics-calendar/). = 7.6.0 - 2021.06.01 = * a11y: Added `aria-labelledby` attributes to calendar containers to improve screen reader user experience. * Added conditional to omit empty `