Login / Status
developer.Resource
Home . Documentation . Document Library . Extension Manuals
Sponsors
hosted by punkt.deTYPO3 and Open Source MagazineAOE Media

Chapter 5. Create the Calendar Records

To use the Calendar Base extension, you will need to create at least two different records. You must first create a Calendar record. A Calendar record is the calendar that you will associate events with. For instance, you could create a Church Calendar record and associate all of your church events with it. You could also create a Staff Calendar and associate staff appointments and meetings on it. There are multiple ways to display two calendars. You could put them on different pages, multiple calendars could share a single page and you could optionally hide the Staff Calendar unless a staff member was logged in, or you could have the two calendar's events share a single calendar and restrict which events appear based on different logins. (For more information on how configure a page using multiple calendars, see Using Multiple Calendars in the Advanced section.)

Tip: By default, TYPO3 generates dates in the Backend in European format (2007-04-23) and the 24-hour clock (18:00). You can change the format for both of these by using the Install Module, clicking on the All Configuration link, and scrolling down to the ddmmyy field. Change that setting to m-d-y. Then scroll down (right below the ddmmyy field) to the hhmm field. Change that setting to g:i a (g colon i space a). Then scroll to the bottom of the page and Update your changes. Your Backend will be more user-friendly.

5.1. Create a Calendar Record

The first step in creating an online calendar with the Calendar Base extension is to create a calendar record.

  1. Refer to Illustration 17. Using the L

    Illustration 17: Adding a Calendar Record (1)

    ist Module, click on the Create new record icon (1).

  1. R

    Illustration 18: Adding a Calendar Record (2)

    efer to Illustration 18. Click on the Calendar link (2) in the New record form.

 

  1. R

    Illustration 19: Adding a Calendar Record (3)

    efer to Illustration 19. Complete the Calendar record's form as outlined below. When you're finished, save and close your work.

  1. Calendar Type: There are three types of calendars within the Calendar Base extension. Each type indicates how Calendar Event records are generated.

(1) Standard Calendar: The Standard Calendar (database) is the default record. It depends on manual entry to generate Calendar Event records (see Create Calendar Events below).

(2) External Calendar: The External Calendar depends on an ICS feed for the creation of Calendar Event records. The External Calendar's form is identical to the Standard Calendar's form (Illustration 18), with the exception that it provides a field for the URL of a web-based ICS calendar feed.

NOTE: Google, Yahoo, and others provide online calendars that allow exports of their data. Look for links about “sharing your calendar.” You will need the provided URL - look for their ICS or Ical URLs. They will be files with an .ics extension.

(3) Include ICS File: The Include ICS File Calendar allows you to upload an .ics file for the creation of Calendar Event records. The Include ICS File Calendar's form is identical to the Standard Calendar's form (Illustration 18), with the exception that it provides a field for uploading or attaching a previously uploaded file.

NOTE: Desktop applications such as Microsoft Outlook and Apple iCal are able to export ICS files, which can then be uploaded for use with Calendar Base.

  1. Owner: If you leave this field blank, any Frontend user can view the calendar. If you select users or user-groups from the Items, the calendar will only generate the events of this calendar for them. This is useful for creating Staff or Members-Only calendar events. See Using Multiple Calendars in the Advanced section for more information.

  2. Enable free and busy view: When used in conjunction with the Owner field, appointments for the owner group will not be shown, but in the Day and Week views the time will be shown as “busy.”

  3. Limit the free and busy view: When used in conjunction with the above options (Owner and Enable free...), you can limit the generated free and busy views to the users or user-groups you select. Leaving this field blank will allow the free and busy view to be generated for all calendar users.