Simple Calendar - Google Calendar Plugin

• Display events from any public Google Calendar.
• Keep managing events in Google Calendar. No need to create events in WordPress.
• Out-of-the-box designs that match your theme’s look and feel.
• Fully responsive and mobile-friendly monthly grid and list views.
• Customize event content display using simple tags. No coding required.
• Combine multiple calendars into single displays explicitly or using categories.
• Intuitive, simple display configuration changes for fine tuning.
• Advanced settings to adjust time zones, date/time formats and start of the week.
• Integration with Event Calendar Newsletter for quickly turning your events into a newsletter-friendly format.
• Additional functionality offered with add-ons.
• Translations available with more being added on a regular basis. Translations welcome!
• Open source with code hosted on GitHub. Contributions welcome!

Love using Simple Calendar? Consider purchasing a Premium Add-on

• Week and day views added alongside the month view.
• Display event titles and start times directly on your calendar.
• Faster load times when navigating through months, weeks or days.
• Configure header navigation buttons to allow site visitors to easily switch between views.
• Intuitive design for multi-day events.
• Customizable calendar heights with optional scroll bars.
• Set default start time for week and day views.
• Limit display times for week and day views.
• Works with our Google Calendar Pro add-on to display color-coded events within each view.
• Priority email support with a 24-hour response time during weekdays backed by a top-notch team.

• Display events from both private and public Google Calendars.
• Highlight events with colors that match assigned Google Calendar event colors.
• Display attendee names, avatars and RSVP status for any private or public event.
• Display event organizer information.
• Display a list of attachments with links to their original source.
• Secure connection established between your site and Google using the OAuth standard.
• Works with our FullCalendar add-on to display beautiful month, week and day views with color-coded events.
• Priority email support with a 24-hour response time during weekdays backed by a top-notch team.

Get ALL these features with our Premium Add-ons

• Fix: Namspace conflicts with other plugins and composer libraries. Huge shoutout to @mickwall001 on github for this.

• Fix: Get rid of empty needle PHP warning

• Dev: Tested up to WordPress 5.6
• Fix: OR searches will now work as OR, not as AND
• Fix: Revert Guzzle to < 7.x version to avoid conflicts (temporary)

• Fix: Trimmed overall size of the plugin to reduce errors from installation failing.
• Dev: Updated minimum PHP requirement to 7.3
• Dev: Updated all vendor packages to latest versions.
• Dev: Tested up to WordPress 5.5.1

• Fix: Undefined index error when saving calendar.
• Fix: Updated Carbon library to latest version.
• Fix: Update date check on list view to remove PHP deprecated warnings.
• Dev: Tested up to WordPress 5.4.2

• Feature: Automatically sort events with the same day and time alphabetically.
• Fix: Issue with jQuery not being added as a script dependency.
• Fix: Updated google/apiclient to ^2.0 to fix Gmail conflicts with other SMTP plugins.
• Security: Updated dependencies.

• Reverted codebase to 3.1.22 version to skip recent update that has an error.

• This bumps the version number but is the same code as 3.1.20 so plugins can auto update to the fixed version.

• Dev: Add the "simcal_post_type_registration_args" filter to allow changes to the calendar post type registration arguments.

• Fix: Issue with moment.js not being available/throwing JS errors.

• Dev: Add filter "simcal_additional_link_attributes" to facilitate additional event link attributes.

• Fix: Issue with calendar settings not saving.

• Fix: Issue with slow loading admin settings page.

• Fix: Issue with jQuery $.ajax call parameter compatibility with older versions of jQuery.
• Fix: Issue with Google API feed sorting not showing correct events in list view.
• Fix: Issue with duplicate default calendar JSON data being output.

• Fix: Issue where navigation to next month would be disabled when multi-day events extended to future months.

• Fix: Issue where calendar event pop-ups would display without content.

• Backwards Compat: Restored previous version (v1) of Google API Client lib to support older versions of PHP.
• Fix: Fixed bug present in PHP 7.2 which was causing fatal errors.

• Fix: Bump required PHP version to match 3.1.11 requiring PHP 5.5 so site's running older versions don't crash when updating.

• Dev: Update Google API Client libraries to v2. NOTE: Version 5.5+ for PHP now required.
• Fix: Default calendar list view not showing pro calendar coloring when Calendar Settings > Appearance > Limit Visible Events is set.

• Fix: Fixed an issue where Google Calendar API key sometimes wouldn't save on the settings page.
• Feature: Allow administrators to set spacing within the datetime separator under individual advanced calendar settings.
• Tweak: Add the updated separator to the end date for multi-day events for consistency. i.e. if separator is " @ ", multi-day events date/time would display similar to "August 27 2017 @ 10:00 am-September 04 2017 @ 11:00 am" on tooltip or list view.

• Feature: Add [if-today] and [if-not-today] event template tags. Props @followfung
• Fix: List view incorrectly shifts events between 12 & 1am, or all day events, to previous day.
• Fix: Navigation disabled incorrectly in some cases.
• Dev: System report tweaks for PHP 7 compatibility.
• Dev: Tested up to WordPress 4.7.

• Fix: Multi-day events should not show duplicate events in one day in some time zones.
• Fix: List view heading dates corrected for some time zones.
• Fix: Grid view starting month corrected for some time zones.
• Fix: Remove duplicate "Event source default" option when add-on enabled.
• Tweak: Set "Expand multi-day events" default value to "No, display only on first day of event".

• Fix: Add month/day/time translations back in that stopped working after 3.1.5.

• Fix: Account for events without an end date/time when using the [when] tag.

• Fix: Multi-day events in the future should now display first day of event when selecting "No, display on all days of event up to current day".
• Fix: Correct dates in day headings in list view being off for some time zones.
• Tweak: Clearer warning about using timezone setting "Event source default".
• Dev: Added filters to add your own custom event template tags. Props @Brummolix
• Dev: Remove all calls to date_default_timezone_set() due to the way WordPress core sets it to 'UTC' to calculate offsets from there.

• Fix: "Add to Google Calendar" link now uses source calendar's timezone (except for all-day and UTC timezone events).

• Feature: Added "Add to Google Calendar" link event template tag.
• Fix: Corrected all structured data/schema.org output errors caught by Google's structured data testing tool.
• Fix: Default colors specified for today and events with days should now work even when colors blanked out.
• Dev: System report tweaks for PHP 7 compatibility.
• Dev: Sass 3.4 compatibility.
• Dev: Move load_plugin_textdomain call to plugins_loaded hook. Not needed with WP 4.6+.

• Fix: Multi-day events do not stop short a day.
• Fix: Events that end at midnight no longer duplicate on the next day.
• Fix: Header shows correct date in list view when there are no events to show.
• Tweak: Tightened up security a bit.
• Dev: Tested up to WordPress 4.6.

• Fix: Correct all-day events displayed in multiple days in some cases.
• Fix: Paging navigation links now hidden when no more events exist past the current page in list view.
• Tweak: "Powered by Simple Calendar" author credit opt in moved to individual per calendar settings.

• Fix: qTips arrow should line up with events more accurately.
• Fix: Cache interval will now update correctly when saved.
• Fix: Mobile-view bullet colors now show custom event colors when used with the Google Calendar Pro add-on.
• Fix: [id] event builder code now just returns the event ID.
• Feature: Added new template tag [ical-shortcode] to return the iCal ID.
• Dev: Switched to set version of qTip library instead of latest release for compatibility issues.
• Dev: Duplicate dropdowns when adding a custom view are now handled properly with JS.

• Fix: Multiple events at the same time on a grouped calendar should now show correctly.
• Fix: PHP notice when adding a new calendar should no longer appear.
• Fix: Issues with Carbon fatal error should not happen.
• Dev: Tested up to WordPress 4.5.

• Fix: Timezone issues with event source option should now work correctly.
• Fix: Tooltips should no longer be empty after a resize.
• Tweak: Removed event source option for grouped calendars.
• Tweak: Allow other plugin or theme shortcodes to be used in the event template.
• Dev: Removed Browser.php from composer so we can use it standalone with customizations.
• Dev: Constructor for Browser.php now compatible with future versions of PHP.
• Dev: Removed PHP 5.2 compatibility code.

• Fix: Updated schema to pass W3C validation. Props @martinburchell
• Fix: Search queries using quotes should now work as expected. Props @justdave
• Fix: Better character encoding for small screen mode characters. Props @witchdoktor
• Fix: Events that start at 12 A.M. will now display correctly. Props @TaylorHawkes
• Fix: Corrected PHP error when removing first recurring event. Props @petersonca
• Fix: Max number of events should no longer refresh to 2500 on change.
• Fix: Default cache interval should now display correctly.
• Fix: Custom date should now show correct month when set to the first of a month.
• Fix: Visual editor is available again when editing event template tags.
• Tweak: Updated default event template tags formatting.
• Tweak: Added an edit calendar link.
• Tweak: Updated how the timezone is handled for calendars. Also fixes an issue with imported calendars.
• Dev: Corrected PHP notice showing in media gallery grid view. Props @Daronspence
• Dev: Added filters to give control over the grid view paging columns. Props @thoronas
• Dev: Updated imagesloaded library to 4.1.0.

• Tweak: Lists that start on a custom date will start at the beginning of the day now.
• Tweak: Make it so grouped calendars are properly sorted by event time.
• Tweak: Updated option for controlling multi-day events.
• Tweak: Allow line breaks from Google calendar description to persist if not using the html attribute.
• Tweak: Updated text output for human date times.
• Fix: Multi-day events that span over to the first day of the month should now show correctly.
• Feature: Added dropdown option on how to handle line breaks and paragraphs for the event template tags.
• Dev: Removed WP Requirements from Composer.
• Dev: Removed always enqueue and disable scripts options so scripts will load automatically on every page.

• Fix: All-day events on the first day of the month will now show up correctly.
• Fix: Calendar start dates using a variable number will now start on the correct date.
• Fix: Disable scripts and disable styles advanced options should now work as intended.
• Tweak: Added "before" and "after" text for human date event builder codes.
• Dev: Added jquery.qtip.min.map file to vendor assets.

• Fix: Custom date and time format settings should no longer override everything else when not selected.
• Fix: Limiting description with HTML tags should now work better.
• Fix: Events from different calendars not showing on a grouped calendar should display properly now.
• Fix: Grouped calendars will now clear the cache of all attached calendars.
• Fix: Cache was requiring a manual clear sometimes and should now work automatically.
• Dev: Updated CSS class for [start-location] and [end-location] tags.
• Tweak: Updated date and time preview to show properly escaped values.

• Fix: Pagination tweak to prevent grouped calendars from getting cut off by last calendar in list.
• Fix: Welcome screen now shows up correctly after a fresh installation.
• Fix: i18n short day names should now display properly.
• Fix: i18n truncated event titles should now display properly.
• Tweak: Allow setting a cache duration of 0.
• Tweak: Pagination will now always show unless the calendar is static.
• Tweak: Allow responsive grid view to use hover option.

• Fix: Fixed all-day events with an end time showing on an extra day.
• Fix: Fixed a bug with site default timezone setting not pulling in correctly.
• Tweak: Make always enqueue option enabled by default for new installs.
• Tweak: Translations moved from .po/.mo files to official wordpress.org translation packs.
• Tweak: Minor text fixes to admin UI.

• Fix: Fixed bug for Google Calendar Pro add-on organizer event builder code.
• Fix: Fixed some inconsistencies with all-day events and multi-day events when combined.

• Fix: Fixed all day multi-day events showing on an extra day.
• Fix: Fixed multi-day events that span less than 24 hours to show up on both days.
• Fix: Fixed multi-day events that span 2 days to show up correctly.
• Fix: Fixed issues with grouped calendars using categories not loading.
• Tweak: Additional empty check for previous array_combine PHP error.
• Tweak: Remove extra qtip triangle image from popup.

• Fix: Fixed bug with days being off by one day.
• Fix: Added check for array to avoid array_combine() PHP error.
• Fix: Allow last list event to show correctly.
• Tweak: Update shortcode to not check for a singular page.

• Fix: Fixed a bug where HTML in event description was not being rendered properly.
• Fix: Fixed a script loading issue when using the CPT view.
• Feature: Check for required PHP extensions upon plugin activation (curl and mbstring so far).

• Fix: Fixed always enqueue option to work correctly.
• Fix: Fixed issue where multiple shortcodes would sometimes not load scripts correctly.
• Fix: Fixed z-index issue for admin tooltips.
• Tweak: Change default "today" color to blue (#1e73be).

• Feature: Added option to display a compact list view.
• Feature: Added option to hide the header in list view.
• Tweak: Improved CSS styling for default list and grid CSS.

• Fix: Fixed bug where calendar days were off by one day.

• Fix: Fixed bug with update script being skipped via attachment to activation hook.

• Announcement: Plugin renamed to Simple Calendar.
• Announcement: Visit our new website at simplecalendar.io!
• Feature: Modular and extensible plugin, add-ons ready.
• Feature: Reworked default calendar views, now fully responsive (and titles in grid).
• Feature: Completely redesigned the admin user interface.
• Feature: Many new settings panel in admin dashboard, with better semantics and organization.
• Feature: A System Report page to help you troubleshoot problems and improve support response.
• Tweak: Use categories to organize your calendars.
• Tweak: Feeds moved from 'gce_feed' to 'calendar' post type slug, permalink change.
• Fix: Timezones handling are more accurate.
• Fix: Incompatibilities with themes and other plugins.
• Fix: Several other bugfixes.
• Refactor: Plugin rebuilt from ground up: namespaces, closures, Composer support, entirely OOP.
• Dev: PHP 5.3 minimum required.
• Dev: All requests to Google from now on will be handled with the official Google API PHP Client.
• Dev: Tested up to WordPress 4.4.

• Announcement: Simple Calendar is coming, changes ahead.
• Deprecation: The bundled/default Google API key reached it's quota and was shut off. Using your own API key is now required.

• Fix: Bug in HTML support in events description.

• Fix: Fallback for DateTime::setTimestamp() for installations still using PHP 5.2.
• Fix: Support HTML in events description when using html="true" attribute in shortcode.
• Localization: Added Finnish translations, courtesy of Ville Myllymäki.

• Fix: Improve timezone handling when sending a request to Google.
• Tweak: Reintroduced imagesloaded library to improve compatibility with themes using Isotope and Masonry.

• Fix: Calendar not working correctly with custom date range grid after 2.2.9 changes.

• Fix: Event links pointing to Google Calendar have a timezone argument from feed setting.
• Fix: Improved assets loading, only load scripts on posts and pages that have a calendar.
• Localization: Updated Norwegian translations.

• Fix: Improved security when saving plugin settings.
• Fix: Added URL encoding to fix some issues with API keys containing special characters.
• Tweak: Use calendar feed timezone or website timezone (default calendar).

• Feature: Added an 'Add Calendar' button to quickly add a shortcode in posts.
• Fix: Reverted register scripts hook to init.
• Localization: Updated French translations.
• Tweak: Flush permalinks on plugin activation and deactivation.
• Tweak: Added [if-not-location] event builder conditional shortcode.
• Tweak: Added a 'gce_no_events_message_text' filter when no events are found.
• Tweak: Added a clear cache bulk action for clearing caches of multiple feeds.

• Plugin performs a requirements check to ensure users are running a recent version of WordPress.
• Added '.gce-has--events' class to count events in each day in grid display.
• Removed unnecessary imagesLoaded JS library (optional dependency of the qTip2 library).
• Fixed a bug with the start month of the custom date range grid view.
• Fixed a bug with backslashes in date ant time custom format inputs.
• Fixed scripts and styles loading issues.
• Fixed bugs when custom date range values were left blank.
• Added Russian translation provided by Vadim Reutskiy.
• Added Swedish translation provided by Familjedaghemmet Chicos.
• Tested up to WordPress 4.3.

• Updated calls to add_query_arg to prevent any possible XSS attacks.
• Fixed bug with fatal error in rare cases by rearragning order of plugin file includes.
• Fixed bug with navigation links sometimes returning -1.
• Corrected typo with paging links title attributes.

• Updated French translation files.
• Fixed Catalan translation files.
• Fixed encoding bug with [maps-link] new window attribute.

• Fixed bug with the "More details..." link encoding.
• Added note about total event limit of 2,500 now enforced by the Google Calendar API.
• Updated earliest feed event date default to 1 (one) month back.
• 0 (zero) value now allowed for earliest and latest feed event dates (sets them to the current date).
• Minor public script improvements.
• Added Brazilian Portuguese translation files.
• Updated jQuery UI datepicker CSS CDN reference for feed settings pages.
• Tested up to WordPress 4.2.

• Option to always enqueue scripts & styles now enabled by default.

• Added option to always enqueue scripts and styles on every post and page.
• Added custom date range grid option to display modes.
• Added option to disable the plugin CSS file.
• Fixed bug with list intervals.
• Fixed bug with event list showing past events.
• Minor public JavaScript performance updates.

• Enqueue scripts & styles on all posts & pages temporarily until better detection can be put in place.
• Fixed GCal ID encoding in feed settings.
• Updated Italian translation.
• Updated French translation.

• Added custom date range options.
• Added option to hide tooltips on grid display.
• Added additional save button at the bottom of the feed settings.
• Performance updates to script enqueues.
• Updated Catalan translation files.
• Updated list output logic.
• Fixed bug with multi-day events sometimes not showing up in list view.
• Fixed bug with calendar ID field not getting encoded.
• Fixed bug with tooltips scrolling on mobile.
• Fixed bug with Google Hangout event links.
• Fixed bug with widget settings not being unique.
• Widget UI enhancements.
• Feed settings UI enhancements.
• Error messaging updates.
• Security improvements.

• Restructured next and back paging navigation script.
• Updated Italian translation files.

• More tooltip (qTip2) effects & styling.

• Fixed bug with tooltip (qTip2) in some cases by now including it's imagesLoaded script.
• Tooltip style improvements.
• Tooltip minified JS map file now included.
• Updated French translation.
• Updated Lithuanian translation.
• Fix bug with grouped-list multi-day event title.
• Fix bug when saving a bulk edit.

• Updated jQuery tooltip library to qTip2. Previously using unmaintained original qTip library.

• Reverted CSS enqueue change.
• Added Catalan translation - Provided by Toni Ginard & Monica Grau of agora.xtec.cat.
• Updated AJAX security code.
• Fixed bug with calendar ID field not trimming extra spaces.
• Updated French translation - Pull Request by @Jojaba
• Tested up to WordPress 4.1.

• Only load plugin scripts and stylesheets when the viewable page is rendering output from this plugin.
• Fixed bugs with simple display options.
• Added better error checking and output options to help in debugging GCal feeds.
• Added Dutch translation - Provided by Henri van Werkhoven.

• Fixed bug with quick edit clearing out feed settings.
• Fix bug with pagination creating extra DOM elements.
• Localization string fixes - Pull Request by @Jojaba
• Added HTML to group events of the same day semantically - Pull Request by @martinburchell
• Fixed bug with [cal-id] event builder code.
• Add in post data resets.

• Fixed bug with all day events not displaying.
• Added missing timezone parameter to internal query.

• Updated to use Google Calendar API version 3. Version 2 deprecated on Nov. 17, 2014.

• As of Nov. 17, 2014 the GCal API v2 is deprecated, which breaks all calendar feed displays. This update will temporarily hide the display while we work on a solution that uses GCal API v3.

• Events will now display if it hasn't ended yet for list views.
• Fixed bug with date() call causing a display error in some cases.
• Fixed bug with with widget tooltip text display.
• Added cache clearing on upgrade.
• Added filters for Previous and Next link text.
• Internationalization and language file updates.
• Simplified text domain function.
• Added Lithuanian translation - Provided by Andrius Mazeika of mazeika.info.

• Reverted previous bug fix that introduced new bugs.

• Added Polish translation - Provided by Michał Pasternak of iplweb.pl.
• Updated Italian translation.
• Updated French translation.
• Fixed bug with date() call causing a display error in some cases.
• Minor bug fixes.

• Added minimum and maximum feed date options to fix event display issues and boost performance.
• Fixed a caching issue to increase performance.
• Fixed bug where backslashes kept getting added to event titles that already contained single quotes when navigating through pages in widget.

• Fix timezone issue.

• Fixed display bug with event date and grouped lists.
• Fixed broken paging links when feed IDs contain spaces between them.
• Fixed bug with start offset and grouped lists not working properly.
• Fixed bug where clear cache link was showing on any type of CPT.
• Added German translation - Provided by Stefanie Drucker of kreativhuhn.at.
• Added Norwegian translation - Provided by Tore Hjartland of aliom.no.

• Added option to show/hide paging.
• Added option to limit display to any number of days or events per page.
• Added option to set the start date offset any number of days back or ahead (list view).
• Removed retrieve events from/until options now that display limit options will be used.
• Removed max number of events to retrieve option.
• Added shortcode attribute 'paging'.
• Added shortcode attribute 'interval'.
• Added shortcode attribute 'interval_count'.
• Added shortcode attribute 'offset_interval_count'.
• Added shortcode attribute 'offset_direction'.
• Updated shortcode 'display' attribute to allow a value of 'grouped-list'.
• Date no longer shows up for the title (list view).
• HTML restructured to use div tags instead of an unordered list (list view).
• Nav bar HTML (Back/Next links and month title) restructured to use div tags instead of span and percentages.
• Moved clear cache button and changed style.
• Added Italian translation - Provided by Francesco Paccagnella of pacca.it.
• Added French translation - Provided by Vincent Bray.
• Fixed PHP error during upgrade.
• Fixed cross-site scripting (XSS) vulnerability.
• JavaScript restructured to fit more in line with best practices.
• Remove unused admin script file.

• Fixed bug where retrieve from/until dates were accidentally removed.

• Fixed bug where calendar feed caches weren't getting cleared properly.
• Fixed feed settings metabox content wrapping issue.

• Added Spanish translation - Provided by Eduardo Larequi of educacion.navarra.es/web/pnte/.
• Fixed timezone issues by forcing calendar feeds to use the timezone selected in the site's General Settings. Feed-specific timezone setting removed.
• Fixed a bug with recurring events display.
• Fixed an upgrade bug with multiple day events.

• Fixed display errors with certain event builder shortcodes.
• Added language folder.

• Plugin rewritten from scratch.
• Now using custom post types for storing and customizing Google calendar feeds.
• Introduced the shortcode [gcal] (old shortcode still supported).