448 lines
17 KiB
Plaintext
448 lines
17 KiB
Plaintext
=== Google Calendar Events ===
|
|
Contributors: pderksen, nickyoung87, nekojira, rosshanney
|
|
Tags: google calendar, google, calendar, events, gcal
|
|
Requires at least: 3.9
|
|
Tested up to: 4.3
|
|
Stable tag: 2.2.6
|
|
License: GPLv2 or later
|
|
License URI: http://www.gnu.org/licenses/gpl-2.0.html
|
|
|
|
Parses Google Calendar feeds and displays the events as a calendar grid or list on a page, post or widget.
|
|
|
|
== Description ==
|
|
|
|
Parses Google Calendar feeds and displays the events as a calendar grid or list on a page, post or widget.
|
|
|
|
= Features =
|
|
|
|
* Parses Google Calendar feeds to extract events.
|
|
* Displays events as a list or within a calendar grid.
|
|
* Events from multiple Google Calendar feeds can be shown in a single list / grid.
|
|
* Lists and grids can be displayed in posts, pages or within a widget.
|
|
* Options to change the number of events retrieved, date / time format, cache duration, etc.
|
|
* Complete customisation of the event information displayed.
|
|
* Calendar grids can have the ability to change the month displayed.
|
|
|
|
[Plugin Documentation & Getting Started](http://wpdocs.philderksen.com/google-calendar-events/?utm_source=wordpress_org&utm_medium=link&utm_campaign=gce_lite)
|
|
|
|
###Updates###
|
|
|
|
* [Get notified when new features are released](http://eepurl.com/0_VsT)
|
|
* [Follow this project on Github](https://github.com/pderksen/WP-Google-Calendar-Events)
|
|
|
|
This plugin was originally created by [Ross Hanney](http://www.rhanney.co.uk), a web developer based in the UK specialising in WordPress and PHP.
|
|
|
|
## Available Translations ##
|
|
|
|
* Spanish - Provided by Eduardo Larequi of [educacion.navarra.es/web/pnte/](http://www.educacion.navarra.es/web/pnte/).
|
|
* Italian - Provided by Francesco Paccagnella of [pacca.it](http://www.pacca.it/).
|
|
* French - Provided by Vincent Bray.
|
|
* German - Provided by Stefanie Drucker of [kreativhuhn.at](http://www.kreativhuhn.at/).
|
|
* Norwegian - Provided by Tore Hjartland of [aliom.no](http://www.aliom.no/).
|
|
* Polish - Provided by Michał Pasternak of [iplweb.pl](http://iplweb.pl/).
|
|
* Lithuanian - Provided by Andrius Mazeika of [mazeika.info](http://mazeika.info/).
|
|
* Dutch - Provided by Henri van Werkhoven.
|
|
* Catalan - Provided by Toni Ginard & Monica Grau of [agora.xtec.cat](http://agora.xtec.cat/).
|
|
* Russian - Provided by Vadim Reutskiy.
|
|
* Swedish - Provided by Familjedaghemmet Chicos of [chicos.nu](http://www.chicos.nu/).
|
|
|
|
== Installation ==
|
|
|
|
There are three ways to install this plugin.
|
|
|
|
= 1. Admin Search =
|
|
1. In your Admin, go to menu Plugins > Add.
|
|
1. Search for `Google Calendar`.
|
|
1. Find the plugin that's labeled `Google Calendar Events`.
|
|
1. Look for the author name `Phil Derksen` on the plugin.
|
|
1. Click to install.
|
|
1. Activate the plugin.
|
|
1. A new menu item `GCal Events` will appear in the main menu.
|
|
|
|
= 2. Download & Upload =
|
|
1. Download the plugin (a zip file) on the right column of this page.
|
|
1. In your Admin, go to menu Plugins > Add.
|
|
1. Select the tab "Upload".
|
|
1. Upload the .zip file you just downloaded.
|
|
1. Activate the plugin.
|
|
1. A new menu item `GCal Events` will appear in the main menu.
|
|
|
|
= 3. FTP Upload =
|
|
1. Download the plugin (.zip file) on the right column of this page.
|
|
1. Unzip the zip file contents.
|
|
1. Upload the `google-calendar-events` folder to the `/wp-content/plugins/` directory of your site.
|
|
1. Activate the plugin through the 'Plugins' menu in WordPress.
|
|
1. A new menu item `GCal Events` will appear in the main menu.
|
|
|
|
== Frequently Asked Questions ==
|
|
|
|
[Plugin Documentation & Getting Started](http://wpdocs.philderksen.com/google-calendar-events/?utm_source=wordpress_org&utm_medium=link&utm_campaign=gce_lite)
|
|
|
|
== Screenshots ==
|
|
|
|
1. Grid display in full page with tooltip
|
|
1. Grid display in widget
|
|
1. List display in widget
|
|
1. Simple display options
|
|
1. Calendar feed settings
|
|
1. Calendar widget settings
|
|
1. Event display builder editor
|
|
|
|
== Changelog ==
|
|
|
|
= 2.2.6 - July 16, 2015 =
|
|
|
|
* Plugin performs a requirements check to ensure users are running a recent version of WordPress.
|
|
* Added '.gce-has-<n>-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.
|
|
|
|
= 2.2.5 - April 22, 2015 =
|
|
|
|
* 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.
|
|
|
|
= 2.2.4 - April 6, 2015 =
|
|
|
|
* Updated French translation files.
|
|
* Fixed Catalan translation files.
|
|
* Fixed encoding bug with [maps-link] new window attribute.
|
|
|
|
= 2.2.3 - March 26, 2015 =
|
|
|
|
* 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.
|
|
|
|
= 2.2.2.1 - March 17, 2015 =
|
|
|
|
* Option to always enqueue scripts & styles now enabled by default.
|
|
|
|
= 2.2.2 - March 15, 2015 =
|
|
|
|
* 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.
|
|
|
|
= 2.2.1 - February 28, 2015 =
|
|
|
|
* 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.
|
|
|
|
= 2.2.0 - February 25, 2015 =
|
|
|
|
* 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.
|
|
|
|
= 2.1.7 =
|
|
|
|
* Restructured next and back paging navigation script.
|
|
* Updated Italian translation files.
|
|
|
|
= 2.1.6.1 =
|
|
|
|
* More tooltip (qTip2) effects & styling.
|
|
|
|
= 2.1.6 =
|
|
|
|
* 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.
|
|
|
|
= 2.1.5 =
|
|
|
|
* Updated jQuery tooltip library to [qTip2](http://qtip2.com/). Previously using unmaintained original qTip library.
|
|
|
|
= 2.1.4 =
|
|
|
|
* Reverted CSS enqueue change.
|
|
* Added Catalan translation - Provided by Toni Ginard & Monica Grau of [agora.xtec.cat](http://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.
|
|
|
|
= 2.1.3 =
|
|
|
|
* 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.
|
|
|
|
= 2.1.2 =
|
|
|
|
* 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.
|
|
|
|
= 2.1.1 =
|
|
|
|
* Fixed bug with all day events not displaying.
|
|
* Added missing timezone parameter to internal query.
|
|
|
|
= 2.1.0 =
|
|
|
|
* Updated to use Google Calendar API version 3. Version 2 deprecated on Nov. 17, 2014.
|
|
|
|
= 2.0.7.1 =
|
|
|
|
* 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.
|
|
|
|
= 2.0.7 =
|
|
|
|
* 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](http://mazeika.info/).
|
|
|
|
= 2.0.6.2 =
|
|
|
|
* Reverted previous bug fix that introduced new bugs.
|
|
|
|
= 2.0.6.1 =
|
|
|
|
* Added Polish translation - Provided by Michał Pasternak of [iplweb.pl](http://iplweb.pl/).
|
|
* Updated Italian translation.
|
|
* Updated French translation.
|
|
* Fixed bug with date() call causing a display error in some cases.
|
|
* Minor bug fixes.
|
|
|
|
= 2.0.6 =
|
|
|
|
* 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.
|
|
|
|
= 2.0.5.1 =
|
|
|
|
* Fix timezone issue.
|
|
|
|
= 2.0.5 =
|
|
|
|
* 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](http://www.kreativhuhn.at/).
|
|
* Added Norwegian translation - Provided by Tore Hjartland of [aliom.no](http://www.aliom.no/).
|
|
|
|
= 2.0.4 =
|
|
|
|
* 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](http://www.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.
|
|
|
|
= 2.0.3.1 =
|
|
|
|
* Fixed bug where retrieve from/until dates were accidentally removed.
|
|
|
|
= 2.0.3 =
|
|
|
|
* Fixed bug where calendar feed caches weren't getting cleared properly.
|
|
* Fixed feed settings metabox content wrapping issue.
|
|
|
|
= 2.0.2 =
|
|
|
|
* Added Spanish translation - Provided by Eduardo Larequi of [educacion.navarra.es/web/pnte/](http://www.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.
|
|
|
|
= 2.0.1 =
|
|
|
|
* Fixed display errors with certain event builder shortcodes.
|
|
* Added language folder.
|
|
|
|
= 2.0.0 =
|
|
|
|
* Plugin rewritten from scratch.
|
|
* Now using custom post types for storing and customizing Google calendar feeds.
|
|
* Introduced the shortcode `[gcal]` (old shortcode still supported).
|
|
|
|
= 0.7.3.1 =
|
|
|
|
* Include missing file: upgrade-notice.php.
|
|
|
|
= 0.7.3 =
|
|
|
|
* Added warning about upcoming version 2.0 release.
|
|
* Added option to save settings upon uninstall.
|
|
* Tested with WordPress 4.0.
|
|
|
|
= 0.7.2 =
|
|
|
|
* Fixed a bug causing the "More details" Google Calendar information to be displayed in the wrong timezone
|
|
* Fixed a bug that prevented setting the cache duration to 0 from working correctly
|
|
* Fixed an issue that prevented Ajax from working with FORCE_SSL_ADMIN enabled
|
|
* Now uses [wp_enqueue_scripts](http://wpdevel.wordpress.com/2011/12/12/use-wp_enqueue_scripts-not-wp_print_styles-to-enqueue-scripts-and-styles-for-the-frontend/)
|
|
|
|
= 0.7.1 =
|
|
|
|
* Fixed bug causing AJAX enabled calendar grids to not function correctly
|
|
* Fixed bug causing all-day events from outside required date range to be displayed
|
|
* Fixed bug causing tooltip date title heading setting to be ignored
|
|
* Added further data sanitisation on output
|
|
* Feeds with no events will now be cached to prevent HTTP requests on every page load
|
|
|
|
= 0.7 =
|
|
|
|
* Fixed bug causing event dates / times to be displayed in the wrong timezone
|
|
* Changed the [link-path] Event Display Builder shortcode to [url]
|
|
* Fixed an Opera specific CSS issue causing page lists to be hidden
|
|
* Lists can now be displayed in descending or ascending order
|
|
* Added [event-id] and [cal-id] Event Display Builder shortcodes
|
|
* Added an offset parameter for date / time based Event Display Builder shortcodes
|
|
* Added an autolink parameter for enabling / disabling automatic linking of URLs
|
|
* Added gce-day-past or gce-day-future classes to calendar grid cells
|
|
* Cleaned up CSS
|
|
|
|
= 0.6 =
|
|
|
|
* Drastically reduced memory usage
|
|
* Improved feed data caching system
|
|
* Improved error reporting
|
|
* General performance and efficiency improvements
|
|
* Added a few more shortcodes to the event display builder
|
|
* Other [miscellaneous changes / additions and bug fixes](http://www.rhanney.co.uk/2011/04/29/google-calendar-events-0-6)
|
|
|
|
= 0.5 =
|
|
|
|
* Added [event display builder](http://www.rhanney.co.uk/plugins/google-calendar-events/event-display-builder) feature, which vastly improves the customization possibilities of the plugin. This feature encompasses many of the most requested features, such as:
|
|
- All-day events can be handled differently than 'normal' events
|
|
- Start and end times / dates can be displayed on the same line (as can any other event information)
|
|
- HTML (and Markdown) entered in Google Calendar fields can be properly parsed
|
|
* Start and end times for retrieval of events are now much more flexible
|
|
* A custom error message for non-admin users can now be specified
|
|
* No longer loads SimplePie when it is not required
|
|
|
|
= 0.4.1 =
|
|
|
|
* Fix / workaround for the long-running timezone bug. Please take a look at [this](http://www.rhanney.co.uk/2011/01/16/google-calendar-events-0-4-1) for more information.
|
|
* Added additional 'Maximum no. events to display' option to widget / shortcode (mainly to address a further issue caused by the above fix)
|
|
* i18n related bug fix
|
|
* Added support for widget_title filter (courtesy of [James](http://lunasea-studios.com))
|
|
* Added Hungarian (hu_HU) translation ([danieltakacs](http://ek.klog.hu))
|
|
* Now using minified version of jQuery qTip script
|
|
|
|
= 0.4 =
|
|
|
|
* More control over how start and end dates / times are displayed
|
|
* Events can now be limited to a specified timeframe (number of days)
|
|
* Events on the same day in lists can now be shown under a single date title
|
|
* JavaScript can now be added to the footer rather than the header, via an option
|
|
* The 'Loading...' text can now be customized
|
|
* Description text can now be limited to a specified number of words
|
|
* Multi-day events can be shown on each day that they span ([sort of](http://www.rhanney.co.uk/2010/08/19/google-calendar-events-0-4#multiday))
|
|
* Bug fixes
|
|
* i18n / l10n fixes
|
|
|
|
= 0.3.1 =
|
|
|
|
* l10n / i18n fixes. Dates should now be localized correctly and should maintain localization after an AJAX request
|
|
* MU / Multi-site issues. Issues preventing adding of feeds have been addressed
|
|
|
|
= 0.3 =
|
|
|
|
* Now allows events from multiple Google Calendar feeds to be displayed on a single calendar grid / list
|
|
* Internationalization support added
|
|
|
|
= 0.2.1 =
|
|
|
|
* Added option to allow 'More details' links to open in new window / tab.
|
|
* Added option to choose a specific timezone for each feed
|
|
* Line breaks in an event description will now be preserved
|
|
* Fixed a bug casing the title to not be displayed on lists
|
|
* Other minor bug fixes
|
|
|
|
= 0.2 =
|
|
|
|
* Added customization options for how information is displayed.
|
|
* Can now display: start time, end time and date, location, description and event link.
|
|
* Tooltips now using qTip jQuery plugin.
|
|
|
|
= 0.1.4 =
|
|
|
|
* More bug fixes.
|
|
|
|
= 0.1.3 =
|
|
|
|
* Several bug fixes, including fixing JavaScript problems that prevented tooltips appearing.
|
|
|
|
= 0.1.2 =
|
|
|
|
* Bug fixes.
|
|
|
|
= 0.1.1 =
|
|
|
|
* Fix to prevent conflicts with other plugins.
|
|
* Changes to readme.txt.
|
|
|
|
= 0.1 =
|
|
|
|
* Initial release.
|
|
|
|
== Upgrade Notice ==
|
|
|
|
= 2.1.0 =
|
|
|
|
Updated to use Google Calendar API version 3. Version 2 deprecated on Nov. 17, 2014. |