Konstrukt::Plugin::calendar - Management of private and public calendar items
You may simply integrate it by putting <& calendar / &> somewhere in your website.
This Konstrukt Plug-In provides calendar-facilities for your website.
You may simply integrate it by putting
<& calendar / &>
somewhere in your website.
You may also create an .ihtml-file containing:
<& calendar show="rss2" / &>
to export the latest calendar events to an RSS2 compliant file.
The RSS file will contain all events within the next X days, where X is specified in the HTTP-request and must not exceed 31:
http://domain.tld/calendar_rss2.ihtml?preview=14
If not specified, the range will be set to 7 (1 week).
The HTTP parameters "email" and "pass" will be used to log on the user before retrieving the events. This will also return private events.
http://domain.tld/calendar_rss2.ihtml?preview=14;email=foo@bar.baz;pass=23
You may also decide, whether the date and the time should be stated in the entry:
http://domain.tld/calendar_rss2.ihtml?show_date=0;show_time=1
You may do some configuration in your konstrukt.settings to let the plugin know where to get its data and which layout to use. Defaults
#backend calendar/backend DBI
See the documentation of the backend modules (e.g. "CONFIGURATION" in Konstrukt::Plugin::calendar::DBI) for their configuration.
#layout calendar/template_path /templates/calendar/ #user levels calendar/userlevel_write 1 #every registered user may add events calendar/userlevel_admin 2 #rss2 export calendar/rss2_template /templates/calendar/export/rss2.template
Yes, this plugin may return dynamic nodes (i.e. template nodes).
Initializes this object. Sets $self->{backend} and $self->{template_path}layout/. init will be called by the constructor.
Installs the templates.
Parameters:
none
We cannot prepare anything as the input data may be different on each request. The result is completely dynamic.
All the work is done in the execute step.
Parameters:
Displays the form to add an event.
Takes the HTTP form input and adds a new event.
Displays a confirmation of the successful addition or error messages otherwise.
Displays the form to edit an event.
Takes the HTTP form input and updates the requested event
Displays a confirmation of the successful update or error messages otherwise.
Displays the confirmation form to delete an event.
Deletes the specified event.
Displays a confirmation of the successful removal or error messages otherwise.
Shows an overview of a month or error messages otherwise.
Displays a confirmation of the successful removal or error messages otherwise.
Parameters:
Note that events that occur every day will not mark every day for an event as this will lead into visual unclearlyness.
Shows an overview of a week with it's events or error messages otherwise.
Parameters:
Shows an overview of a day with it's events or errpr messages otherwise.
Parameters:
Displays an entry.
Shows an overview of all events or error messages otherwise.
Shows the last calendar view that has been saved in the session.
Generates an RSS 2.0 compliant XML file with the content from the database.
The RSS file will contain all events within the next X days, where X is specified in the HTTP-request and must not exceed 31:
http://domain.tld/calendar_rss2.ihtml?preview=14
If not specified, the range will be set to 7 (1 week).
The HTTP parameters "email" and "pass" will be used to log on the user before retrieving the events. This will also return private events.
Prepares the passed events for later use.
Private events that don't belong to the user that is currently logged on, will be eliminated.
Events with wildcard dates (e.g. year = 0) will be repeated within the given date range and inserted with absolute/fixed dates.
The event list will be sorted chronologically.
Returns the prepared event list as array reference of hash references
Parameters:
Copyright 2006 Thomas Wittek (mail at gedankenkonstrukt dot de). All rights reserved.
This document is free software. It is distributed under the same terms as Perl itself.
Konstrukt::Plugin::calendar::DBI, Konstrukt::Plugin, Konstrukt