Mail Page Plugin

Name Mail Page Plugin
Vendor Atlassian Software Systems (Website)
Authors David Loeng, Agnes Ro
Homepage http://confluence.atlassian.com/display/CONFEXT/Mail+Page+Plugin
Issue Management http://developer.atlassian.com/jira/browse/EMLPAGE
Categories Content Macros
Version 1.5
Availability Confluence v2.6.0 to v2.10-m1
State Stable
Support Atlassian Supported Plugins
License Freeware / Open Source (BSD)
Price Free
Release Docs http://confluence.atlassian.com/display/CONFEXT/Mail+Page+Plugin
Java API Docs n/a
Download Source http://svn.atlassian.com/svn/public/contrib/confluence/email-plugin/tags/confluence.extra.email-1.5/
Download JAR confluence.extra.email-1.5.jar

Compatibility With Confluence

Plugin Version 2.4.5 2.5.8 2.6.2 2.7.3 2.8.0 2.9 Tested
1.2      
1.3      
1.5    

Description/Features

Enables a page to be emailed to specified email addresses, users or groups.

Requirements

This plugin will only work if a mail server has been configured. To set up a mail server, navigate to Administration > Mail Servers on your Confluence server.

Installation

This plugin is bundled with Confluence, however it is disabled by default. To enable it, do the following:

  1. Navigate to Administration > Plugins
  2. Scroll to the "Mail Page Plugin" and select it.
  3. Click the 'enable' link in the plugin description.
  4. Click the 'enable' links for all sub-sections of the plugin if necessary.

You may also wish to periodically check the Plugin Repository to see if any updates have been released.

Documentation

To email a page, do the following:

  1. View the page in Confluence
  2. Click on the Info tab.
  3. Click on the E-mail link, listed in the 'Operations' section.
  4. Fill in the details for who the page should be emailed to.
  5. Click 'Next'.
  6. Review the email information. When satisfied, click 'Send'.

Version History

Version Date State License Price
Show description 1.5 (#2) 11 Mar 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

Atlassian Developer Network JIRA (2 issues)
T Key Summary Assignee Reporter Pr Status Res Created Updated Due
Bug EMLPAGE-6 Attempting a group or user search in the email a page screen throws an error David Chui Paul Curren [Atlassian] Minor Resolved FIXED Feb 03, 2008 Feb 20, 2008
Bug EMLPAGE-3 "Notes" content is being ripped when a double qoute is defined David Chui Tony CheahTongNyee Major Resolved FIXED Oct 17, 2007 Feb 20, 2008

Contributors

  • David Loeng — Developer
  • Agnes Ro — Developer

Show description 1.3 (#1) 30 Oct 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Atlassian Developer Network JIRA (2 issues)
T Key Summary Assignee Reporter Pr Status Res Created Updated Due
Bug EMLPAGE-2 "Find Users" and "Find Groups" pop-up do not function in the Internet Explorer browser Agnes Ro Tony CheahTongNyee Minor Resolved FIXED Oct 05, 2007 May 04, 2008
Task EMLPAGE-1 Refactor MailPageAction class to improve testability David Chui David Chui Major Closed FIXED Sep 24, 2007 Sep 24, 2007

Contributors

  • David Loeng — Developer
  • Agnes Ro — Developer

Screenshots

Outstanding Tasks

Atlassian Developer Network JIRA (3 issues)
T Key Summary Assignee Reporter Pr Status Res Created Updated Due
Improvement EMLPAGE-12 Automatically set the Email Subject to the Page Title Agnes Ro Jonathan Nolen Minor Open UNRESOLVED Jun 05, 2008 Jun 05, 2008
New Feature EMLPAGE-8 email macro Agnes Ro Bob Swift Major Open UNRESOLVED Apr 29, 2008 Apr 29, 2008
Improvement EMLPAGE-5 Provide option to block Mail Page plugin capability from users that are not logged in Agnes Ro Colin Ho Major Open UNRESOLVED Jan 24, 2008 Jan 24, 2008

Labels

atlassian-supported atlassian-supported Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Oct 01, 2007

    Pramod Kumar says:

    The mail page option was working fine and all of a sudden now when I click on Ma...

    The mail page option was working fine and all of a sudden now when I click on Mail Page, I get a blank page. I neither get any error on the page nor in the logs. Any idea why this is happening.

    I have installed/uninstalled lot of plugin, not sure if this is the cause for this problem

    1. Oct 02, 2007

      Mei Yan Chan says:

      Hi Pramod, Could you please create a support ticket at

      Hi Pramod,

      Could you please create a support ticket at http://support.atlassian.com and provide the following information for further investigation:

      1. Did you make any recent changes to the Confluence instance which might triggered the problem.
      2. Screen shot of the System Information at Administration Console -> System Information.
      3. Attach a zip of the ${catalina.home}/logs directory.

      Regards,
      Mei

      1. Apr 23

        Pramod Kumar says:

        We realised that there was a problem with the Theme, when we restored the origin...

        We realised that there was a problem with the Theme, when we restored the original theme, the mail was working. So copied the same functionality to the theme plugin

  2. Nov 06, 2007

    Jim Birch says:

    I'm using the mail page plugin to post out a newsletter. I wanted to change the ...

    I'm using the mail page plugin to post out a newsletter. I wanted to change the default preamble text and fonts. Can anyone tell me

    1. What to edit?
    2. Will this impact anthing else?

    Thanks

    1. Nov 07, 2007

      Choy Li Tham says:

      Hi Jim, I would suggest you to direct your questions to our forum

      Hi Jim,

      I would suggest you to direct your questions to our forum pertaining to the queries you are having as there might be other developers/users that should be able to share their ideas with you.

      Regards,
      Choy Li

  3. Jan 14, 2008

    Paul Csapo says:

    Hello, I was looking at the "Compatibility With Confluence" table above, an...

    Hello,
    I was looking at the "Compatibility With Confluence" table above, and noticed that 2.5.7 was not included with a Tick.... does this mean that this Mail Plugin is not compatible with 2.5.7?

    We have 2.5.7 but the mail plugin does not seem to be sending mails when using the plugin. (Other notification and test mails work, just not with the plugin).

    We also experienced the same issue as this: http://developer.atlassian.com/jira/browse/EMLPAGE-2 ("Find Users" and "Find Groups" pop-up do not function in the Internet Explorer browser)

    regards,
    Paul

    1. Dec 06, 2007

      Ming Giet Chong says:

      Hi Paul, I have tested the Mail Page plugin in Confluence version 2.5.7 in fire...

      Hi Paul,

      I have tested the Mail Page plugin in Confluence version 2.5.7 in fire fox browser and its working fine.

      However, for the bug issue been raised at http://developer.atlassian.com/jira/browse/EMLPAGE-2 , you may want to add the comments and add yourself as a watcher so that you will be notified for future updates.

      Regards,
      MG

      1. Dec 06, 2007

        Paul Csapo says:

        ok MG many thanks will do. thanks, Paul

        ok MG many thanks - will do.
        thanks,
        Paul

  4. Dec 18, 2007

    Shaji Khan says:

     Does anybody know if this plugin can generate a warning before the informa...

     Does anybody know if this plugin can generate a warning before the information is turned it. For instance, "Are you sure you want to send this email?" type of warning.    

  5. Apr 01

    Gail Swaffield says:

    Is version 1.3 compatible with Confluence v2.5.4?

    Is version 1.3 compatible with Confluence v2.5.4?

    1. Apr 02

      Mei Yan Chan says:

      Hi Gail, There shouldn't be any problems using v.1.3 in Confluence v.2.5.4 as i...

      Hi Gail,

      There shouldn't be any problems using v.1.3 in Confluence v.2.5.4 as it's compatible. If there is a problem, please raise a support request at:

      Regards,
      Mei

      1. Apr 29

        Gail Swaffield says:

        Thanks Mei Can you tell me whether v1.3 fixes any of the formatting issues e.g. ...

        Thanks Mei

        Can you tell me whether v1.3 fixes any of the formatting issues e.g. apostrophes, umlauts and other special characters appearing as &apos?

        Thanks

        Gail

        1. May 02

          Mei Yan Chan says:

          Hi Gail, I wasn't able to find the bug/feature request via the link below:

          Hi Gail,

          I wasn't able to find the bug/feature request via the link below:

          Perhaps do you have a specific ticket number for the query you are after? Thanks.

          Regards,
          Mei

  6. May 16

    Michael Coxe says:

    Is 1.5 just a new build to support Confluence 2.8? Or are there other difference...

    Is 1.5 just a new build to support Confluence 2.8? Or are there other differences from 1.3?

     Regards,

     - Michael

    1. May 20

      David Chui says:

      Hi Michael, 1.5 is a release containing some bug fixes. I've updated the vers...

      Hi Michael,

      1.5 is a release containing some bug fixes.

      I've updated the version history in this page to show the list of resolved issues for 1.5. Feel free to have a look for more details.

  7. Jun 21

    Jamie Showrank says:

    In Lotus Notes 6.5, the wiki Notes text shows up in the email, but without forma...

    In Lotus Notes 6.5, the wiki Notes text shows up in the email, but without formatting. If we enter text on 3 lines, for example, using the enter key to separate lines, the email shows all of the text in the Notes section on a single line. I tested using html formatting, and used the <br> tag in between each line, but the Notes text displays the <br> instead of rendering it. Has anyone seen this problem?

    1. Jun 22

      David Chui says:

      Hi Jamie, As of current, the plugin does not translate line breaks in notes as ...

      Hi Jamie,

      As of current, the plugin does not translate line breaks in notes as <br> or <p> tags. Therefore, the line breaks you've inserted will not be visible in HTML emails.

      However, it does sound like a good idea. Please, feel free to write up an improvement request for this. The link to the plugin's issue tracker is http://developer.atlassian.com/jira/browse/EMLPAGE.

      Thanks!

  8. Aug 21

    Mark Salamon says:

    What would be a nice feature/macro is to be able to have an email be sent out to...

    What would be a nice feature/macro is to be able to have an email be sent out to users/groups, etc, when a page is first created.  The macro could automatically include the title of the page in the subject line and who created it, like:

    Subject:  Page "A new page" Created by John Smith

     
    Although in the macro you could override this.  Also, the body could, by default, say:  "John Smith has just created a new page 'A new page' in the Cool space.  To view this page, go to:  http://confluence.corp.com/....".  Again, in the macro you can override this.  The macro also includes who the recipients of the email are.  The from email address should be the poster's email address.  You could also have a format parameter, defaulting to html.

    This way, if I have a really important posting, I can have it emailed out to users immediately.  (This would only run on the original posting, not on any comments/edits.)

    Then, for a particular space, I could create an "Instant Email Template," that would include this macro in the page and preconfigure it to send the email to a recipient list.  So if I had an HR space and an Instant Email Template for HR, the email would go out to everyone in HR automatically

    1. Aug 26

      Ming Giet Chong says:

      Hi Mark, By default, Confluence does keep track of the changes to a single page...

      Hi Mark,

      By default, Confluence does keep track of the changes to a single page, an entire space, or to all spaces on your site. You can find more information here.

      Then, for a particular space, I could create an "Instant Email Template," that would include this macro in the page and preconfigure it to send the email to a recipient list. So if I had an HR space and an Instant Email Template for HR, the email would go out to everyone in HR automatically.

      Email template is not supported in Confluence currently. There is a similar new feature request being raised here. Alternatively, we would suggest you to raise a feature request at http://jira.atlassian.com. Hope this helps. Thanks.

      Regards,
      MG