MachV/Mozilla: Mail: Folders	UI Specification
Folders	Last Modification:

Author: Jennifer Glick Creation Date: 06 November 2001	Status: Draft
Quicklinks:      Properties          General          Offline          Character Coding          Sharing      New      Rename	Feature Team: Engineering:   Scott Putterman Product Marketing:   Kevin Murray QA:   Esther Goes Docs:  Robin Foster Clark  UE:   Jennifer Glick Please post all comments and suggestions regarding this spec to the newsgroup, netscape.public.mozilla.mail-news.

Bugs

1. 10877 - UI: Folder property dialogs.
2. 44104 - Creating a new folder with a duplicate name behavior 
3. 45041 - clean up text of alert dialog when user does "New Folder" with duplicate name.
4. 67606 - Folder properties dialog should allow renaming.
5. 83316 - finish string changes for "folder properties" dialog.

Open

Design Details

1. Folder Properties

a. General

• Special folder names (Inbox, Trash, Drafts, Sent, etc.) can not be edited.
• "Check this folder for new messages" only appears for IMAP folders and does not appear for an IMAP Inbox folder.
• "Check this folder for new messages" - IMAP only. In addition to the Inbox box, the folder is checked for new messages based on the users setting for "check for new msgs" interval plus whenever they click "Get Msgs". If this checkbox is unchecked, the folder is checked for new messages when it is selected. Enabling this checkbox may cause performance issues depending on the number and size of enabled folders.

b. Offline

c. Character Coding

d. Sharing - IMAP

The shared tab describes the current state of sharing for the folder and provides access to setting up shared folders and privileges.

There are three different kinds of folders: Personal folders, Shared folders and Public folders. (this true?)

The "Set Privileges" button is used to enable sharing and setup access permissions for the folder and for other users of this folder. This causes the browser to load the Server based ACL UI. This button is only available when the server the user is connected to supports ACL management. 

If the server does not support ACL's at all, then the following text is displayed: "This server does not support shared folders." The Set Privileges button, as well as the Folder type, Shared and Permissions text are not displayed.

To add messages to a personal shared folder or to a folder that a user has write permission to, messages should be dragged from the thread pane to the desired folder.

Setting Folder Permissions (ACL) - Folder permissions are administered completely from the server UI. 

Folder Icons

When a folder has been set to be shared, its icon should appear differently in the Mail folder pane. (See Marlon Bishop to obtain the files. Work should already be completed.)

2. New Folder Dialog

Folder creation and naming is done using the "New Folder" dialog. Within Mail, using the drop down menu, "File", "New", "Folder". Within the Folder Pane, using the context menu, "New Folder...". Folders cannot be created at the top level of the mail panel (account level).

The "New Folder" dialog lets the user choose the parent of the new folder. The default parent is either the current folder selection in the Mail Folder Panel (if applicable) or the default account.

Folder Already Exists

If the user attempts to create a folder with a name which already exists in the current location, the following dialog is displayed. When the user OK's the dialog, the New Folder dialog reopens with the the duplicate folder name highlighted.

3. Rename Folder

Folders can be renamed directly inline (not implemented) in the Folder Pane or in the Folder Properties dialog.

Special folders and default Local Folders can not be renamed. These include: Special Folders (Inbox, Sent, Trash, Drafts) and default Local Folders (Unsent Messages, Templates, Trash).

Folders are renamed using the Folder Properties Dialog. This dialog is opened by either selecting "Properties" in the Folder Pane context menu, or by selecting "Folder Properties" from the "Edit" drop down menu.

To rename a folder inline within the Folder Pane, the user selects the desired folder and uses the context menu to select "Rename". The folder name should now appear with a box around it and the folder name highlighted. The user can now type the name of the new folder. Clicking outside the folder boxed area cancels the action. Once the user has renamed the folder, he/she must click outside the folder boxed area for the new name to take effect. When the user clicks outside the folder boxed area the renamed folder is correctly placed in its new alphabetical location in the folder hierarchy and focus remains on the folder.

Folder Already Exists

If the user attempts to rename a folder with a name which already exists in the current location, the following dialog is displayed. 

When the user OK's the dialog, the Rename Folder dialog reopens with the the duplicate folder name highlighted.

Issues