iCal Events Widget

Contributors: matthijsvdmeulen, phranck

Donate link: http://jmvdmeulen.nl

Tags: icalendar, ical, plugin, widget, events, rfc2445, iCalEvents, ics, Google Calendar

Requires at least: 3.1

Tested up to: 4.9.7

Stable tag: 1.0

This widget shows you upcoming events for a configurable iCal .ics file or URL.

Description

This widget shows you upcoming events for a configurable iCal .ics file or URL. There are a few options you can set like:

• Title of the widget when it's visible in your sidebar
• Subscription URL to your iCalendar .ics file
• Number of events to show
• Switch on/off event summary/title
• Switch on/off event start/end date
• Switch on/off event start/end time
• Switch on/off event description
• Switch on/off event location
• Setting up a range of dates that events will be shown

Translations

• English
• German
• French
• Dutch

Installation

This section describes how to install the plugin and get it working.

1. Upload the complete 'ical-events-widget/' directory to '/wp-content/plugins/' directory of your active theme
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to the 'Widgets' menue in WordPress and put it on the right place of your sidebar

Screenshots

1. Widget options in your WordPress Admin
2. The active Datepicker for selecting a date range
3. Widget in action in your sidebar

Changelog

= 0.4.0 =

• Major fixes for newer wordpress version
• Added Dutch translation

= 0.3.3 =

• added french translation

= 0.3.2 =

• fixed a translation issue

= 0.3.1 =

• fixed some issues with php 5.3.x

= 0.3.0 =

• added a datepicker for the date range input
• locale support for dates
• documentation updated
• translations updated

= 0.2.0 =

• added some very basic functionality for selecting a date range
• minor bugfixes

= 0.1.0 =

• The very first version.

Notes

The package of this plugin is available for download at: http://downloads.wordpress.org/plugin/icalendar-events-widget.zip

This widget makes (in some topics partially) use of:

• the ics-parser class by Martin Thoma
• the jQuery UI-Datepicker plugin
• the DateJS - Javascript Date Library

Good to know

Normally you will select a "range date-to" greater than the "range date-from". But, if you set the "range date-to" lesser than the "range date-from" (or lesser than the current date, if "range date-from" is empty), then the list of events to show will be given in reverse order (aka descending).

Customization

Please check the iCal_Events.css file for style customization and the templates in the templates folder for styling options.