Messages
From Openmoko
| Not implemented: This article or section documents one or more features that are not implemented and which may never be implemented. |
Contents |
Overview
This article defines the Messages Application, an extensible application designed for the OpenMoko platform. The Messages Application is the central location to create and store message (email and SMS) related information. This is a Native Stylus-Based application.
Use Cases
Here are some possible use cases:
- I want to send a text message to an existing contact
- I want to send a file (Picture, Drawing, ...) within a message
- I want to store messages in personally-defined folders
- I want to add multiple existing email accounts
- I want to have IMAP4 support.
- I want to have POP support.
- I want to search messages (sms and email) by strings and/or by contact (e.g.: i want all messages which contains the word "tomorrow", or i want all messages from my contact "John")
Layout Components
- 1) Application Menu -- Additional options related to message objects.
- 2) Filter_Menu -- Filtering options for the list of messages.
- 3) Navigation Area -- List of messages based on current filter.
- 4) Toolbar -- Primary commands available to messages.
- 5) Details Area -- Detailed view of current selected message.
Application Area
Application Menu
| Item | Action | Constraints |
|---|---|---|
| Message Membership | Specify messages existing within current folder | Grayed-out when zero custom folders are defined |
| Folder Rename | Rename the current folder | Grayed-out when zero custom folders are defined or active folder is not a custom folder. |
| Accounts | Opens Dialog to view / modify all accounts | |
| Help | Opens Help Viewer Application with help for this application |
Filter Menu
| Item | Action | Constraints |
|---|---|---|
| Inbox | Displays all messages from the Inbox folder | |
| Outbox | Displays all messages from the Outbox folder | |
| Drafts | Displays all messages from the Drafts folder | |
| Sent | Displays all messages from the Sent folder | |
| <folder> | Displays all messages from this folder | |
| Search Results | Displays all messages matching current search string |
Navigation Area
Displays list of messages from current folder using the Navigation Widget. Has the following structure:
| Item | Action | Constraints |
|---|---|---|
| Column 0 | Displays the message status icon (replied, forwarded, etc...) | |
| Column 1 | Displays the recipient message field | Bold if unread |
| Column 2 | Displays the subject message field for emails, or a portion of the body for all other message types | Bold if unread |
Tap selecting a row, will display correspoding message information in the Details Area.
Toolbar
Search
Search reindexes, after every keypress, the message membership of the Search Results Folder.
Action Buttons
| Item | Action | Constraints |
|---|---|---|
| New Email | Activates New Message Mode (Email) for Details Area. Creates new Draft message | Performs no action when pressed repeatedly |
| New SMS | Activates New Message Mode (SMS) for Details Area. Creates new Draft message | Performs no action when pressed repeatedly |
| New Folder | Opens Dialog prompting for folder Name |
| Item | Action | Constraints |
|---|---|---|
| Mode Read | Activates Read Mode for Details Area | |
| Mode Reply | Activates Reply Mode for Details Area | |
| Mode Forward | Activates Forward Mode for Details Area |
| Item | Action | Constraints |
|---|---|---|
| Get Email | Opens Dialog to show status. |
| Item | Action | Constraints |
|---|---|---|
| Delete Message | Opens Dialog prompting for confirmation | Grayed-out when zero message exist |
| Delete Folder | Opens Dialog prompting for confirmation | Grayed-out when zero custom folders are defined or active folder is not a custom folder. |
Details Area
A Details List that behaves different in each of the following modes:
View Mode (Email)
- 1) Email Header -- The header information for the current email.
- 2) Email Body -- The body content for the current email. When an email countains an attachment the Save button is visible. Clicking will open the File Save Dialog.
The attachment can be previewed by clicking on the right arrow:
View Mode (SMS)
- 1) SMS Header -- The header information for the current SMS.
- 2) SMS Body -- The body content for the current SMS.
New Mode (Email)
- 1) Title Bar -- Shows the dialog's name
- 2) Email Toolbar -- Actions available for the current email. (Send, Attach, Address, Cancel)
- 3) Email Header Fields -- The header fields for the current email.
- 4) Email Body -- The body content for the current email.
New Mode (SMS)
- 1) Title Bar -- Shows the dialog's name.
- 2) SMS Toolbar -- Actions available for the current SMS.(Send, Address, Cancel)
- 3) SMS Header Fields -- The header fields for the current SMS.
- 4) SMS Body -- The body content for the current SMS.
- 5) Character / SMS Counter -- The total number of characters remaining in the current SMS, and the current SMS number.
Reply / Reply to All Mode (Email)
- 1) Title Bar -- Shows the dialog's name.
- 2) Email Toolbar -- Actions available for the current email.(Send, Attach, Address, Cancel)
- 3) Email Header Fields -- The header fields (completed) for the current email.
- 4) Email Body New -- The body content for the current email.
- 5) Email Body Replied -- The part of the original email being replied to.
Reply Mode (SMS)
- 1) Title Bar -- Shows the dialog's name.
- 2) SMS Toolbar -- Actions available for the current SMS.(Send, Address, Cancel)
- 3) SMS Header Fields -- The header fields (completed) for the current SMS.
- 4) SMS Body -- The body content for the current SMS.
- 5) Character / SMS Counter -- The total number of characters remaining in the current SMS, and the current SMS number.
Forward Mode (Email)
- 1) Title Bar -- Shows the dialog's name.
- 2) Message Toolbar -- Actions available for the current message.(Send, Attach, Address, Cancel)
- 3) Message Header Fields -- The header fields (completed) for the current message. Based on type of message.
- 4) Message Body New -- The body content for the current message.
- 5) Message Body Forward -- The part of the original message being forwarded.
Forward Mode (SMS)
- 1) Title Bar -- Shows the dialog's name.
- 2) SMS Toolbar -- Actions available for the current SMS.(Send, Address, Cancel)
- 3) SMS Header Fields -- The header fields (completed) for the current SMS.
- 4) SMS Body -- The body content for the current SMS.
- 5) Character / SMS Counter -- The total number of characters remaining in the current SMS, and the current SMS number.
Message Membership Mode
- 1) Membership radio -- When selected, the selected message will be moved to this folder.
- 2) Selected Message -- The current selected message.
Footer Area
Status Bar
Displays the total number of messages in the current folder.
Constraints
(TBD)
Sessions
- The current message selection is persistant.
Architectural Details
- Valid message fields are defined in the PIM Storage.
- When a new message is created it is automatically saved into the Drafts folder.
Implementation Recommendations
See: Wish_List#Text_Messaging Interoperability to the Bluetooth powered Multi-SIM support project? --Minime 02:00, 18 May 2007 (CEST)
Interactions
(TBD)
Icons
Download the Action Icon : click here
- Delete Folder.png -- Delete Folder
- Delete Message.png -- Delete Message
- Drafts.png -- Draft
- Folder.png -- Folder
- GetMail.png -- Get Mail
- InBox.png -- Inbox
- Mode Forward.png -- Forward Mail
- Mode Read.png -- Read Mail
- Mode Reply.png -- Reply Mail
- New Folder.png -- New Folder
- New Mail.png -- New Mail
- New SMS.png -- New SMS Messages
- OutBox.png -- Out Box
- SearchResults.png -- Search Results
- Send.png -- Send
- Unread.png -- Unread
Download the Messages Icon : click here
- Address.png -- Email Address
- Attached.png -- Attached file
- Cancel.png -- Cancel
- Send.png -- Send
- Zip File.png -- Zip File
UI Position
Unresolved Issues
(None)
Questions and Answers
(None)
