ICS Calendar

Changelog

11.5.10.1 – 2025.05.09

• Bug fix: Basic and List views now handle paginationposition="both" correctly.
• Improved error handling in r34ics_uniqid_url() function and R34ICS::shortcode_defaults_merge() method.

11.5.10 – 2025.05.02

• Actions and Filters:
  • Added actions to Month and Week view templates: r34ics_display_calendar_after_day_label and r34ics_display_calendar_after_events_list. As the names indicate, these actions allow for custom output after the day label and day events lists for each day in the table in these views. Hooked functions have access to four input parameters: $view, $args, $date and $day_events.

11.5.9.1 – 2025.04.28

• Modified r34ics_url_tester_result_debug hook to be able to account for situations where the response is empty.
• Vendors:
  • ics-parser: Changed timezone string mappings for “(UTC+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius” and “FLE Standard Time” from “Europe/Kiev” to “Europe/Helsinki”. This is because the ics-parser library uses the spelling “Kiev”, whereas ICS Calendar code uses the spelling “Kyiv”. This discrepancy was causing time calculation issues, specifically for Microsoft source calendars, which use the “FLE Standard Time” designation. “Europe/Helsinki” was chosen to avoid alternate spelling confusion, and also because “FLE” stands for “Finland Latvia Estonia”, making Helsinki a more logical choice than Kyiv. (Both cities share the same timezone rules.)

11.5.9 – 2025.04.24

• Added wp_get_remote() status check to System Report; refactored System Report to use transients.

11.5.8 – 2025.04.22

• Removed r34ics_ajax_bypass_nonce option. Nonce has now been removed from ICS Calendar AJAX requests altogether, as the requests do not have the ability to write to the database, making the nonce unnecessary. The nonce has consistently caused issues with AJAX requests in conjunction with third-party caching plugins.
• CSS tweaks on admin page.
• i18n:
  • Removed disused translation strings.
  • Removed Norwegian Nynorsk translation files, due to consistent issues with Poedit machine translations.

11.5.7.1 – 2025.04.11

• Bug fix: Added exception handling to prevent a fatal error if r34ics_date() is passed a timezone string that is not a valid format recognized by the PHP DateTimeZone class.
• Bug fix: Removed extraneous pagination close tag in list view that may cause the pagination HTML to break if the last item on a “page” is a multi-day event.
• Changed scope of special date range handling in week view.

11.5.7 – 2025.03.07

• Modified activation process to jump directly to Getting Started tab of admin page.
• Redesigned Getting Started tab and sidebar of admin page.
• i18n: Updated translation files, added missing text strings.

11.5.6.1 – 2025.03.06

• Updated help text on Settings page.

11.5.6 – 2025.02.26

• Added none as a valid option for the monthnav parameter, allowing for hiding the month navigation altogether. (Useful when showing month view in a kiosk environment or other settings where the user doesn’t need the ability to switch the view to a different month.)
• Bumped ‘tested up to’ to 6.7.2.

11.5.5 – 2025.02.24

• Added support for using HTML color names in the shortcode, in addition to hex colors, via the new r34ics_color_name2hex() function.

11.5.4.2 – 2025.02.18

• Made calls to php_uname() in System Report conditional; some servers may remove support for this function for security reasons. Also replaced call to phpversion() with PHP_VERSION constant, with a conditional in case the constant is undefined. These changes should resolve issues where the ICS Calendar admin page does not load properly on servers with these security measures in place.
• Updated copyright terms regarding ICS Calendar name and branding assets.

11.5.4.1 – 2025.02.10

• Refactored r34ics_date() to use wp_date() after applying its offset and other input standardizations, rather than duplicating the code of wp_date(). This also resolves an issue where in some rare cases, the passed-in timezone may not be handled correctly.
• Added missing event timezone inputs to r34ics_date() calls in the R34ICS::event_description_html() method and r34ics_multiday_date_label() function. Without timezones, date ranges for multi-day events could be one day “off” in the event descriptions and labels after the aforementioned refactoring of r34ics_date().
• Fixed incorrect date display issues in R34ICS::event_description_html(). Note: Version 11.5.4 was withdrawn due to this issue, which was discovered a few minutes after its release.
• Modified event sorting for multi-day events starting on the same date. Now, list-style views (list, basic) will show these events sorted by earliest ending date. Table-style views (month, week), will show the events sorted by the latest ending date, which helps to reduce situations where events “break” between days in the layout when using combinemultiday.

11.5.3.2 – 2025.02.07

• Bug fix: Resolved possible fatal error caused if new r34ics_i18n_locales() function added in 11.5.3.1 runs on a logged-out front-end page.

11.5.3.1 – 2025.02.06

• Fixed bug with reverse and pagination on Basic and List views that would cause the wrong “page” to display on load.
• i18n: Updated translation strings. Added logic to force the plugin’s embedded translation files to take precedence over any downloaded community translation files in the WP_LANG_DIR/plugins directory.

11.5.3 – 2025.02.03

• Fixed issue with pagination in list view that would include the next single-day event(s) on a “page” when a multi-day event was the correctly counted “last” item on the page.
• Modified handling of pagination="1" in Basic and List views, to literally mean 1 event, rather than being interpreted as a boolean “true” and defaulting to 5 events per page. Setting pagination="true" will still default to 5 per page. List view also now omits the month/year headers when displaying one event per page.
• Modified handling of count and pagination parameters to force positive integer values.

11.5.2.1 – 2025.02.03

• Added r34ics_comparison_string() function to process strings for comparison purposes. Used by features added to R34ICS::r34ics_display_calendar_exclude_event() in 11.5.2 to filter events by category, accounting for possible formatting issues with accented letters.
• Modified shortcode logic to force certain parameter values to all-lowercase. This allows the input values to be case-insensitive; previously, non-lowercase values would be treated as invalid. Applies primarily to parameters that have defined arrays of accepted values, e.g. columnlabels or extendmultiday.

11.5.2 – 2025.01.31

• Added category attribute to allow filtering events by category. Multiple categories may be included, using the pipe character | as a delimiter. Category names used must exactly match the category names in the feed (case-insensitive). Currently this feature simply excludes events that are not in one of the designated categories. A future update will add support for color-coded categories, similar to the current support for multiple feeds in one calendar shortcode. Note: This feature requires that your ICS feed data includes the CATEGORIES property, which is not widely supported by most popular calendar software.

11.5.1.3 – 2025.01.22

• Modified logic for maskinfo that would remove the info hover box on multi-day events with specified start and end times.

11.5.1.2 – 2025.01.20

• Miscellaneous:
  • Added r34ics_ajax_bypass_nonce status to System Report.

11.5.1.1 – 2025.01.08

• Bug fixes:
  • Added logic to trim extraneous spaces from the beginning and end of all attribute values when parsing the shortcode, and in sanitization logic in r34ics-ajax.php.
  • Added r34ics_color_key_allowed() function and updated r34ics_select_allowed() to merge custom allowed fields with wp_kses_allowed_html('post'). This resolves issues with the color key (legend) that were introduced with changes in v. 11.5.0 and 11.5.1.
  • Changed r34ics_minify_css() handling of whitespace to resolve issues when output is fed through wp_kses_post().
  • Fixed duplicate description output that may result with ALTREP handling introduced in 11.5.1.
  • Fixed handling of feed parsing failures that would cause a fatal error unless the debug parameter is set in the shortcode.

11.5.1 – 2025.01.07

• Functional enhancements:
  • Added protected R34ICS::_event_field_handling() method to facilitate complex logic (i.e. too much to fit in one line of code) when assigning values in the $event_item array in R34ICS::display_calendar() and related functions. This includes the new r34ics_event_field_handling filter for additional external processing of event data. (If working with the filter, be aware that it is currently only applied to the eventdesc value.) This functionality was specifically added to accommodate changes needed for the ALTREP property described below, but it is open-ended to support additional future enhancements.
• iCalendar spec support:
  • Added limited support for Thunderbird’s use of the ALTREP parameter in event descriptions. Thunderbird does not appear to conform to the spec — the ALTREP value is not wrapped in quotation marks. However, since this is our first observation of ALTREP in use, our solution is tailored to the Thunderbird output we have observed. Additional feedback on this feature is welcomed.
• PHP deprecation notices:
  • Modified the event_description_html(), event_label_html() and event_sublabel_html() methods of R34ICS to return empty strings rather than null or false values when empty.
  • Added ?: '' empty string fallback value to all instances of wp_kses_post() added in version 11.5.0, to work around “Deprecated: preg_replace(): Passing null to parameter #3 ($subject) of type array|string is deprecated” warnings. This should technically be addressed within the WordPress core wp_kses_no_null() function. We have opened a Trac ticket. If the core function is modified to handle null values, the then-superfluous ?: '' will be removed from these function calls in a future update.

11.5.0 – 2025.01.03

• i18n:
  • Added translators: comments for each translation string containing placeholders.
  • Changed text domain from r34ics to ics-calendar to conform with WordPress Plugin Directory requirements. Translation files included within the plugin have been correspondingly updated, but if you are using third-party translations or a plugin such as Say What, you may need to update them with the new text domain.
  • Replaced %s translation string placeholders with %1$s.
  • Replaced uses of unescaped _e() and __() functions with the corresponding escaped functions esc_html_e(), esc_html__(), esc_attr_e() and esc_attr__(), as appropriate.
  • Updated all translation files to reflect the above changes.
• Miscellaneous:
  • Added extra sanitization functionality to handling of form inputs on Settings page and r34ics-ajax.php.
  • Added text escaping functions to dynamic plugin output in templates.
  • Added r34ics_select_allowed() function.
  • Fixed CSS padding issue with week numbers in month and week views.
  • Replaced uses of certain standard PHP functions such as json_encode(), mt_rand(), parse_url() and strip_tags() with their WordPress-specific equivalents (e.g. wp_json_encode(), wp_rand(), wp_parse_url() and wp_strip_tags()).
  • Updated handling of server variables in System Report.
• Vendors:
  • Updated embedded ics-parser library to version 3.4.1 (with namespace change to prevent plugin conflicts, and removal of variables from error messages due to Plugin Check reporting them as coding errors).

Full Changelog

Changelog truncated here due to WordPress repository requirements. Please see changelog.txt for older logs.