ICS Calendar

Description

Using a simple shortcode, you can embed any iCalendar subscription feed (ending in .ics) into a page as a monthly calendar grid.

This plugin includes the PHP ICS Parser library by Jonathan Goode, John Grogg and Martin Thoma (MIT license).

Blocks

This plugin provides 1 block.

r34ics/r34ics-block
ICS Calendar

Installation

Once the plugin is installed and activated, use the shortcode below to insert a calendar into your pages. See FAQ for details.

FAQ

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:

How do I insert a calendar into my page?

Use this shortcode:

[ics_calendar url="ICAL_SUBSCRIBE_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 can be found in WordPress admin under Settings > ICS Calendar.

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! As of version 3.0.0, 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 limit the number of times the ICS feed is loaded from the source. 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.

Feature requests and such…

We are currently developing a new paid “Pro” add-on that will include additional layout options, tools for customizing the calendar’s appearance more easily than directly editing CSS, an improved insertion tool, and more. 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! The core plugin of course will always be free to use.

Reviews

November 12, 2019
A simple plugin with a simple function but it work well! A good feature could be to can change the time display in calendar for remove “min” per example. Thanks for your work!
September 19, 2019
Just had to leave a review after getting some top notch support for this plugin. The plugin itself is great and does just what it needs to. However, there was a small issue with my particular feed and daylight savings which was causing some time display issues. I received a reply to my query in just a few hours and by the end of the day there was a patch to sort the problem. The plugin is great and the support is outstanding. Definitely worth the five stars!
September 11, 2019
This is really the best WordPress calendar plugin available! I have tried every kind of Calendar plugin, and this is for sure the best! Gives the right customisations option and has all the feature that you can desire! And it is free!!! Thank you for making WordPress the beautiful thing that it was! All the best
August 22, 2019
Does much more than expected ! Tank you so much for thie very good job !
August 12, 2019
This plugin offers a very nice simplistic view of an ICS calender of choice. Other plugins are way too bloated for simple use cases. The friendly developer patched a known bug extremely fast after I sent him an email about it (1 day)! This plugin is definitely not yet getting the recognition it deserves. Perhaps because the use cases for it are not very clear. I use the plugin to provide personal timetables for music student. It perfectly fits my use case when combining it with another plugin named "Private Content". This way each student only sees their own lesson schedule while I can see all schedules combined on my phone, tablet or computer. Thank you so very much! Will definitely purchase the Pro version when it is available!
Read all 11 reviews

Contributors & Developers

“ICS Calendar” is open source software. The following people have contributed to this plugin.

Contributors

“ICS Calendar” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “ICS Calendar” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

4.5.0.1 – 2019.11.01

  • Modified .no_phone and .phone_only classes to override conflicts in some themes. This is a temporary solution that will be improved upon in a future version.
  • Added aria-hidden="true" attributes to date values that were changed in version 4.4.1 to prevent redundant date descriptions in screen readers.

4.5.0 – 2019.11.01

  • Fixed bug that prevented week view from showing events from the previous month when a new month begins during the current week. (Adjusted date range of initial parser run.)
  • Refactored time zone logic so tzoffset works properly and can be used in conjuction with tzignore to override the feed’s time zone data. (Previously tzoffset only worked if the feed did not contain any time zone data.)
  • Added support for multiple tzoffset values (space-delimited) for calendars that include multiple feed URLs and need to use a different time zone setting for each feed.

4.4.1 – 2019.11.01

  • Added support for the format attribute in the mobile breakpoint only for month and week views. (Already supported in list view.)
  • Updated “Tested up to” to 5.2.4.

4.4.0.1 – 2019.10.07

  • Changed CSS class for toggle attribute to work around third-party plugin conflicts.
  • Fixed PHP notice that may occur if events in feed don’t have an ATTACH array.

4.4.0 – 2019.10.01

  • Added maskinfo option to hide event details (e.g. for vacation rental availability).
  • Updated admin User Guide page with additional resource links and updated information about the upcoming Pro version.

4.3.1 – 2019.09.30

  • Added support for attachments in event descriptions. Images will be displayed inline; PDFs will be download links. For security purposes, other file formats are not supported at this time. (As with URLs, these will be included automatically when eventdesc="true" is set.)
  • Removed commented-out workaround code.

4.3.0 – 2019.09.27

  • Removed workaround code for time zone issues that should no longer be needed with ICS Parser library v. 2.1.13. PLEASE REPORT ANY NEW START/END TIME CALCULATION ISSUES, ESPECIALLY AROUND THE START/END OF DAYLIGHT SAVING TIME, IN THE SUPPORT FORUMS AND WE WILL WORK TO RESOLVE ASAP.
  • Refactored and streamlined ICS event parsing code.
  • Encapsulated event detail HTML in new R34ICS::event\_description\_html() method for cleaner template code.
  • Added support for URLs in events (included in output when eventdesc="true" is set, rather than as its own parameter).
  • Added jQuery to open offsite links in a new tab. (Can’t be added to the HTML directly because it relies on the core WordPress make\_clickable() function.)

4.2.0.1 – 2019.09.25

  • Modified r34ics_url_get_contents() to convert ampersand entities in URL to plain ampersands.

4.2.0 – 2019.09.23

  • Added organizer option to display organizer information if included in the feed.
  • Added support for startdate to all views.
  • Fixed bug preventing description/location/organizer data from displaying in list view when toggle is off.
  • Refactored Add ICS Calendar button/overlay to work with multiple WYSIWYG editors, including those with delayed initialization (e.g. Advanced Custom Fields).
  • Moved debugger CSS to separate file that only loads for site admins.
  • Added hooks to admin Add ICS Calendar overlay.
  • Miscellaneous admin CSS/JS debugging and refactoring.

4.1.4 – 2019.09.23

  • Per multiple support requests, reversed order of location and description in all views.
  • Modified color calculation function to increase opacity of “highlight” color.

4.1.3.1 – 2019.09.22

  • Fixed issue with conditional for color key below calendars, to avoid a PHP warning that was appearing when no colors are set.

4.1.3 – 2019.09.21

  • Corrected code for custom limitdays value to calculate starting from calendar’s first event date rather than the current date and subtracted 1 from calculated value to account for the first date.
  • Broke out r34ics_hex2rgba() as separate function.
  • Included additional fields in parsed event data for display manipulation in Pro version.
  • Updated hooks for Pro version.

4.1.2 – 2019.09.18

  • Added bypassworkaround="true" option to allow users to test bypassing some existing workarounds for time zone calculation errors in ICS Parser that may no longer be needed. If you are finding issues with time calculations, especially around switching into/out of Daylight Saving Time, please add this parameter to your shortcode and let us know in the WordPress support forum if it is helpful.
  • Modified handling of limitdays parameter. When set, it now applies a hard end date for the display range, rather than ending at the date of the last event in the feed.

4.1.1 – 2019.09.18

  • Added missing documentation of the tzoffset feature to the admin page.
  • Fixed broken month layout for months ending on a Sunday when site’s “Week starts on” value is set to a day other than Sunday.

4.1.0 – 2019.09.16

  • Added nomobile option to shortcode to block the standard functionality of displaying month and week views as lists on mobile. This feature should only be used if you will be writing your own CSS to improve the cramped display of the grid on mobile. Basic instructions on how to do this are included on the admin page. Additional notes: 1) This feature involves a CSS change, so you may need to clear your cache before you will see the change on the front end of your site. 2) This is intended as a simple workaround option for the free version of the plugin. Additional views are planned for the upcoming pro version, including an enhanced mobile display option for month and week views.

4.0.2 – 2019.09.15

  • Fixed issue with jQuery on admin page that may have been conflicting with other plugins’ admin pages (e.g. Postie).
  • Skipped version 4.0.1 due to misnumbering error in previous update.

4.0.0.1 – 2019.09.13

  • Fixed issue with data-dow values not resetting to 0 on Sunday on fill cells at end of month view grid if site’s Start of week value is set to a day other than Sunday.
  • Updated “Tested up to” version to 5.2.3.

4.0.0 – 2019.09.12

Updates in this new version are primarily focused on preparing to support the new Pro version currently in development. The Pro version is designed as an add-on to the free version, so the free version will continue to receive ongoing enhancements and bug fixes.

  • Added conditional loading of ICS Parser library dependencies.
  • Added hooks to support Pro add-on.
  • Changed capabilities requirement to view admin page.
  • Reorganized admin navigation with dedicated menu item.

3.3.1 – 2019.09.09

  • Added startdate="today" option.
  • Modified logic for displaying color key, so it only appears if there are multiple calendars in the display.

3.3.0 – 2019.08.12

  • Refactored main ICS Parser call to pass date range restrictions into the parser rather than limiting the range after parsing, for better performance.
  • Updated ICS Parser library to version 2.1.13. This was done mainly to resolve a bug with how the previous version of the library (2.1.9) handled weekly recurrences with an interval greater than 1. (This version of the library reverts to allowing Carbon 1.3.9 or greater as well as 2.0 or greater; we have avoided Carbon version 2.0 due to its very large number of new dependencies causing instability in our builds.) We have not updated any of the dependencies.
  • Overhauled debugger output details and interface elements.
  • Additional notes on the experimental color attribute: You can hide or modify the Key that appears below the calendar using these CSS classes: .ics-calendar-color-key for the outer container; .ics-calendar-color-key-label for the word “Key” (not yet included in the translation files), and .ics-calendar-color-key-item for the color items themselves; use .ics-calendar-color-key-item[data-feed-key="n"] to alter individual items. (Replace “n” with the number of the item in the list, starting with 0.)
  • Added release dates to version number headers in readme.txt.
  • Hotfix: Fixed CSS so month/week grids always fill the container.
  • Hotfix: Fixed an issue that would cause the new debugger output to appear on all pages (for site admins only).
  • Hotfix: Changed date formats passed into new ICal::eventsFromRange() call from r to Y/m/d for better international compatibility.

3.2.2 – 2019.08.12

Note: This is a minor “housecleaning” update that does not add any new features or bug fixes.

  • File structure clean-up: split class-r34ics.php and functions.php out from main ics-calendar.php file.
  • Added Additional Resources links on admin page.
  • Swapped in new Room 34 logo.

3.2.1.1 – 2019.08.11

  • Fixed bug that would prevent fixed start dates from working if they are in the past.
  • Fixed minor logic issues with new experimental color attribute that may cause the color key to appear when no colors are set. (Note: The feature still currently supports an unequal number of calendars and colors, meaning some calendars might not have a color, or some colors may appear in the key even though they are not assigned to a calendar.) Also fixed issue that would prevent calendar names from appearing in the key if a color was not assigned to it.

3.2.1 – 2019.08.09

  • Added CSS word hyphenation to prevent long words from running outside day blocks in the calendar grid. This is especially important for text in German. (Previous versions just hid the overflow; we needed to turn on overflow: visible in 3.2.0 to allow the hover blocks that replaced tooltips.
  • Improved debugging messages.
  • Added scope to all properties of the R34ICS object.
  • Added experimental color attribute. This feature is not yet officially documented, but testing and feedback are welcome. Use color="#ffffff" or, if you have multiple URLs, enter multiple values in the color attribute, space-separated, and those colors will be applied in the same order as the URLs. You are setting the base color (the accent on the left edge). The highlight color behind the text is the same color with a 20% alpha transparency applied. (A full-featured color customizer tool is planned for inclusion in the upcoming Pro version.)

3.2.0 – 2019.08.06

  • Added “fixed week” capability (displaying an arbitrary date range up to 7 days) using the startdate and limitdays attributes.
  • Replaced tooltips on event hover with formatted HTML hover block.
  • Added function to apply make\_clickable() in descriptions only if they do not already contain HTML. This function also applies html\_entity\_decode() to all parsed string output, as well as applying nl2br() if make\_clickable() is being applied.
  • Changed “currentweek” view to “week” (retained “currentweek” for backwards compatibility).
  • Fixed logic sequence in loop to exclude out-of-range dates, for improved performance.
  • CSS refactoring. IMPORTANT CHANGE NOTE: If you have customized your CSS using the .eventdesc or .location classes, there is now a wrapper on those elements called .descloc; your customizations may need to be applied to that class instead.
  • Updated “Tested up to” to 5.2.2.

3.1.1 – 2019.06.24

  • Fixed issue in Firefox where calendar dropdown menu would not refresh if the page was reloaded.

3.1.0 – 2019.06.24

  • Added limitdays parameter to override default limit of 365 days.

3.0.0 – 2019.06.11

  • Added support for multiple calendars by including more than one URL, space-separated, in the url parameter. Known issue: Because the URLs are passed in together, any rules in other parameters will be applied to all calendars. This may present a problem if, for example, one calendar requires the tzignore parameter and another does not. These types of calendars should be considered “incompatible” at this time, and not combined into one display.
  • Miscellaneous refactoring.

2.3.0 – 2019.06.11

  • Added tzignore option to allow bypass of ICS Parser library’s time zone conversions, which fail in certain instances.
  • Added debugging option. (Requires Administrator role to view.)
  • Updated ICS Parser library to version 2.1.9. (Note: ICS Parser recommends updating the Carbon library as well, but the latest version adds a very large number of additional dependencies that make this plugin unstable.)

2.2.1.1 – 2019.03.17

  • Added workaround to issue where an Outlook ICS URL might return a “Found” HTML link instead of an actual ICS feed.
  • Added code for Block Editor (coming in version 3.0 — not yet functional).

2.2.1 – 2019.03.05

  • Added toggle attribute to allow for event description/location display to be toggled on/off by clicking an event title.

2.2.0.1 – 2019.03.05

  • Removed phone_only class from location information in list view.

2.2.0 – 2019.02.28

  • Modified transients to store parsed data instead of raw data, to improve performance for feeds with a large number of events.

2.1.4 – 2019.02.26

  • Fixed grid layout issues in month view if site’s Week Starts On value is set to a day other than Sunday.

2.1.3 – 2019.02.23

  • Fixed bug introduced in version 2.1.0 that prevented list view from displaying properly.

2.1.2 – 2019.02.22

  • Restructured logic for empty calendars so grid still displays when there are no events in a given period on month and current week views.

2.1.1 – 2019.02.21

  • Added “current week” as option in Add ICS Calendar editor button pop-up (Classic Editor only).
  • Fixed ampersand entities and escape backslashes in readme file.
  • Additional improvements to admin help page.

2.1.0 – 2019.02.21

  • Cleaned up FAQs.
  • Added new URL retrieval function that tries cURL and then falls back on file_get_contents.
  • Added full currentweek template with previous/this/next week selector. Deprecated currentweek option in favor of view="currentweek".
  • Added admin notice if allow_url_fopen is off and cURL is unavailable.
  • Added error handling if no ICS data was retrieved.
  • Improved layout of admin help page.
  • Minor refactoring.

2.0.5 – 2019.02.18

  • Added currentweek option to display just the current calendar week in the month grid style.

2.0.4 – 2019.02.04

(No updates — checked in new version number to correct issue with previous checkin.)

2.0.3 – 2019.02.04

  • Added object property for current plugin version.
  • Added current plugin version variable to enqueue stylesheet.

2.0.2 – 2019.02.04

  • Updated ICS loading to allow URLs using the webcal:// protocol. (Plugin automatically converts to https://.) Also updated instructions page to make it clearer that ICS URLs may not always have the .ics filename extension.
  • Updated CSS to allow any element to use the .phone_only class, not just tags. (Mainly affects the display of event descriptions in month view.)
  • Fixed issues with relative text sizes of various elements in month view.

Note: If your site was relying on the previous functionality, you can override the hidden .phone_only class by adding the following line of code in Appearance > Customizer > Additional CSS:

.ics-calendar .phone_only { display: initial; }

2.0.1 – 2019.02.04

  • Fixed issue where events would not appear in the calendar if the ICS feed entry does not contain a DTEND value.

2.0.0 – 2019.01.22

  • Added Add ICS Calendar button to editor with visual tools for inserting shortcode into page. Notes: 1) Currently works only with Classic Editor plugin or in WordPress versions before 5.0. 2) Admin interface not yet translated for internationalization, although the output on the page will be translated as usual.

1.5.8 – 2019.01.21

  • Fixed an issue with some recurring all-day events not displaying as all-day after the initial instance.

1.5.7 – 2019.01.21

  • Added location display option.
  • Refactored some variables.
  • Added support for additional field display on all-day events.

1.5.6 – 2019.01.18

  • Added user_agent string before retrieving the ICS calendar feed, to address an issue where some sites such as Airbnb might return a 403 Forbidden error.

1.5.5 – 2019.01.18

  • i18n: Added Finnish, Italian, Norwegian and Swedish translations. (Machine translations; may need some work. Please contact us with suggestions for improvement.)

1.5.4 – 2019.01.18

  • Added description display to month view on phone breakpoint.
  • CSS text formatting adjustments (improved text scaling on phones; removed letter-spacing).

1.5.3 – 2019.01.18

  • i18n: Fixed bug that caused day/date in list view to always display in English.
  • Added showendtimes option to always display the end time instead of only displaying on hover.
  • Added eventdesc option to show event descriptions, with an optional word count limit.

1.5.2 – 2018.12.28

  • i18n: Added Chinese (Simplified), Dutch, Greek, Hungarian and Japanese translations.

1.5.1 – 2018.12.28

  • Modified list view to only show events on or after the current date. (Previously showed all events for the current month, including past dates.)

1.5.0 – 2018.12.06

  • Added list view with related options.
  • Added option to hide times.
  • Modified display of non-“all day” events that span across multiple days for clarity.
  • Fixed issue with times displaying in GMT if ICS file is missing time zone offset information.
  • Fixed bug with title=”none” and description=”none” options.
  • Added a workaround for an unresolved issue that may cause All-Day events to appear between 9 AM and 10 AM instead of at beginning of day.
  • Updated transient to cache raw ICS file data instead of processed data; allowing modification of output without needing to force a reload of the ICS file from the server.

1.4.1 – 2018.11.19

  • Fixed translations that were not appearing properly.
  • Fixed bug in translation string format for multi-day events with start and end times.

1.4.0 – 2018.10.31

  • Refactored calendar loop to include months between the first and last month in the feed that do not have any events.
  • Replaced all calls to default PHP date() function with WordPress date_i18n() function to ensure proper formatting.
  • Added WordPress current_time() function to determination of today’s date to avoid time zone issues around midnight.
  • Fixed missing HTML tag when a feed returns no events.
  • Added ability to hide title and/or description with title=”none” or description=”none” in shortcode.
  • Added plugin icon.

1.3.0 – 2018.10.23

  • Added full i18n support.
  • Added these translations: German, English (Australia), English (United States), Spanish (Mexico), French, Portuguese (Brazil). (Note: All languages are machine-translated. Please contact us if you would like to assist in our translation efforts!)

1.2.1 – 2018.10.02

  • Added support for multi-day events. (Thanks to Henry Brink for identifying this issue and proposing a solution.)

1.2.0.1 – 2018.09.20

  • Updated readme file for clarity.

1.2.0 – 2018.09.20

  • Fixed time zone error that was overcompensating for site’s offset from GMT. (The included third-party ICS Parser library apparently double-applies the time zone offset when time zone data is present in individual events.)
  • Added support for WordPress “Week Starts On” setting.
  • Moved events’ end time from direct display into tooltip on hover over start time, for cleaner appearance.
  • Inserted tag after any slashes in event label output, to prevent run-on lines overflowing table cells.
  • Added date limit to avoid memory issues with very large calendars. Currently hardcoded to 365 days, but will be a configurable option in version 2.0.
  • Added partial support for translations. Full language support coming in version 2.0.

1.1.4 – 2018.08.22

  • Added missing CSS class to display day of week in grid on phone layout only.

1.1.3 – 2018.07.27

  • Added support for localized time format.
  • Removed debugging code that would display for administrators in version 1.1.2.

1.1.2 – 2018.07.27

  • Ran composer update to fix missing dependencies in ics-parser library.
  • Removed recurrence handling code that was no longer needed with ics-parser library updates.

1.1.1 – 2018.07.26

  • Added handling for all-day events.
  • Added handling of multiple events with same start date/time.
  • Fixed start/end time bug affecting feeds that don’t include the time zone in every event.
  • CSS improvements.
  • Updated ics-parser library to version 2.1.4.

1.1.0 – 2018.07.26

  • Added explicit cell widths to CSS.
  • Added donation option to admin page.
    • Fixed bug that would cause all event end times to be 12:00am.
  • Removed unnecessary use of .siblings() jQuery method on month select dropdown.

1.0.1 – 2018.05.15

  • Added handling for empty calendars.
  • Updated “Tested up to” version.

1.0.0 – 2017.05.31

  • Initial release version.