News (Updated 11 April 2008)
Anna-marie Redpath has modified iCalEvents to output a table of events. I actually think it looks nicer than the list-based version. You can get it at her website.
Anna-marie also brought to my attention a plugin with the same name as mine, written by Daniel Westermann-Clark. If you're using my plugin, updates for his plugin may show up in your Wordpress installation. His plugin seems to be better-maintained than mine, so you might want to give it a try as well.
A few people have reported an issue with iCalEvents that produces the following error:
Fatal error: Call to undefined function: file_get_contents() in /path/to/icalevents/engine/iCalParser.php on line 64The error happens if your server was configured to disallow the file_get_contents function (presumably for security reasons). Tony submitted this patch which makes iCalEvents use cURL instead and seems to fix the problem.
Background
I was developing a new website for Liberating Students Digitally using WordPress and we needed an events page. So, I figured I'd just create a Google calendar and there would be a WordPress plugin to display stuff from it. There was, Wooglecal, but it relies on Google's RSS feed, which means they don't have much control over the content and formatting of the events.
Then I made this website and posted my plugin at wp-plugins.net. As it turned out, other people were looking for a plugin like this as well. I also copied some of the code out of my plugin and made a standalone version for my website and the UACS website. Turns out people wanted this as well. So, I modularized the code and now there are three things you can download: the engine, the plugin or the standalone script.
License
As a fervent supporter of free software, I would not feel right distributing this code under any license other than the GNU GPL. A copy of the license is included with the script. Please extend, modify, redistribute and hack this code as much as possible. That's how free software works.
Documentation
Wordpress version: Unzip the plugin into your plugins directory. Activate it in the Site Admin. Put [iCal:URL] into a post or page (where URL is the URL to your iCal file) and your events should magically appear in that post/page
Standalone version: Replace "Your URL Here" in the code with the URL to your iCal file. Style as you see fit.
Engine: Documentation to come. The code is (sort of) commented.
History
See the changelog for version history.
Download
Latest version: 0.30
- WordPress Plugin Version (tar.gz)
- WordPress Plugin Version (zip)
- Standalone Version (tar.gz)
- Standalone Version (zip)
- Engine Only (tar.gz)
- Engine Only (zip)
Old version(s) (of the plugin version):
Donations
I believe in free software - free like free speech and like free beer. However, I also like (and need) money to live, go to school and write code. If you use this script and really like it - especially if you were willing to pay for something like this in the first place - a donation would be really nice. Please don't feel obligated to give me money; I created this script for myself and made it available because I thought other people might want to use it. However, if you feel so inclined, click the button to donate by paypal: