Adding Events

It's easy to add an event to a calendar. Click on the Add/Edit link below the calendar, or click on the day you want to add the event to; this brings up the Event Edit screen for that day.

Note: if you don't have permission to Add events to a calendar, the links will not appear. Also, the calendar may have been configured not to display the bottom links.

Any events which already exist for that day are displayed, as well as a form you can fill out to create a new event. The only required field is the Event Text.

In addition to the event text, you can specify:

• The date of the event (if you clicked on a day, this defaults to that date.)
• Popup text to be associated with the event, or an HTTP URL that clicking on the event brings up
• Start Time and End Time
• whether the event is Private or not (see Event Privacy below)
• Foreground and Background Colors (specifying colors)
• whether or not to draw a border around the event (BlockView only)
• a Category for the event, which has associated default colors and can also be used for Searching and Filtering (see administering categories)

HTML formatting is allowed in event and popup text, so you can change text fonts, sizes, and color, include images, or do just about anything else supported by HTML. (Note: a calendar admin can disable processing of HTML tags via the Calendar Settings)

Calcium will automatically detect URLs and email addresses in your event text, making them "clickable links" in your browser. It will recognize URLs that start with http:// or www (e.g. http://brownbearsw.com, or www.brownbearsw.com). Email addresses are also recognized; Calcium recognizes text like somename@somedomain.sometopleveldomain as email addresses.

For links that start with www, Calcium will include only letters, numbers, and the underscore; for http:// links, everything up to the next space is included. So, if you have the text www.brownbearsw.com/calcium/docs/ in an event, it would appear as
  www.brownbearsw.com/calcium/docs/

On the other hand, event text like http://www.brownbearsw.com/calcium/docs/ would appear as
  www.brownbearsw.com/calcium/docs/

Finally, you can have complete control by specifying the actual HTML code in the event. For example, this text:
   Here is the <a href="http://www.brownbearsw.com/calcium/docs/">doc page</a> for Calcium.

Would show up as:   Here is the doc page for Calcium.

The automatic link detection is automatically suppressed for all text if your event contains any of these "<a " link tags.

Repeating Events
You can also specify that an event repeats. An event can repeat on every day, or every week, or every other week, or every third Monday, Wednesday, and Friday, etc. An event can also repeat in the "the third Thursday of every month" fashion. You can select the end date for the event, or let it repeat forever.

After creating a Repeating Event, you can edit or delete single instances of the series, or you can edit or delete all the events in the series at once.

Event Privacy
You can specify how each event should behave if your calendar is included in another calendar. You can classify each event as:

Add to Multiple Calendars
If the calendar you're working with has this feature enabled, you'll see a list of calendars labelled "Add to Which Calendars?" This allows you to add an event to multiple calendars; each calendar will get its own copy of the event. The current calendar is selected by default, and you can choose one or more others from the list, or de-select the default. After creating it, deleting or modifying the event in one calendar will have no effect in any of the others.
Depending on the configuration, the listed calendars will include either: all calendars you have Add permission in; only those calendars in the current calendar's groups; or only those calendars included into the current calendar. (Note: Multiple selection works differently in different browsers; you may need to hold down the "Control" or "Shift" key while clicking on names after you select the first one.)

Email Notification
If you would like Calcium to automatically send email notifying people that an event has been added, fill out the Email Notification section when adding the event. You can specify addresses for the To:, CC:, and BCC: fields of the email. Additionally, you can enter any extra text you would like to include in the email message (this text will not display anywhere on the calendar.) When you save the new event, an email message will go out to the addresses you entered.

Email Reminders (Requires Email Reminders Option)
If you have purchased the optional Email Reminder package, you can have Calcium send reminder emails before an event is scheduled to occur. Choose how long in advance of the event you would like the email sent, and fill in one or more email addresses. You can specify times for one or two reminders.

If the event has no Start Time, the time to send the email is computed from midnight on the beginning of the day of the event. For example, specifying "12 hours" for an event with no time would cause the reminder message to be sent at noon on the preceding day.

As in Email Notification, you can list multiple email addresses; just separate them with commas. You can also use Calcium Email Aliases to specify lists of users.

Note: you have probably noticed there are multiple Create Event buttons on the screen (or Replace Event buttons, if you're editing an existing event.) They all do the same thing; there are more than one simply to make it easier to submit your event without having to scroll around.

To Edit or Copy an event, select the Edit button that appears next to the event in question at the top of the screen for that day. Similarly, to Delete an event, select the appropriate Delete button. For repeating events, you can choose whether to edit or delete all instances of the event, or only the instance that occurs on the day you're looking at.

If you're Editing an event, you'll be presented with the same Event Edit Form used to create a new event. The fields will contain information for the event to be edited, and you can change any or all of them. When you're ready to save your changes, press the "Replace Event" button.

To Copy an existing event, press the Edit button, and then press the "Copy Event" button instead of the "Replace Event" button. Note that you can make changes before copying, effectively editing and copying an event in one step.

You can also Copy an event to other calendars, if Adding to Multiple Calendars is enabled. Edit the event as above, and select the calendars from the calendar list. (Make sure to unselect the current calendar, or you'll get another copy there, too.) Then, press the "Copy" button.

If you have Administer permission in a calendar, you can delete a large number of events at once using the Delete Events link from the Calendar Settings page. Follow that link, then specify the date range; all events which occur between those dates will be deleted. If a repeating event occurs in the date range, that event definition will only be deleted if all occurrences of that repeating event occur in the range.