On a desktop machine if you browse to the address given you by the administrator, you'll get the login
screen where you can authenticate with your imap username and password to access your email.
If you tick the Remember box a cookie is written to your browser. Depending on the browser's
configuration, the Username field may be pre-filled next time you access the page. The link on
the top left is there in case you arrived here using a small screen device; it will take you to the mobile
This is where you land after a successful login and where you can quickly return to from the left most link on
the navigation bar.
From top working down, you see that the INBOX has 3 messages, one of which has not been read. The already
mentioned navigation bar takes you to the other parts of the app as well as returning you here. Next the pre-exisiting folders
and mailboxes are displayed. Folders, which can contain mailboxes are shown on the left and Mailboxes which contain
messages on the right. Below here are options to delete selected folders or mailboxes, move mailboxes from their
logical position inside the INBOX to another folder and create new folders or mailboxes. Finally the icon at bottom
right shows that the Trash folder is not empty.
In this state (not empty), the icon is a link that will take you to a list of messages in the Trash folder. The
INBOX icon is also a link as are the folders and mailboxes in their respective lists. Be aware that
deleting mailboxes and folders removes all messages and sub folders; unlike deleting a message, which
actually moves it to the trash folder (see Message lists),
there is no warning or second chance.
in the navigation bar and you'll be taken to this screen, which initially displays
the default settings for each user.
You'll want to replace the Mail identity with one or more of your own email addresses. Note that you cannot
delete the default until at least one alternative is in place. This is because it's not possible to send email
without this setting.
If you select a different language all the screens (except the login page) will be translated accordingly. Note
that by default Trash messages are automatically deleted when you logout; if you stick with this, although deleting
messages from other mailboxes actually moves them to Trash, on logging out, they really will be gone.
By default, sent mail is not archived to an Outbox and there is no Draft folder for
saving messages (even if there is a mailbox of that name); you'll probably want to select
mailboxes for these roles, possibly creating them first back in the app's
Message display options:-
- 1. geek - plain text only display including the structure of the message
- 2. plain text - the default, a standard plain text display
- 3. block images - html messages displayed as such with all images blocked
- 4. in line images only - in line, but not remote images are displayed
- 5. allow all images - html messages displayed with remote images and stylesheets.
Options 1. and 2. are reliable.
Options 3. - html display without images mostly works as webmail tries to filter out style options
known to mess up it's appearance, but it's possible some will still cause problems.
I'd appreciate receiving a copy of these so the issue caused can be fixed.
Option 4 - displaying in line images is also reliable; email with these images seems to be one of
two flavors. Firstly a misplaced idea in my opinion of company branding and a waste of bandwidth or
a photo added to the email sent from a phone (possibly a similar waste!).
Option 5. (and html email in general) is a poor choice in my opinion, but displaying remote images
is not problematical if that's what you want. Suggested reading
in this regard. Also note that as described in the Reading messages
a section, a sensible user, who selects options 1 or 2 here can quickly switch to option 3 to read an individual
You must press the Update button to make changes stick. Don't forget to do this after changing
IMPORTANT! - any problem with deleting messages failing silently (no warning in red text) is probably
due to this issue. The same applies to an attempt to create a mailbox or
folder failing without warning.
Here's an mailbox with 3 messages; looking directly below the navigation bar you see this is the INBOX, but listings
of all the mail boxes will appear the same.
You can Select all messages for a mass Delete or Move to; that can also be done on an
individual basis by checking boxes on the left as appropriate. Delete is actually a move to Trash
except for messages already there, when it really is a delete. Looking at the three individual messages, you see that two
have been read R and the third has been answered A. The first message has an attachment, which
is indicated with *.
All are sent using firstname.lastname@example.org as the from address, so there's little point (even if there were more messages!)
in changing the sorted by setting to list messages by from address. The setting shown is not the default
(rather Date oldest first), when this is changed the selection sticks automatically for all mailboxes and is remembered
even if you logout.
Search allows you to create a list of messages from the current mailbox which contains your search term in the
body of the message. Clicking on the subject of a message displays it
(see Reading messages) and to the right,
delivery date and message size are displayed.
The appearance of messages depends on the setting chosen in Settings.
This mail is a phishing attempt; it's the third
#3 message in the folder named specimen which means it's the most recent as chosen sort order has no bearing on
this. The current message display setting is option 1 geek so there is information about the structure of
the message; lamentably as well as being an attempt to steal, there is also no plain text part, so jwma has
to parse the marked up html. If the plain text / html toggle is selected, the html is displayed without images, ie
equivalent to setting option 3.
If in Settings an unwise user selects
5 allow all images, the messages is displayed as the sender intended (more or less, although some
styling may be removed to avoid unwanted changes to the appearance of Jwma itself) and since remote
images have been fetched, his email address may now be marked as known to be live in a spammers database.
The screen will be the same for messages in all other mailboxes including the INBOX, except in a mailbox you designated
to be Draft
, when a compose window
will be opened with the saved message already in place.
Top and bottom to the far right are widgets for cycling through the messages in the current mail box and
presenting this message in a screen suitable for printing. If clicked, the icon, far right
from the subject will reveal (or conceal) the message headers. Here's the headers of the same message,
they appear above the body of the message.
If you enabled Automatically quote in User Configuration,
the Toggle auto-quote is useful for turning this off if you want to reply without reference to the
If you tick the With Attachments box, Forward to sends messages on mostly unaltered,
leaving the recipients email client to decide how to display them. More on this in the
Here's a second example email, shown both with settings 1 and 2 selected.
Setting 1 displays the plain text part of the message and notes the presence of other parts.
Setting 2 omits what might be considered to be this extraneous information. Although
supporting html email standards is not of particular concern to jwma, it generally does a pretty fair job
at this. This particular email is unusual in that the content of the text/plain and text/hml parts
are not identical. Here's the same message in it's full html glory (using setting 5 - allow all images).
Lastly, here's a third mail using setting 2; it has three images attached in line.
With out going to the Settings page, they can be displayed by selecting one of the Display image:
links, which temporarily switches you to allowing in line images (setting 4).
Irrespective of display option, attached files and in line images also, are presented as downloadable
As standard Jwma creates and sends messages as plain text
The rich text link replaces the text area with an embedded html editor
to allow the creation of html messages.
If you use the Browse button to add a file attachment, two further file selectors will
appear automatically, giving the option to attach up to three files. If an attachment is an image file
many email clients (including jwma if Setting 4 or 5 are used for reading messages) will diaplay the
image as well as creating a download link for it.
Save Draft allows you to save a partially complete message into the folder you configured as
described in the User configuration.
section. If you have not done this a a warning is displayed. It is not functional if rich text
was selected. A work around is to write and save a plain text message; when you reopen it from the draft
folder you can switch to rich text and apply the markup as you want.
No attempt is made to display forwarded messages before they are sent on; you see that the subject
and recipient have been rewritten and a preamble stating that this is a forwarded message. You can edit
this preamble before sending, but apart from removing any attachments (unless you ticked the box as
described above) (see With Attachments box note)
the original message is included unaltered.
The Rich Text Toolbar
The use and function of most of the supplied tools is obvious from their similarity to those supplied
with many other applications -generally select the text to be affected and click the button. Hovering over the buttons
will bring up a tooltip for extra clarification. A few do benefit from a little extra information:-
To create a link, enter the text for the link eg download
and select it before
pressing the link
button. This brings up a dialogue box:-
This is the email written and ready to send:-
Before we do that here's the result of pressing the htmlmode
button, which toggles between the above view and html source code.
Lastly this is how jwma displays this message with Message display option set to 5:-
This simply allows you to store a list of contacts with email addresses. Clicking on the email address takes you
to the compose window, with the To field
Managing folders and mailboxes
To create a new top level mailbox type a name such as test mailbox in the input field adjacent to the drop down list
and press the Create new button.
You can use the / character to create a nested mailbox. If you enter test folder/test mailbox in the
input field, that will create both a new folder and a new mailbox within it.
If you use an already exiting folder name, just a new nested mailbox is created; after pressing Create new
with test folder/another mailbox in the input field, the single test folder will now contain
You can create an empty folder without creating a mailbox at the same time by selecting Folder from
the drop down list.
Folders and mailboxes are deleted by checking the appropriate box and pressing the Delete button.
Care is needed as without warning all mailboxes nested within a folder are removed as are all messages within a mailbox.
Top level mailboxes and all the messages they contain can be nested in a folder by checking the appropriate box, selecting the folder from
the drop down list and pressing the Move to button. Nested mailboxes cannot be moved directly, but
they can be deleted after all messages in them have been moved.
The small screen interface
If you access Jwma using your smart phone, you should be automatically directed to an alternative
interface, but as a fall back the login screen of each interface allows you to switch manually.
Compared to the desktop interface there are optimizations both in layout and in a reduction of the feature
These screenshots where taken from a galaxy 2 running cyanogenmod; the mobile interface looks pretty
much the same on the iphone.
A successful login takes you directly to the INBOX rather than a folder listing. The folder list
is accessible in the same way as on the desktop interface (the first left navigation icon) a major
difference being that type 2 mailboxes (ie folders containing mailboxes) and the mailboxes they hold
are not accessible. Other differences include the absence of a save draft option, no option to create
html mail, message lists are displayed in recent first order and message display being set to plain text
There is no contradiction between the two interfaces in that their settings do not clash. Any type
2 mailboxes you created via desktop access remain untouched by small screen access and if you normally
read messages using some setting other than plain text, that setting will remain in place for desktop