Version 2, A major update is available.
Repeating events, a widget, cacheing and lots of configuration options to specify what fields are used where and in what order. Locale dates can be used, translation allowed for, not yet provided. Ics files can be combined, or multiple on a page.
Note that 2.2 alpha is available.
See the readme file for more information., or here http://wordpress.org/extend/plugins/amr-ical-events-list/ This was a bit of a push to get this done as I will be otherwise occupied for a while. Please do let me know about any bugs. It has been fairly thoroughly tested in most areas, however there are some that have not been: Any timezone oddities, that sort of thing.
Plugin and widget demonstrated here temporarily:
ICs files are local, you can repeat the test with google public files.
Testing and Validation
The plugin has been tested on wordpress 2.6.1 using php5 on a windows and Linux server.
The Css and the html produced have been validated by the w3c validator (both the pages and the admin pages) .
The CSS has been tested on Firefox 3 thoroughly, some on IE more testing later…. It is fairly standard CSS, allowing you to pick up styles from the themes. A variety of theme’s were tested with the CSS, and some validation failures experienced but on investigation they appeared to be a problem with the theme, not the plugin’s css. Another oddity was the default theme - it proved well nigh impossible to get rid of the bullet arrows - see screen shots on the wordpress.org site in Firefox (IE was okay). Other theme’s were fine.
Future possible features and/or bug fixes.
Please let me know if you need any of these, so that I can prioritise accordingly:
- Timezones - be cleverer to make it more foolproof. see http://webdesign.anmari.com/timezones-wordpress-ical-php/
- Original URL’s in the Calendar properties so that these can be displayed at top of list as hyperlinks for subscribing or other purposes
- Implement remaining functions for groupings allowed in admin screens (eg: seasons). this would be to allow seasonal styling. If your site is international, please remember we are not all in the northern hemisphere!
- Implement more recurrence types - the code I leveraged off does not do all. I have other code that does, but would need to rework how they integrate.
- Language files - capability there, but no other languages provided other than what the PHP date functionality offers. Very few words need translating (eg: “All Day”).
- The hyperlink function has been upgraded several times as we find URL examples that don’t get completely picked up. I saw there is still a problem with a hyphenated URL. Any others picked up? Also there was funny happening which may be a wordpress interaction, if the href html was already in the ical property text (eg: the description), and the widget wa being used. Let me know if this happends to anyone.
- Lots of css tags are provided, however more worked examples using these tags may help. If you have done something interesting, please send a link to show off your skills and inspire others.
- Implement / test / verify that todo’s and journals components of the spec work too - provision is made for them, but not all code there and have not tested as I have no need. If you have a need, let me know and we can test it out together.
- Timezones - this can be very complex, especially if there is daylight saving involved!! If you have a problem, please check that you have understood your data correctly - the timezone on your server, your calendar etc. If you still have a problem, please try to describe very clearly what data has been provided, and why you think the plugin may be at fault. Test your setup out first. Check it on another product, like outlook.
- A css class for each field is provided, but there maybe a request for a Recur class for the whole event eg: if an event recurs, so can style or reflect that repeating event, especially for shows - may go hand in hand with not actually expanding the event
- Ability to NOT expand repeating events (Version 1 did not expand, but rather said whether an event was daily,weekly etc)
Download
http://wordpress.org/extend/plugins/amr-ical-events-list/ (so we can track downloads - thanks)
Installation
- Unzip the folder into your wordpress plugins folder.
- Activate the plugin
- Create a page with an iCal spec in the content somewhere using HTML mode, not Visual mode. Visual Mode will turn it into a link, and at this stage the code is expecting plain text.
- [iCal:http://someurllikegoogle.com/basic.ics]
- [iCal:http://someurllikegoogle.com/basic.ics,http://someurllikegoogle.com/holidays.ics]
- [iCal:http://someurllikegoogle.com/basic.ics;listtype=3]
- That’s it - customise the css and background images to taste.
Troubleshooting
see here ical-events-list/troubleshooting/
Screenshots
(others are available in the zip file, or here http://wordpress.org/extend/plugins/amr-ical-events-list/screenshots/
Widget
Example Daily Grouping and Day in Detail
Version 1
Information on version 1 is here: Upcoming Ical Events List v 1.0.