OurCal - a simple yet featureful personal calendaring system
This is a example index.cgi
my $config = OurCal::Config->new( file => 'ourcal.conf' ); my $handler = OurCal::Handler->new( config => $config); my $cal = OurCal->new( date => $handler->date, user => $handler->user, config => $config ); my $view = OurCal::View->load_view($handler->view, config => $config->config, calendar => $cal); print $handler->header($view->mime_type); print $view->handle($handler->mode);
OurCal was written one hungover Sunday afternoon 5 years ago and hasn't changed that much since. It's not a complicated calendaring system, I've got other code to do that, but it's simple and extendable and it works.
Feature wise:
OurCal has no concept of start or end times - an event is on a day or it isn't. Surprisingly this suffices 99% of my time and makes things much quicker and easier internally.
Events can be marked up using the Chump syntax which is kind of like Markdown but had the virtue of existing at the time. There's no real reason why Chump couldn't be ripped out and replaced with Markdown.
Events have a date and a description and that's pretty much it. If you want more feed me beer and choclate covered coffee beans until I get round to finishing EventQueue.
OurCal has simple TODO items as well - these are also marked up in Chump.
OurCal can import iCalendar feeds from both local and remote sources and can also export an ICS feed. Since it's all done with plugins (I loves me my plugins) you could write plugins to import and export whatever you want.
Nominally OurCal is multi user but there's no user management to speak of and I only ever use it for one person so I wouldn't know.
All events use hCalendar semantic markup because I'm nothing if not Buzzword Compatible.
There's no mod_perl or mod_perl handler at the moment but it'd be but a moments work to do.
Requires a config param of type OurCal::Config and a date param in the form yyyy-mm or yyyy-mm-dd. Can optionally take a user param. No user validation is done.
config
OurCal::Config
date
yyyy-mm
yyyy-mm-dd
Return the current date
Return the current user
Return the current date as a span name (month or day)
Return the current date as an object - either an OurCal::Month or an OurCal::Day).
OurCal::Month
OurCal::Day
Return the events for a current span as OurCal::Event objects
OurCal::Event
Return whether the current span has events
Return all the current todos as OurCal::Todo objects.
OurCal::Todo
Returns the names of all the current users
Save a TODO item
Delete a TODO item
Save an Event
Delete an event
Simon Wistow <simon@thegestalt.org>
Copyright, 2007 - Simon Wistow
Distributed under the same terms as Perl itself
OurCal::Provider, OurCal::View, OurCal::Handler, OurCal::Config
To install OurCal, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OurCal
CPAN shell
perl -MCPAN -e shell install OurCal
For more information on module installation, please visit the detailed CPAN module installation guide.