amr ical events

This wordpress calendar plugin lists upcoming events from a one or more ical feeds ( .ics files in RFC 2445 format). It is available for a page or as a widget. For some widget showcase, see the widget page.

• See screenshots at wordpress,
• See the showcase
• Language Examples at the language test site.

amr ical in use in the wild

Features:

• can combine multiple calendars (for example: include public holidays or moon phases along with your calendar);
• offer your viewers the possibility of automatically adding events with it’s detail straight into their google calendar, or even the whole calendar into their calendar application;
• offers the ability to group your events for readability and style. Grouping can be done by a variety of methods, such as daily, weekly, monthly, yearly or by seasons!
• works ‘out the box’ with an option to do own styling via a combination of list types to control content and lots of css tags to control styling;
• a number of preset styling options offered to give you an idea of what is possible;
• specify your own locale specific date and time styling
• handles timezones, daylight saving with options to redisplay in original calendar timezone.
  
• can list not only events, but also the other ical components like todo tasks, freebusy, journal (notes)
• allows for internationalisation, however translation files still required – any volunteers?
• W3C validated Css and the html
• cache’s the files for improved performance. Refresh option for testing.
• handles nearly recurrence rules (more than others I’d bet!)

Usage:

Create any number of pages for different calendars or combinations.  Examples (note I am using i-c-a-l to stop the shortcode plugin kicking in- you will enter iCal):

• [i-C-a-l webcal://ical.me.com/somecal.ics]
• [i-C-a-l webcal://ical.me.com/ashowcal listtype=2]
• [i-C-a-l http://anothercal.ics http://hol_cal.ics listtype=3]

URL and shortcode control for testing

• ics=url (allows you to try out with different calendars)
• listtype=n
• start=
• tz=timezonestring (eg: UTC or Sydney/Australia)
• startoffset=n (number of days – can be negative)
• hoursoffset = n (number of hours – can be negative)
• days=n
• events=n
• grouping = txt (Day, Month, Year, Quarter, Astronomical Season, Traditional Season, Western Zodiac)
• nocache

Test site

This Ical plugin has API style features. This means that without downloading and installing on your web, you can try out some of the possibilities with your calendars:

The plugin and this site allow you to add to the query string: using ? for the first query parameter or & thereafter:

• ?iCal=youricsurl

List Types

(you can create more or customise these)

• &listtype=1 (default)
• &listtype=2 (suits venue based events like shows)
• &listtype=3 (timetable)
• &listtype=4 (widget)
• &listtype=5 (lots of groupings)
• &listtype=6 (for test purposes only, has all the groupings)

Note: the list type only works if an iCal has been passed in the query string too. This may change later. The List type format is entirely configurable via the settings page on your web.

Timezones (must be a valid timezone)

• &tz=Australia/Sydney
• &tz=America/Los_Angeles

Cache or no Cache (refresh)

• &nocache=true

Download

Download at the Wordpress Plugin Page: http://wordpress.org/extend/plugins/amr-ical-events-list/

Version and other Pages

Please use the latest version. Log any queries or comments on the page for the version you are using – thanks.