You are currently viewing a snapshot of www.mozilla.org taken on April 21, 2008. Most of this content is highly out of date (some pages haven't been updated since the project began in 1998) and exists for historical purposes only. If there are any pages on this archive site that you think should be added back to www.mozilla.org, please file a bug.

You are here: Mozilla MailNews Functional / UI Tests > Mail & News: Message labels

Feature Test Spec: Mail and News Component

Mail and News Component: Message labels

Written by Laurel Carlson

Feature description

Method for users to categorize messages in more meaningful and extensive way than with Flag. Label text and color is editable to better fit user's specific need.

References

Labels UI spec:http://www.mozilla.org/mailnews/specs/labels/
Bugzilla query:Open Labels bug reports

General UI components :
1. Menu item Message|Label
  1. Should be available from thread pane, message pane, standalone
  2. Should have a dropdown showing Labels as configured in prefs
  3. Should be available for all account types
  4. Should show color and text for label selectionsnote: color squares on menu probably not available first release - bug 110099
2. Message context menu:
  1. Should be available from thread pane, message pane, standalone
  2. Should have a dropdown showing Labels as configured in prefs
  3. Should be available for all account types
3. Keyboard shortcut access?
4. Label Column in thread pane
  1. Hidden by default
  2. Column heading should be text "Label" instead of an icon
5. Label as Filter action in filter rules dialog
  1. Action dropdown should provide options for each Label (text & color default according to spec)
6. Preferences panel
  1. Label text default according to spec
  2. Label text field editable
  3. Label color default according to spec
  4. Clicking color for a label displays color palette
  5. Button for returning to default colors (not text, too?)
Applying or changing Label
1. From Main menu
  1. Apply a label to message which previously had no label
    - single message selection
    - multiple selection
    - make sure each label can be selected and applied
    - after applying a label the entire message line in thread pane should change to the appropriate color
    - after applying a label the Label column should reflect text for the label
  2. Apply label to message which is already labeled
    - single message selection
      - apply different label than was previously selected
      - apply same label -- should be a no-op, no adverse effects
      - apply None selection from menu
      - after applying a label the entire message line in thread pane should change to the appropriate color
      - after applying a label the Label column should reflect text for the label
    - multiple selection
      - apply different label than previously selected to multiple selection having all same label type
      - apply None to multiple selection having varied label types
      - after applying a label the entire message line in thread pane should change to the appropriate color for all messages in selection
      - after applying a label the Label column should reflect text for the label for all messages in selection
    - make sure each label can be selected and applied correctly
  3. Apply from standalone window, make sure thread pane appropriately updated
2. From Context menu -- ?? Will we have a (body) context menu?
3. Changing via Label Column in thread pane probably not in first release -- see bug 113851
  1. Clicking on the message header in the label column should cycle between the available labels and no label.
    - message pane open
    - message pane closed
  2. Make sure all labels can be selected and applied via label column cycle-through:
    - apply different label
    - apply None
    - apply same label
4. Display characteristic tests for selecting labeled messages -- See spec for visual example.
  1. If message header which has a label is selected, the text color changes to white and the background highlight color is the color of the Label .
    - verify this for all label colors
    - What if user has message displayed and changes color in prefs? (probably no-op until selected again)
  2. If a message is selected and the user adds/removes a Label, there is no feedback that there request was honored until they deselect the message.
5. Perform operations on labeled messages, check for display problems, contrast problems on state change:
  1. Delete message -- make sure next message selected has appropriate color, display attributes, no carryover problems from labeled message
  2. Mark Read/Unread
    - check for column/green diamond visibility
    - Bold text visibility
    - check for status column visibility
    - toggle unread/read state and make sure toggling back and forth causes no display problems
  3. Reply -- check status column
  4. Forward -- check status column
  5. Watch thread -- watch for icon visibility
  6. Download for Offline - watch for icon visibility
  7. Change Views
  8. Change Sort
    - change to Label Sort, verify sort order to spec
    - change among other sorts to verify display is ok
  9. Get New Messages -- check Newness/green arrow visibility
  10. Change column display -- make sure repaints appropriately
  11. Resize thread pane/mail window -- make sure repaints appropriately
  12. Minimize then restore window -- should repaint appropriately
  13. Repeat all the above with each default color
  14. Repeat all the above with various changed colors
  15. Rebuild summary file
6. Label should move with the message
  1. Move
  2. Copy
  3. Drag & Drop
  4. Delete/Move to trash
  5. Move folder with labeled messages to trash, drag back to account
  6. Undo the above actions
  7. Single selection
  8. Multiple selection
  9. Move to same account
    - IMAP -- applied labels should be maintained/visible when logging into account on other machine or profile
    - Webmail: (Note: Server limitation: can't store label. So, Labels lost when moving/copying to other folders same account, won't be seen on same account when shown on other machine.)
    - AOL: (Note: Server limitation: can't store label. So, Labels lost when moving/copying to other folders on same account, won't be seen on same account when shown on other machine.)
  10. Move to another account:
    - Note -- see bug 127141
Changing label name and color (Prefs)
1. Change color only:
  1. single label
  2. multiple labels
  3. all labels
  4. changes appear in prefs:
    - immediately saved on OK
    - maintained through exit
  5. changes appear in Label menu:note:color squares on menu probably not available first release -- bug 110099
    - immediately on OK
    - maintained through exit
  6. changes applied to thread pane:
    - labeled messages
    - label column content
    - label column cycles through labels and shows changes
    - changes in thread pane shown immediately on confirm OK to changes
    - changes in thread pane maintained through exit
  7. changes applied to Filter Action dropdown in filter ui:
    - changes shown immediately on confirm OK to changes
      - try when filter ui is closed while changing labels
      - try when filter ui is open while changing labels
    - changes maintained through exit
2. Change text only
  1. single label
  2. multiple labels
  3. all labels
  4. changes appear in prefs:
    - immediately saved on OK
    - maintained through exit
  5. changes appear in Label menu:
    - immediately on OK
    - maintained through exit
  6. changes applied to thread pane:
    - labeled messages
    - label column content
    - label column cycles through labels and shows changes
    - changes in thread pane shown immediately on confirm OK to changes
    - changes in thread pane maintained through exit
  7. changes applied to Filter Action dropdown in filter ui:
    - changes shown immediately on confirm OK to changes
      - try when filter ui is closed while changing labels
      - try when filter ui is open while changing labels
    - changes maintained through exit
3. Change both text and color
  1. single label
  2. multiple labels
  3. all labels
  4. changes appear in prefs:
    - immediately saved on OK
    - maintained through exit
  5. changes appear in Label menu:
    - immediately on OK
    - maintained through exit
  6. changes applied to thread pane:
    - labeled messages
    - label column content
    - label column cycles through labels and shows changes
    - changes in thread pane shown immediately on confirm OK to changes
    - changes in thread pane maintained through exit
  7. changes applied to Filter Action dropdown in filter ui:
    - changes shown immediately on confirm OK to changes
      - try when filter ui is closed while changing labels
      - try when filter ui is open while changing labels
    - changes maintained through exit
4. Reset to default (color only?)
  1. single label
  2. multiple labels
  3. all labels
  4. changes appear in prefs:
    - immediately saved on OK
    - maintained through exit
  5. changes appear in Label menu:
    - immediately on OK
    - maintained through exit
  6. changes applied to thread pane:
    - labeled messages
    - label column content
    - label column cycles through labels and shows changes
    - changes in thread pane shown immediately on confirm OK to changes
    - changes in thread pane maintained through exit
  7. changes applied to Filter Action dropdown in filter ui:
    - changes shown immediately on confirm OK to changes
      - try when filter ui is closed while changing labels
      - try when filter ui is open while changing labels
    - changes maintained through exit
Filter Action
1. Change label properties doesn't adversely affect existing filters:
  1. Check filter rules dialog for existing filters
    - immediately on label change
    - within session of label change when filter fires
    - maintained through exit
  2. Check filter file on disk (rules.dat) for existing filters
  3. Get New Messages which will fire the existing filters:
    - make sure filter changes to changed label text or color appropriately
    - no other weird effects on filters
Additional tests/notes:
1. Tests should apply (unless otherwise noted) for messages in various types of accounts:
  1. IMAP
  2. POP
  3. Local Folders
  4. News
  5. Webmail: (Note: Server limitation: can't store label. So, Labels lost when moving/copying to other folders same account, won't be seen on same account when shown on other machine.)
  6. AOL: (Note: Server limitation: can't store label. So, Labels lost when moving/copying to other folders on same account, won't be seen on same account when shown on other machine.)
  7. New profiles
  8. Migrated profiles
2. Label column should be hidden for Search Messages UI
3. Labels available in Quick Search
4. Priority Column now has no color so as not to conflict with Label colors