2013

David Brendel

[EVENTCALENDAR
DOCUMENTATION]
Short documentation for the Umbraco EventCalendar package

Table of Contents
Installation ............................................................................................................................................... 2
Creating a new calendar .......................................................................................................................... 2
Edit calendar settings .......................................................................................................................... 2
Google Calendar Feed ..................................................................................................................... 2
Creating a new location........................................................................................................................... 3
Edit a location .......................................................................................................................................... 3
Add a new event...................................................................................................................................... 4
Add a normal event ............................................................................................................................. 4
Add a recurring event .......................................................................................................................... 4

EventCalendar Documentation
EventCalendar is a proof of concept package for Umbraco 6. It needs MVC as the default render
engine to work properly. It was created to manage multiple calendars with multiple events and
locations. So each calendar can have multiple events and each event can have a location. Locations
are kept separated from events to reuse them in multiple events. It creates a custom section where
the data will be displayed and can be added or edited. Instead of using usercontrols to view and edit
the data it uses mvc surface controller and views. Also the frontend uses a surface controller and
views to display its content. Also it uses the new PetaPoco for the database handling.

Installation
For creating a new calendar just install the package from the package repository or by downloading
it.
You have to create the EventDetails node under the calendar node in the content section otherwise
the package will not work.

Creating a new calendar

For creating a new calendar open the new EventCalendar Section and right click on the calendars
node in the tree. Select create in the context menu. In the dialog enter a name for the new
calendar. After clicking ok the new calendar will be saved and a new page will be loaded where you
can edit the properties of the created calendar.

Edit calendar settings

Right know there are 4 settings you can change: the name, if the calendar should use google
calendar, a calendar feed url and if it should be visible.
Google Calendar Feed
It is possible to use a google calendar feed for the source of the calendar events. To use that you
have to check the Use GCal checkbox and enter a valid calendar feed url.

Attention: If you use gcal there is currently no method to display event details for the events. Also
you cant add a location to the event. Use this only if you just want to display upcoming events.

Creating a new location

To add a new location, right click on the locations node and select Create from the showing menu.
In the dialog enter a name of the location and click ok. After that a new location will be created and
you will be redirected to the page where you can edit the location.

Edit a location
The location has multiple fields. There is one for the location name specified when creating the
location, fields for entering the address of the location and also a google map search field to search
for your location. The search result will be saved as Latitude and Longitude values.

Add a new event

There are 2 types of events which can be saved for a calendar. Normal events have a start and an end
date. So they can span multiple days or are just a single day event.
Recurring events are events which are repeated. The can occur every Friday or on Sunday in every
last week of the month.

Add a normal event

Under a created calendar there are 3 nodes. One of it is called Events. If you right click on this node
you can add a new event with the context menu. After you added the event you will be redirected to
the edit page for normal events. There you can edit the properties of the event like name, start- and
end date and some other properties.

Add a recurring event

Under a created calendar there are 3 nodes. One of it is called Recurring Events. If you right click
on this node you can add a new event with the context menu. After you added the event you will be
redirected to the edit page for normal events. There you can edit the properties of the event like
name, start- and end date and some other properties.