1: <h2>Calendar Folders</h2>
4: <b>Calendar Folders</b> is an extension for future versions of Mozilla Calendar and Sunbird.
5: It provides a way to group calendars in folders.
6: It also provides a clock.
9: <img src="./calfo0.png" style="margin-left:2em;">
12: For installation instructions, see the <a href="#install">bottom</a> of this page.
16: The current version of Calendar Folders is a prototype for Sunbird 0.2+ test builds only.
20: In this prototype, some features do not work at all and some others are buggy.
24: There is no version of Calendar Folders for the current release, Sunbird 0.2,
25: and there is no version for any Calendar extensions or Lightning.
30: The <b>Calendar Folders</b> project is a subproject of <b>Calendar Help</b>.
33: <h3>Why use Calendar Folders?</h3>
35: Use Calendar Folders when you often work with many calendars,
36: so that you can easily view groups of calendars at the same time.
40: <div style="margin-left:-4px; padding:4px; border:1px inset #f99; width:40em;">
42: You work on two projects, codenamed <i>Alum</i> and <i>Borax</i>.
43: You have three colleagues Cedric, Daisy and Evan in your department.
44: Cedric also works on Alum and Borax, but Daisy only works on Alum and Evan only works on Borax.
48: Each of you has a personal calendar and a calendar for each project.
49: The project calendars are shared on a server.
50: So there are ten calendars in all:
51: four personal calendars, and six shared on the server.
55: In Sunbird, you can work with your personal calendar and the six shared calendars.
56: (You cannot work with other people's personal calendars.)
60: Here the seven calendars that you can work with:
62: <img src="./calfo1.png" style="margin-left:2em;">
64: <h4>Working with your own calendars</h4>
66: To work with your own three calendars, you place them in a folder named Me:
68: <img src="./calfo2.png" style="margin-left:2em;">
71: When you select this folder, you see these three calendars but no others.
72: The default calendar for new entries is Personal.
75: <h4>Working with project calendars</h4>
77: To work with project calendars, you place them in folders:
79: <img src="./calfo3.png" style="margin-left:2em;">
82: When you select a project folder, you see the calendars for that project but no others.
83: The default calendar for new entries is your calendar for the selected project.
87: Using Calendar Folders, you can also give the calendars different names and different
88: colours in each folder.
94: <h3>Default folders</h3>
96: When you install <b>Calendar Folders</b> and restart sunbird,
97: you two folders are created automatically, named <i>All</i> and <i>Default</i>.
101: The folder All is a special folder that contains all you calendars.
102: It is very like Sunbird's original Calendars list.
103: You cannot delete this folder (but you can rename it).
107: The folder Default contains whatever calendars are active when
108: <b>Calendar Folders</b> first runs.
109: You can work with this folder just like any other folder.
113: <h3>Working with calendars and folders</h3>
115: To work with calendars and folders, use the entries in the
116: Calendar Folders list, and use the context menus.
117: (To obtain a context menu, you can right-click, or use the Menu key
118: on your keyboard, or use some other method depending on your system.)
122: <h4>Creating and maintaining a folder</h4>
124: To create a new folder, choose New Folder from the context menu.
126: <img src="./calfo4.png" style="margin-left:2em;">
129: Give the new folder a name.
131: <img src="./calfo5.png" style="margin-left:2em;">
134: To populate the new folder, drag calendars from the All folder and drop
135: them in the new folder:
139: To specify the default calendar for new entries in the folder,
140: click one calendar's icon.
141: The icon displays a radio button to show that it is the default.
145: To remove a calendar from the folder, drag it back into All.
149: <h4>Changing calendar properties</h4>
151: The names and colours of calendars apply within a folder.
152: So a calendar can have a different name and a different colour
153: depending on the folder.
157: For example, in each project you might name the project manager's
158: calendar Project Manager, and colour it blue.
159: Suppose you are the project manager in one project.
160: In that project's folder, your calendar is named Project Manager and
161: has the coloour blue.
162: But in other folders the same calendar has a different name and colour.
166: This feature can be confusing.
167: Only use it if you have a specific purpose for different names and colours.
171: To rename a calendar, select it in the Folders panel, then click on its name.
172: To change a calendar's colour, click on its colour patch in the Folders panel.
176: To reload a remote calendar, click on its reload marker (a small blue circle at the
177: right of its colour patch).
182: To set options for Calendar Folders, choose Tools – Options... from the menu bar.
183: Go to the Folders page.
187: Choose whether to display tabs for the clock and the original Calendars list.
191: Specify how to display the date and time in the clock.
192: To use your operating system's settings, uncheck the Long box for the date
193: and choose System for the time.
197: To ensure that only one folder can be selected at a time, check the Single folder box.
201: To lock calendar names or colours so that they remain consistent between folders,
202: check the Name or Color boxes.
206: <h3 id="install">Installing Calendar Folders</h3>
208: To install Calendar Folders, choose Tools – Extensions... from Sunbird's menu bar.
209: Drag this link and drop it in the Extensions window:
212: <p><a href="http://downloads.mozdev.org/calendarhelp/calfolder-0.1-en-US.xpi">calfolder-0.1-en-US.xpi</a></p>
215: Restart Sunbird.
216: If the installation succeeds, you see the About Calendar Folders window.
217: To dismiss it, click on the background of the window (or press Escape).
220: <h4>Uninstalling Calendar Folders</h4>
222: To uninstall, return to the Extensions window.
223: Select Calendar Folders and press the Uninstall button.
224: Close Sunbird.
228: Go to your profile directory and delete the file <code>calfolder.rdf</code>.
229: Edit the file <code>prefs.js</code> and remove all the entries that contain <tt>calfolder</tt>.
230: Restart Sunbird.