Documentation

The Calendar add-on lets you create, manage, and display multiple calendars on your concrete5 site.


There are two main areas you’ll be working:

  1. Events are created and managed from the Dashboard.
  2. You can place views to your calendar throughout your site using the Calendar & Event List blocks.


Dashboard

Goto the Calendar page in your Dashboard to start setting things up.


Add Calendar

You might need more than one type of calendar on your site. Perhaps you’re running a university site where you’d like to keep Athletic and Academic events separate. You must create at least one calendar to add events to, but you can create as many as you need from the Add Calendar tool in the Dashboard.


Attributes

The calendar add-on lets you extend events with custom attributes. Any data that you want to consistently track against events can be created here the same way you might tie and attribute to a user or page.

The is_featured attribute is a simple checkbox attribute that you can make manually which the Event List block can use for filtering on your site.


Once you’ve made a calendar you can pick the calendar you’re viewing from this drop down. You can also add new calendars, delete a calendar, or edit the name of the calendar from here.

Categories are tied to events within a calendar. Categories are pulled from the Topic Trees which you can manage from System & Settings, or by typing “Topic” in the concrete5 search bar.

An event may be in multiple categories.


Add Event creates a new event within the calendar you have selected.


Add Event Form

This overlay has three tabs: Details, Navigation & Categories.


Details is general information about your event, including:

  • Name - Displayed first in most views, keep it short to avoid line wraps.

  • Time - Every event must have a start date, and may have an end date. If you pick All Day you will not have to pick a time but rather the event will fill the entire day (eg: Vacation)

  • Description - This is a longer explanation for your event and is shown on roll over in most views.


Navigation

This tab allows you to join this event to a page in your website. If your event has more information than works in an overlay, or you’d simply like to link to a detail page with a signup form or other content, pick the page from the site map here.


Categories

This is where you select which categories your event falls into. An event may be listed in multiple categories. These are used for filtering in the various block views.


Calendar Block

The calendar block displays a complete calendar on a page in your site. It defaults to the traditional Month view, but also has Week and Day views the user can switch to.


Data Source: Calendar - You pick which calendar you want to display here. You can only display one calendar in a view, you should use topics if you want to organize events of different types in the same calendar


Filtering: By Topic - This will let you limit the results displayed in this calendar to just events from one part of the topic tree.


LightBox: These attributes will be displayed in an overlay when the user clicks the event.


Event List Block

If you just want to display upcoming events (for a sidebar for example) the Event List block is ideal. Just like the Calendar block you pick a calendar, and filter by topic.


You can configure this block to only display events that have the “is_featured” attribute turned on. This will let you keep redundant events like weekly meetings out of a sidebar listing and instead just display events you choose to feature.


The Results section lets you add a title to display above the events, as well as limiting how many events to return in total and how many to display at once before a paging interface is added.