Calcium Documentation - Adding, Edit, and Deleting 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.
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
- whether or not to draw a border around the event
- 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
www.brownbearsw.com). Email addresses are also
recognized; Calcium recognizes text like
email@example.com as email
For links that start with
www, Calcium will include
only letters, numbers, and the underscore; for
links, everything up to the next space is included. So, if you have the
www.brownbearsw.com/calcium/docs/ in an event,
it would appear as
On the other hand, event text like
http://www.brownbearsw.com/calcium/docs/ would appear
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
The automatic link detection is automatically suppressed for all text
if your event contains any of these "<a " link tags.
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.
You can specify how each event should behave if your calendar is
included in another calendar. You can classify each event as:
|Public||it will display normally when
|Private||it won't display at all|
|Private Popup||event text and time will display,
but popup text won't|
|Unavailable||only the string "Unavailable" and
the time will display|
|Out of Office||only the string "Out of Office"
and the time will display|
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.
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
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
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
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
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
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.