mail2news Plugin

Name	mail2news Plugin
Vendor	Liip AG (Website)
Authors	Roman Schlegel, Liip AG, Lukas Karrer
Homepage	http://confluence.atlassian.com/display/CONFEXT/mail2news+Plugin
Issue Management	https://jira.liip.ch/browse/MAILTONEWS
Continuous Integration	n/a
Categories	Remote Access
Most Recent Version	1.7
Availability	Confluence v2.10 to v3.0.0_01
State	Stable
Support
License	Freeware / Open Source (BSD)
Price	Free
Release Docs
Java API Docs	n/a
Download Source	n/a
Download JAR	mail2news-1.7_2.10.x.jar

Description/Features

Post news entries using email This is a simple plugin which can monitor an IMAP/S or POP3/S mailbox and publish emails as news entries. Special about it is that the space, in which the news should be published can be defined as an email-address wildcard (email+spacekey@domain.net). Attachments are also supported and are added as attachments to the news entry.

The email account is scanned every 5 minutes for new messages. If an IMAP account is used, then processed messages are moved to a folder named "Processed", invalid messages (where an exception occurred while handling them) are moved to a folder named "Invalid". If POP3 is used then processed/invalid messages are deleted from the account.

Compatibility With Confluence

Plugin Versions	2.4	2.5	2.6	2.7	2.8	2.9	2.10	3.0
1.7
1.7
1.2
1.1
1.0

Installation

See Installing Plugins and Macros

Manual installation for Confluence 2.9 / for Confluence 2.10

Usage

After installing the plugin, click the "Configure" link of the mail2news Job.

There you may

• configure the IMAP(S)/POP3 settings of the mailbox to poll
• define, if gallery macro should be enabled when image attachments are detected
• configure SMTP server for replying error messages back to sender
• directly test the configuration.

You need a dedicated email account for this plugin, preferably one where email address wildcards are supported. GMail for example supports wildcards.

Suppose the account you are using has the address "wiki@domain.net", then you configure the plugin with the relevant settings (mail host, username, password, etc.). By sending email to "wiki+spacekey@domain.net" an email will be published as a news entry in the Space with the space key "spacekey".

For example: An email to the address "wiki+internal@domain.net" would be published in the space with the spacekey "internal".

Important 1: This only works if your email provider really supports wildcards in email addresses!
Important 2: You have to use the spacekey, not the spacename!

If you are using an email address without wildcards, then the plugin will just check if there exists a space where the key is equal to the local part of the email address.

Examples

Version History

1.7 Bugfix: An unknown character set in an email no longer prevents an email from being published.
Feature enhancement: Error message is sent to originator if plugin is unable to process mail. Possibility to automatically enable gallery macro if immage-attachement is detected.

1.2 Bugfix: An unknown character set in an email no longer prevents an email from being published. Instead the plugin does a fallback to the default character set, although this can lead to some wrongly encoded characters.

1.1 Bugfix: When multiple To-addresses were defined the plugin would only work if the first address was the one with the embedded space-key. Now the plugin just iterates over all addresses (including CC-addresses) until it finds one where it can extract an existing space key.

1.0 Initial version
Sponsored by Stimmt.

Open Issues

• The size of the attachments is not always correct. It is sometimes slightly more than the true size.
• Self-signed certificates for SSL connections are not supported. Or in that case the certificate probably has to be installed in the certificate store of Confluence.
• The plugin has issues with some IMAP mail servers (it seems UW-IMAP is a candidate), sometimes it cannot reliably determine the root folder to create the necessary folders.
• The Enable Gallery Macro functionality yields in an error in certain environments

Screenshots

Download History