You can configure the e-mail widget to use any e-mail service provider that supports POP3/IMAP and SMTP protocols. Configuration for this widget is performed by administrators so that users can simply log in to their accounts without needing to perform any additional configuration. Currently, the e-mail widget WAR package is available for download on the
Lotus Greenhouse Web site.
To understand the configuration information required for e-mail service providers, open the e-mail widget WAR package, and locate WEB-INF/classes/com/ibm/mm/widget/email/provider/providers.json. Here is a snapshot of what this file contains:
[
{
"id" : "gmail",
"name" : "Gmail",
"addressSuffix" : "@gmail.com",
"properties" : {
"mail.imaps.host" : "imap.gmail.com",
"mail.store.protocol" : "imaps",
"mail.transport.protocol" : "smtps",
"mail.imaps.port" : "993",
"mail.smtps.host" : "smtp.gmail.com",
"mail.smtps.port" : "465",
"mail.smtps.auth" : "true",
"mail.mime.charset" : "utf-8"
}
},
{
"id" : "hotmail",
"name" : "Windows Live Hotmail",
"addressSuffix" : "@hotmail.com",
"properties" : {
"mail.pop3s.host" : "pop3.live.com",
"mail.store.protocol" : "pop3s",
"mail.transport.protocol" : "smtp",
"mail.pop3s.port" : "995",
"mail.smtp.host" : "smtp.live.com",
"mail.smtp.port" : "587",
"mail.smtp.auth" : "true",
"mail.smtp.starttls.enable" : "true",
"mail.mime.charset" : "utf-8"
}
}
]
In the code above, JSON format is used to describe each e-mail service provider. For each e-mail service provider, notice the following attributes:
- id: the unique identifier
- name: the name that displays for users
- addressSuffix: the suffix of the e-mail address
- properties: the properties required to connect to the e-mail service
Here are descriptions of some typical properties:
- mail.store.protocol: the protocol used to receive mails, for example pop3 for POP3, imap for IMAP, pop3 for POP3 using SSL, and imaps for IMAP using SSL
- mail.transport.protocol: the protocol used to send e-mail, for example smtp for SMTP and smtps for SMTP using SSL
- mail.[PROTOCOL NAME].host: the host for a protocol
- mail.[PROTOCOL NAME].port: the port for a protocol
- mail.smtp.auth: indicates whether or not the SMTP server requires authentication
- mail.mime.charset: the default charset for e-mails
These properties are used by
JavaMail. You can add any properties that are accepted by JavaMail. For example, if you want to configure Yahoo! Mail Plus, first locate the information required for
POP3/SMTP settings,
create the settings, and then change the configuration file, for example:
{
"id" : "yahoomailplus",
"name" : "Yahoo! Mail Plus",
"addressSuffix" : "@yahoo.com",
"properties" : {
"mail.pop3s.host" : "plus.pop.mail.yahoo.com",
"mail.store.protocol" : "pop3s",
"mail.transport.protocol" : "smtps",
"mail.pop3s.port" : "995",
"mail.smtp.host" : "plus.smtp.mail.yahoo.com",
"mail.smtp.port" : "465",
"mail.smtp.auth" : "true",
"mail.mime.charset" : "utf-8"
}
}
After you save the file and restart the e-mail widget, you should be able to see Yahoo! Mail Plus in the drop-down list of service providers on the widget's log-in screen.