Calendar:FAQ

This FAQ applies to Sunbird and Calendar.

A FAQ in the Wiki. - Mostly questions from news://netscape.public.mozilla.calendar

The official FAQ is at: http://www.mozilla.org/projects/calendar/faq.html

You may also have a look at: http://kb.mozillazine.org/Sunbird

Calendar Help is available online (only for Mozilla browsers) at: http://calendarhelp.mozdev.org/open.xul

WARNING

• Some of the solutions here are only for advanced users.
• Calendar does not work with Seamonkey, changers from Mozilla have to use the stand alone calendar Sunbird, where existing calendar files can be imported.

Files

Where is my Calendar file?

Select the "Calendars" tab in the upper right area of the screen (above the "Tasks"-list). Right click on the calender and select "edit Calendar". The file name and path are shown in the label next to "Lokal File Location".

How do I save my Calendar-file on a FTP

It's tricky at first to figure it out but this is the way to proceed:

1. Create a local calendar.
2. Add an event and exit calendar.
3. Copy the new calendar file to the FTP server (under another name if you wish).
4. Return to calendar and fill in the "remote server URL" field of the new calendar. (ftp://user:pass@domain/filename)

That's all! It should work now!

The trick is that at least one event have to exist in your new calendar, otherwise, the file is empty and seen as "invalid".

by Nomax

Where can I get Holiday-Files?

here http://www.mozilla.org/projects/calendar/holidays.html or here http://calendarhelp.mozdev.org/open.xul (Mozilla-browsers only).

Installation

How can I install calendar in my current Version of XY? It doesn't work.

Download the most recent calendar.xpi. Open it with your favorite zip-program. You might need to rename the .xpi to .zip. But don't forget to rename it afterwards. Extrakt the install.rdf and edit the var <em:maxVersion> of the Application you want to use to the Version you are using. I.e. 1.0 -> 1.0+ or 1.0->1.1 or whatever. Repack the install.rdf. Now you should be able to install it.

You can also try the Nightly Tester Tools, which have an option to override the compatibility test.

Warning: This shouldn't do any harm, but don't do it if you have no idea what you are doing.

Where can I download calendar?

The Calendar extension requires Firefox, Thunderbird or Mozilla Suite. Download it from: http://www.mozilla.org/projects/calendar/download.html

The Sunbird project provides a stand-alone version that does not require any other Mozilla product. Download it from: http://www.mozilla.org/projects/calendar/sunbird_download.html

Where is the help?

The Calendar Help project provides help documentation built-in to Calendar or Sunbird. Download it from: http://calendarhelp.mozdev.org/installation.html or view it Online with a Mozilla-browser at http://calendarhelp.mozdev.org/open.xul

Printing

Printing does not work

Poor's man solution while it gets fixed: the print preview is saved as an HTML file in your %TEMP% directory. Copy it to another file (or, if allowed, open it in a browser window) and you'll be able to print it. (To find out you %TEMP%-dir call "set" in the command-line. If you don't know how to do this, it might be better to wait until this problem is solved ;-) )

You may need to keep the print preview open when copying or opening it, because some sunbird builds appear to delete the temp calendarPrint.html file when the preview window is closed.

Other Qs

I want to be informed without having Sunbird in my task-bar

Here are a few links you can have a look at:

SunTray:
http://users.dart.net.au/~srgeorg/

iCalMinder:
http://www.brownbearsw.com/ical/tricks.html#iCalMinder

MozCalTray:
http://dev.tech-nine.net/

TB / FF crashes / shows an error after installing Calendar

This is a bug. It will happen each time you do someting withh your extensions (install, delete, update). The next time you start TB/FF everything is fine.

What is the difference between a task and an event?

The following definitions are from the calendar help glossary:

event - A calendar entry that represents something that will happen whether you take action or not. For example, meetings and birthdays are events.

task - A calendar entry that represents some action by you. For example, writing a report and visiting a client are tasks.

In general, an event is something you schedule on the calendar, and it happens at a specific time and place. A task occurs over time, and while it may need to be started at a specific time or completed by a specific time, the task itself does not.

Finally, it should be noted that tasks can only be displayed in the main calendar in certain views. (ie. multiweek)

Example: A staff meeting is an event; it happens at 9:00am on the 10th.

Calling everyone on staff to review the agenda for the meeting is a task; it must be completed by 5pm on the 9th.

How can I assign colours to event categories?

Sunbird 0.2 and Calendar 0.8

In Sunbird 0.2 and Calendar 0.8, you can define styles for event categories in the userChrome.css file.

Example:
.event-category-cycling{ background-color: #99FFCC!important; }
.event-category-meeting{ background-color: #00FF99!important; }

These lines set the background colours for 'cycling' and 'meeting' events, respectively. It is CSS, i.e. you can also define other attributes like 'border-color' or include background pictures:

Example:

.event-category-radtour{ 
  color: black!important;
  border-color: blue !important;
  background-image: url(file:///D|/etc/bbbike/images/srtbike.gif);
  background-position: center center;
  background-repeat: no-repeat;
  border-width: 2px ! important;
}

This lets all 'Radtour' events appear with a blue border and a road bike icon (contained in the file specified above).

Sunbird 0.3

Since calendar 0.3, the format must be

Example:

[item-category~="Radtour"]{ 
  color: black!important;
  border-color: blue !important;
  background-image: url(file:///D|/etc/bbbike/images/srtbike.gif);
  background-position: center center;
  background-repeat: no-repeat;
  border-width: 2px ! important;
}

How can I assign colours to tasks?

This isn't possible at the moment.

Is there still a development in Progress?

Yes it is. Have a look at http://bonsai.mozilla.org/cvsquery.cgi?branch=HEAD&file=mozilla/calendar/&date=month

How can I synchronize data with my mobile phone?

This is currently only possible with third party programs. There is a free windows tool GammUI based on the Gammu GSM library that currently supports one way synchronisation from mobile to Sunbird. The original Linux counterpart is called Wammu and supports two way iCalendar exchange with a mobile phone.

Suntray

As there are quite a few Questions about Suntray I'll add them here.

Suntray does not start Sunbird

Put Suntray in the same folder as Sunbird and start it with " -start".

I don't get any alarms

This is probably because Sunbird isn't running. Suntray doesn't show any alarms, it just hides Suntray from your task bar. So do not exit Sunbird, only minimize it. If you close Sunbird, you won't get any alarms. Try running Suntray with " -warn" so you are warned when you close Sunbird.

Sunbird 0.3a1

Webdav or Caldav: Which should I choose?

Almost always Webdav. If you're subscribing to any of the holiday files from the project page, or creating an icalx account, these are definitely cases to choose webdav. Anything involving a .ics file is also grounds for choosing webdav. Webdav calendars also have the advantage of Sunbird's backup system. Future versions should be able to answer this question automatically for you.

Where are my backup files?

Sunbird 0.3a1 provides automatic backup files for Webdav (.ics) calendars. These can be found in the 'BackupData' folder inside your profile directory.

I get a (javascript) error when I choose 'Refresh remote calendars'

Errors that look something like this:

Error: [Exception... "'Method not implemented' when calling method: [calICalendar::refresh]" nsresult: "0x80004001 (NS_ERROR_NOT_IMPLEMENTED)" location: "JS frame :: file:///E:/sunbird/components/calCompositeCalendar.js :: anonymous :: line 303" data: no] Source File: file:///E:/sunbird/components/calCompositeCalendar.js Line: 303

occur when you have a caldav calendar in your list. At this point, support for caldav is still being implemented. Please see Calendar:FAQ#Webdav_or_Caldav:_Which_should_I_choose? to make sure that you really want a caldav calendar in this case.

If your error does not involve calICalendar::refresh and NS_ERROR_NOT_IMPLEMENTED please consider reporting it.

I get a (javascript) error when I try to add/edit/delete an event

Your calendar may be in read-only mode. If Sunbird experiences an error working with an ics calendar, it automatically places the calendar in read-only mode to prevent further damage to the data. It should also alert you that this has happened. Alternatively, you can manually place your own calendars (of any type in read-only mode. You can check whether a calendar is in read-only mode by double-clicking on the calendar in the calendar listbox (in the top left, behind the small calendar) and examining the appropriately labeled checkbox.

If your calendar is not in read-only mode and you still experience an error, please consider reporting it.