Event Manager Plugin

Name Event Manager Plugin Vendor Adaptavist (Website) Authors Homepage http://confluence.atlassian.com/display/CONFEXT/Event+Manager+Plugin Issue Management http://jira.adaptavist.com/browse/EMP Continuous Integration n/a Categories Admin Most Recent Version 0.1 Availability confluence v2.0 to v2.10.4 State Alpha Support License Freeware / Open Source (BSD) Price Free Release Docs n/a Java API Docs n/a Download Source Download JAR 956

This is a very early Beta release. Although it's functional, we cannot guarantee it's stability, etc. Use at your own risk. If you have any comments or problems, please let us know via our Issue Tracker (URL above). If you are using Confluence 2.2 you must put this plugin in WEB-INF/lib rather than uploading it via the plugin admin interface.

Description

A plugin to allow confluence Administrators access to event triggered actions without the need for writing Java code. The plugin is aimed at being the event-based equivelant of user macros - giving a flexible user interface to hook events and configured actions together.

Installation

Upload this macro using the Plugin Manager. If you are upgrading this plugin, you may also need to restart Confluence to see the changes (this is due to a known issue with Confluence).

Usage

If your Plugin Manager is located at http://confluence.atlassian.com/admin/plugins.action then you can get to the Event Manager user interface by going to http://confluence.atlassian.com/admin/events/listActionSets.action.

Confluence v2.2 will mean that there will be a [configure] link next to the plugin in the Plugin Manager, so you will no longer have to hand write the URL.

Examples

To have a welcoming email sent when a user signs up (and a notification sent to you) - do the following.

Create the Action Set

• Add an Advanced Action Set

Select the Events to listen for

• Click [Edit] next to Triggering Events and select the Create User event inside of User Events
• Click [OK] next to Triggering Events
  Add the Welcoming Email action
• Click [+] underneath Actions to add an Action to the Action Set
• Set the title to "Welcome Email" and leave type as "Send Email".
• Click the OK button to add the Action - it will become the Starting Action for the Action Set, noted by the bold title text.

Configure the Welcoming Email action

• Set the following fields:

  From Email	noreply@your.domain.com
  From Name	Confluence Admin
  To Email	$event.user.email
  Subject	Welcome to Confluence, $event.user.fullName
  Body	Hi $event.user.fullName, // Your username is $event.user.name - don't forget it!

• Leave the results as stop for now.
• Click the OK button to save the data.
  Add the Admin Notification action
• Click [+] underneath Actions to add an Action to the Action Set
• Set the title to "Notify Admin" and leave type as "Send Email".
• Click the OK button to add the Action - it will remain non-bold as there is already a Starting Action set.

Configure the Admin Notification action

• Set the following fields:

  From Email	$event.user.email
  From Name	$even.user.fullName
  To Email	your@email.address.com
  Subject	New User: $event.user.name
  Body	A new user has signed up by the name of ${event.user.fullname}.

• Leave the results as stop.
• Click the OK button to save the data.

Configure the Welcoming Email action to chain onto the Admin Notification action

• Select Welcome Email from the Action List on the left.
• Click the Edit button.
• Set the Success! result to call the Notify Admin action.

Tada! You can now test the system by adding a user to confirm you and the new user are emailed.

Release History

Outstanding Tasks