Using Locations

Zap Calendar's new location feature, available starting with Zap Calendar version 2.2, allows you to group events by location (also known as venues). The new Location tab in the back end displays the new Location Manager, where locations can be added, updated or deleted.  A location displays information such as address and contact information, a description and a calendar of events occurring at that location. When editing an event, you now have the choice of entering a text description for the location or choosing a location from a list.  You can limit front-end editing to only choosing a location from a list, only entering a location description, or allow the user to choose.  Zap Calendar's CSV and ical import options, as well as the icalsubscribe and Google Maps plugins, are location aware starting in Zap Calendar version 2.2.

Importing Locations

Zap Calendar can automatically associate events to locations during the import process.  When importing events from either ical or CSV, locations with the same name will be grouped together if a location with that same name already exists.  For example, if your event location's description is "Yankee Stadium", and there is already a location named "Yankee Stadium" as seen in the location manager, then events with the location "Yankee Stadium" will automatically be linked to this location when imported. You will need to ensure the locations are created prior to import.

Some ical feeds support the venue extension as defined in the internet draft, "Internet Calendaring and Scheduling Venue Component Specification" (see http://tools.ietf.org/html/draft-norris-ical-venue-01).  This extension defines the location details, such as address and contact information, directly in the ical file.  Zap Calendar supports ical feeds using this extension for both importing and syncing using the icalsubscribe plugin.  When a feed with this extension is imported or synced, the location is automatically created if it does not already exist and populated with the location details.  Imported events at that location are also linked to the location document.

Displaying a Location

The calendar view includes an option under the link tab for specifying how to display the location of an event if clicked.  The options available are :

  • Same Window - Show the location in the same window as the event
  • New Window - Open a new window to show the location
  • Modal Style - Display the location in a modal window
  • None - do not show a link for the location (display title only)

 

This will display the location information with all the details.  The user can also choose to display a different location from this same page.

It is recommended to create a menu option to display a location from within a menu.  Creating a menu option will allow you to add a calendar to your location display, where all the events associated with that location can be displayed.  Any calendar display mode can be used (i.e., month, week, upcoming, list).  This menu option is used to determine which calendar view to use when a user clicks on a location in an event.  This menu option can be in a hidden menu if you do not wish to publicly display a menu opton for the location.