Documentation/User Guide

Contents 1 About the User Guide 1.1 Bongo 1.1.1 Features 1.2 Document Conventions 2 Your Account 2.1 Logging in 2.2 Logging out 2.3 Changing your Preferences 2.3.1 Timezone 2.3.2 Email Signature 2.3.3 Changing your password 3 Contacts 3.1 Adding a contact 3.2 Finding a contact 3.3 Adding/Editing a contact's information 3.4 Removing a contact 4 Mail 4.1 Reading messages 4.2 Writing messages 4.2.1 Drafts 4.2.2 Message Actions 4.2.2.1 Replying to All Recipients 4.2.2.2 Replying to Sender 4.2.3 Replying to mailing list (where applicable) 4.2.3.1 Forwarding messages 4.3 Managing attachments 4.4 Adding a signature to outgoing mail 4.5 Starring mail 4.6 Archived Mail 5 Calendar 5.1 Creating an Event 5.2 Viewing Events 5.2.1 Changing Views 5.3 Creating a new Calendar 5.4 Subscribing to Calendars 5.5 Sharing Calendars 5.5.1 Sending Invitations 6 Address Book 7 Configuring a desktop client 7.1 Evolution 7.2 Mozilla Thunderbird 7.3 Apple Mail 7.4 Microsoft Outlook

[edit] About the User Guide

This guide describes Bongo's default Dragonfly web client interface.

[edit] Bongo

Bongo is a standards-based messaging system that provides e-mail, calendaring, and schedule sharing across the Internet. Users can connect to the Bongo messaging system over the Internet to access their e-mail messages, view their calendar, schedule appointments, and to send messages, tasks, or notes.

To connect to the messaging system, users must have an Internet e-mail client. Bongo provides one client interface, Dragonfly, that can be accessed through any Internet-standard browser. However, because Bongo supports Internet-standard messaging and security protocols, users can also continue to use their current POP3 or IMAP4 e-mail client. In addition to the client-side services, Bongo provides a flexible, easy-to-use administrative interface that can be accessed through any Internet-standard browser.

[edit] Features

Bongo provides and easy-to-use, Web-based email and calendaring interface, with a wide range of communication and collaboration capabilities such as resource scheduling, calendar sharing. Dragonfly (Bongo's user interface) is designed for users with Javascript-enabled browsers, and is geared towards moderate to high speed internet connections.

[edit] Document Conventions

In this documentation, a greater-than symbol (>) is used to separate actions within a step and items within a cross-reference path.

[edit] Your Account

This section describes the process of logging in and out of your Bongo session and highlights some security issues involved. This section also describes how to change your own user preferences once you have logged in.

It is required that you login with a valid username and password before you can perform any tasks with Bongo.

[edit] Logging in

To login, simply:

• Open up your preferred web browser.
• Navigate to your Bongo installation (provided by your local administrator).
• Enter your supplied username and password into the appropriate text boxes. If you're not using a public computer, you might also choose to check the 'Remember me' box (you will have to enable cookies in your browser for this to work).

• If you are using a language other than the server's default choice (normally English), pick a different one from the Language drop-down box.
• Click the 'Log In' button to authenticate yourself and display your personalized Summary screen.

[edit] Logging out

Logging out can be achieved by clicking the 'Log Out' link, located at the top of the sidebar on all pages. Once you return back to the login screen with a confirmation message, you can close your browser.

Remember, that closing your browser after you have finished working with Bongo, but before you have logged out, does not end your session. This poses a severe security risk, whereby the next person to use the computer could also access your session. Always remember to end your session by clicking the 'Log Out' link before closing your browser.

[edit] Changing your Preferences

The following tasks assume that you are in the preferences view in the web interface. This can be achieved by clicking on the 'Preferences' link at the top of the interface, next to your username.

[edit] Timezone

To change your timezone, pick the correct timezone/location from the drop-down box located on the General (first) tab of the preferences screen. Once you have selected the timezone you wish to use, click OK.

[edit] Email Signature

To edit your email signature, click on the Composer tab from within the preferences screen. Enter the signature you would like to be appended to outgoing messages into the 'Signature' box.

If you would like to attach this signature to all outgoing mail, check the box below, "Apply to outgoing mail".

[edit] Changing your password

Changing your password cannot currently be achieved by either the user interface, or the administration interface. Please contact your system administrator if you would like to change your password.

[edit] Contacts

This section describes how to manage your contacts in Bongo. All contact management is performed through the 'contacts' section of the sidebar.

This chapter describes how to acomplish the following tasks:

• Create a contact
• Add or edit a contact's information
• Delete a contact
• Locating a contact

[edit] Adding a contact

To add a new contact, click the Add Contact link located at the bottom of the Contact section of the sidebar. Using the popup that appears, enter the contact's name into the first-most text box. If the contact you are adding is yourself, check the 'This is Me' checkbox. Fill in the other textboxes as required.

When mail arrives into your Inbox from any of your contacts, their email will automatically be listed on your Summary page in a box titled "Mail from my contacts".

[edit] Finding a contact

Finding a contact can be achieved in two ways. You can either find a contact using one of three ways:

• scrolling down your contacts list alphabetically;
• filtering out contacts by entering text in the Filter textbox; or
• using the main Search box located at the top of the screen.

The Filter textbox is located just above the main contacts list. As soon as you enter a few letters, the contacts list will filter out unnecessary contacts, leaving behind only those that you were looking for.

[edit] Adding/Editing a contact's information

To modify a contact's information, first find the contact you wish to edit (see section 'Finding a contact').

Once you have selected a contact form the list by left-clicking on it, you can begin entering the contact's information into the textboxes available.

[edit] Removing a contact

To remove a contact, first locate the contact you with to delete (see the section labeled 'Finding a contact').

Once you have selected a contact from the list by left-clicking on it, click the button titled 'Delete' located on the popup that appears.

[edit] Mail

This section describes how to manage your email messages. Bongo's primary function is the ability to send and receive mail. This chapter covers the following tasks:

• Sending and receiving your messages,
• Writing, replying and forwarding messages, and
• Managing mail attachments

[edit] Reading messages

To read a message, first make sure you are in the Mail interface of Bongo, by selecting the Mail heading on the sidebar. You can then read your messages by clicking on any of the messages that appear in the mail folder list.

[edit] Writing messages

To begin composing a message, click the 'Compose new mail' subheading located below 'Mail'. A new interface will appear, allowing you to enter your message, add attachments, and specify the recipients of your message.

There are a few text fields located on the 'Compose new mail' page. They are outlined below:

Field	Purpose
To	The recipients of whom the message is addressed to.
Cc	'Carbon copy'. Allows you to send this message to other recipients, but not those who are being addressed in the message.
Bcc	'Blind carbon copy'. Unlike To and Cc, addresses in the Bcc field cannot see the email addresses of the other recipients of the message. Otherwise, this field is identical to the Cc field.
Subject	Short description of the message's subject.

TODO: Finish this chapter..

[edit] Drafts

Drafts can be saved in two ways:

• Clicking the 'Save draft' button at the bottom of the mail composition page; or
• Being automatically saved by Bongo by attempting to navigate away from the mail composition page, without saving your message.

[edit] Message Actions

TODO: Describe action bar and what each action does..

[edit] Replying to All Recipients

To reply to a message, and send your reply to all the recipients listed on the message's recipient list, find the message you wish to reply to, and:

• Display the message by clicking on the message's title, and click the 'Reply to All' button located on the action bar above the reply (if any) that you wish the reply to.

Once you have clicked the 'Reply to All' button, a new message interface should appear, allowing to enter your reply to the email, with the contents and recipient(s) of the email already pre-formatted. For more information regarding writing and sending messages, see the 'Writing messages' section.

[edit] Replying to Sender

To reply to a message, and send your reply to only the orignal sender, find the message you wish to reply to, and:

• Display the message by clicking on the message's title, and click the 'Reply to Sender' button located on the action bar above the reply (if any) that you wish the reply to.

Once you have clicked the 'Reply to Sender' button, a new message interface should appear, allowing to enter your reply to the email, with the contents and recipient(s) of the email already pre-formatted. For more information regarding writing and sending messages, see the 'Writing messages' section.

[edit] Replying to mailing list (where applicable)

[edit] Forwarding messages

To forward a message:

• Open the mail message that contains the text body you want to foward.
• Find the correct reply (if any), and click the 'Forward' button located on that message's action bar.
• Enter the message text and recipients to the preformatted 'forward' message (see section 'Writing messages').
• Click Send.

[edit] Managing attachments

[edit] Adding a signature to outgoing mail

This feature is currently unavailable using the Dragonfly user interface. Please wait until this feature ends up in the 'store' source tree.

[edit] Starring mail

[edit] Archived Mail

[edit] Calendar

TODO: This section requires cleanup and detail expansion!

This section describes how to use the Calendar section of Bongo properly.

[edit] Creating an Event

To create a new event, first locate the day you want the event to start on the calendar, and double click approximately where the event is supposed to start. Fill in the information on the popup, and click 'Save'. The event will appear on the calendar.

You can drag and drop the event to a suitable place in time if it moves day or time. To edit with more detail/precision, double click the event to bring up the popup again, and edit details as desired.

[edit] Viewing Events

[edit] Changing Views

• Day
• Upcoming
• Week
• Month

[edit] Creating a new Calendar

[edit] Subscribing to Calendars

[edit] Sharing Calendars

To share a calendar, first choose the calendar you wish to share. See the 'Creating a new calendar' section if you wish to create a new calendar to share.

Once you've chosen a calendar, click the 'lightbulb' icon located next to the calendar's name, to bring the calendar's information popup. Click the link titled 'Edit'. From this new popup, click the 'Share this calendar' link. The popup will change shape, and new options relating to shared calendaring will appear. Enter in the information as required, and click 'Save'.

[edit] Sending Invitations

To send an invitation, find the calendar you wish to send invitations for, click the 'lightbulb' icon next to it, and click the Send Invitations link. Then simply preview the pre-written email, add recipients, and click 'Send'!

[edit] Address Book

This feature has not been scrubbed yet. No information is currently available for this chapter.

[edit] Configuring a desktop client

[edit] Evolution

Mail:

Evolution supports Bongo mailboxes natively. To create a new mail account within Evolution to connect with your Bongo account, you can:

• Open Evolution. Navigate to the Edit -> Preferences dialog.
• Select the Mail Accounts heading on the sidebar of Evolution (if it isn't already selected).
• Click the Add button. A wizard will appear, which will help guide you through the steps of adding your Bongo mail account to Evolution. Continue through the wizard until you reach the Receiving Mail step.
• From the Server Type drop-down box, select the "Bongo" option. Enter the Server as the IP address or name of server (the port is not required), and then enter your username. Continue through the wizard until you reach the Sending Mail step.
• From the Server Type drop-down box, select the "SMTP" option. Enter the Server as you did in the Receiving Mail step. Select "Login" from the Authentication Type and make sure your username is entered below.
• Click forward again to finish the wizard.

Calendar:

TODO: Describe how to use caldav.

Contacts:

The Bongo LDAP Server has not been scrubbed yet so watch this space. Details will be added as well as the Address Book Agent is fully scrubbed. You can still add and access contacts via the Web UI.

[edit] Mozilla Thunderbird

Mail:

Mozilla Thunderbird supports Bongo mailboxes by IMAP and POP3. To create a new mail account within Thundbird, you should do the following steps.

• Open Thunderbird and navigate to the File -> New -> Account...
• A dialog box will drop down and you select what kind of account you wish to create.
• Select Email account and click continue.
• Enter your full name and the email address of your Bongo account.
• You have the choice between IMAP and POP3. Select IMAP and enter the address of your incoming and outgoing server. Both should be the same, but I depends on your Bongo setup.
• Enter your username and continue.
• Enter a name for your new account.

TODO:Continue

[edit] Apple Mail

Mail:

Apple Mail supports the access to your Bongo mailbox by IMAP or POP3. You should use IMAP, because you can use your server folders. To create a new account within Apple Mail, you should use the wizard:

• Open Apple Mail and navigate to File -> Add Account (The wizard opens and shows a new dialog).
• Select "IMAP" from the drop-down list, give the account a short description in the Account Description field, enter your full name and the email address of your Bongo Account. Click continue to go on.
• Enter the address of your Bongo server, your username and password. When you click continue, Apple Mail will check your settings.
• The outgoing server should be the same address as the incoming server, but it depends on your setup. Please choose the use authentication option and enter your username and password again. After you click continue, Apple Mail will check this settings, too.
• Apple Mail will show an overview over your account settings. After you have checked them, click continue to finish the dialog.
• Select your IMAP account from the mailbox list on the left.

Additional settings could be made by navigate to Mail -> Settings and select the Accounts tab.

[edit] Microsoft Outlook

Mail:

TODO