Patch #1616
openAllow email to create and reply to forum messages
0%
Description
Summary¶
This is a patch for #277 that provides the ability to send messages to forums via email. This gives Redmine a mailing list like capability by utilizing the work done in #1110 (Allow email to create issue or add comment), which has been available since r1572. By enabling this functionality users can create new and reply to existing forum messages that will be sent out via email to all those who are watching that forum.
Configuration¶
There are two areas of configuration for this feature. One is how you get emails into Redmine and the other is an optional configuration to set a different emission email address specifically for forum emails.
Receiving Forum Message Emails for Redmine Processing¶
In order to receive emails into Redmine the documentation found here should be used. This documentation covers specific settings for creating issues within Redmine. The only issue attribute that applies to this patch is the project attribute. If you set the project attribute. I have done my functional testing using the IMAP setup. The rake command looks something like this:
rake redmine:email:receive_imap host=imap.domain.com port=XXX ssl=true username=username@domain.com password=password_here RAILS_ENV=_production_
Using the IMAP setup, you must schedule the rake command to run on a regular basis using cron or another job scheduling mechanism.
Forum Emission Email Address¶
If you want to use a different reply-to email address for forum messages than you use for other emails sent from Redmine, then you'll need to do the following:
- Login to your Redmine instance as an Administrator
- Click the Administration link at the top of the page
- Click on the Settings link
- Click on the Email Notifications tab
- Enter the email address for forum emails in the Forum emission email address field
- This email address should go to the email account receiving forum emails (configured above in the Receiving Forum Message Emails for Redmine Processing section)
- Click the Save button
User Documentation¶
The following describes how to make use of the email to forum functionality.
How to Create a New Forum Message via Email¶
In order to create a new forum message, you simply address an email to the email address specified in either the Adminitration->Settings->Email Notifications Forum emission email address field (if populated) or the Emission email address (if the the Forum emission email address field is not populated). The subject of the email should be in the format of:
[Project Name - Forum Name] Forum message subject goes here
The format of the email body is not important. The script that processes the forum emails is setup to determine the project and forum names based on the email subject.
How to Reply to a Forum Message via Email¶
This is pretty simple. When you receive an email of a forum message you simply reply to the message and write your reply in the body of the email. One important thing to note is that you SHOULD NOT change the subject line if you want the email to be recognized as a reply to an existing forum message. The script that processes the forum emails is setup to determine the original forum message being replied to by the portion of the subject that follows the square brackets.
Receive Forum Message Emails in Your Email Inbox¶
In case it's not clear how you receive forum messages, I'm adding that info here. The best way to subscribe to receive emails for a particular forum is to:
- Click on the Forums tab in Redmine
- Click on the name of the forum you want to subscribe to
- Click on the Watch link so that the star icon turns yellow
You can also subscribe to all forums (and all other Redmine email notifications) by clicking on the My account link in the upper right hand of the page and then select For any event on all my projects from the drop down menu under the Email notifications section.
Files
Related issues