Readme

A calendar that harvests events events such as conferences, product launches, training courses etc. from remote sources with RSS+events.

It is a folder-like object, that will accept the objecttypes: RDFSummary, DTML Method and Page Template. The site administrator can select if the week starts on a Monday or a Sunday. It has an update-method, which will call the update methods of all RDFSummary objects inside it. It harvests calendar events according to this RSS 1.0 module: http://groups.yahoo.com/group/rss-dev/files/Modules/Proposed/mod_event.html.

Installation

You need RDFSummary 2.x. Both modules are Python products. Unpack RDFSummary 2.x and RDFCalendar in your Products directory and restart Zope.

Methods

Assuming you have created an RDFCalendar object on /calendar, you can then from your index_html write:

<dtml-with calendar>
<style type="text/css">
<dtml-var default_css>
</style>
<dtml-var show_calendar>
</dtml-with>

The show_calendar method will have links to two customisable DTML methods in the calendar folder. The index_html and the show_day_events.

To customise these DTML methods, RDFCalendar provides you with a few convenience methods protected by "View" permission:

show_month: The show_month will render a left arrow, the month and the year and a right arrow. There will be links to the calendar's index_html method with the arguments month and year set. You call it like this: <table><dtml-var show_month></table>
show_monthly_events: This method will show a month of events. It needs the variables month and year.
show_events_list: This method will show a day of events. It needs the variables day (1-31), month and year.
view_calendar: display small standalone calendar
show_calendar: display the small calendar
default_css: render the default stylesheet. The stylesheet can be configured through a configuration tab.
show_days: display days in HTML format as table rows
get_events(year=None, month=None, day=None): search in objects with meta_type='RDF Summary' and return events list, with events going on in given 'month' and 'year'
get_days_events(): search in objects with meta_type='RDF Summary' and return day_events list
show_week: display week days in HTML format as table row
show_month: display months in HTML format as table row
getMonth: if REQUEST is None return current month
getYear: if REQUEST is None return current year

Example feeds

Here are some feeds you can use for tests. I'm interested in hearing about yours also. You simply create them as RDFSummary objects inside the RDFCalendar folder.

Acknowledgements

RDFCalendar was developed for EEA/EIONET by Cornel Nitu and Rares Vernica, both from Finsiel Romania.