David Brendel [EVENTCALENDAR DOCUMENTATION] Short documentation for the Umbraco EventCalendar package

Transcription

1 2013 David Brendel [EVENTCALENDAR DOCUMENTATION] Short documentation for the Umbraco EventCalendar package

2 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

3 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. 2

4 Attention: If you use gcal there is currently no method to display event details for the events. Also you can t 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. 3

5 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. 4