The Email Address Dashboard Widget is a Registry Dashboard plugin that allows for self service management of Email Addresses.

Availability

The Email Address Dashboard Widget is available in COmanage Registry version 4.1.0.

Features

Configuration

  1. This is a non-core plugin, see Installing and Enabling Registry Plugins for more information. The plugin is found at app/AvailablePlugin/EmailAddressWidget.

  2. The Email Address Widget must be attached to a suitable Dashboard, create one if there is not one already available.
  3. (OPTIONAL) Create a Message Template with a Context of Plugin, with the contents of the message to be sent to confirm control of the Email Address being added. (The substitution (@TOKEN) will be replaced with the actual token.)
  4. Add a new Dashboard Widget, with the Plugin set to EmailAddressWidget.
  5. On the plugin configuration page,
    1. set the Default Email Type to the Email Address Type that will be assigned to Email Addresses using this instantiation of the Widget.
      1. (info) It is possible to allow multiple address types to be collected by instantiating the widget multiple times.
    2. Set the Email Address Limit (as of Registry 4.3.1) to specify the number of email addresses allowed by this widget. Leave this value empty to allow an unlimited number of entries.
    3. Set the Message Template if you chose to use one. If you do not use a Message Template, you will a very simple default message will be used.
    4. Set the Verification Validity in minutes. This is the length of time the verification code sent to the user in email will remain valid. By default, this is 10 minutes.
    5. Select Allow Replace (as of Registry 4.3.1) if you wish to allow users to replace any email address with another. Attempting to replace an email address will prompt users for verification. The email address will only be replaced if the new address is verified.
    6. Select Retain Last Email Address (as of Registry 4.3.1) to disallow the last email address in the widget to be deleted. When active, the "ADD" button will change to "REPLACE" when only one address remains. This will occur independent of the "Allow Replace" setting.

Considerations

This plugin manages the Email Addresses of the currently logged in user, so Dashboards Visibility configurations control who has access to see this feature.

When a new Email Address is added, a verification message will be sent to confirm the address. The Email Address will not be visible on the CO Person record until the address is confirmed.

To manage multiple types of Email Addresses, the plugin can be instantiated additional times on the same or multiple dashboards.

The Email Address Widget can be used with the  Elector Data Filter Plugin  to allow for a self-selected Email Address to be given priority when provisioning to downstream systems.

Screenshots

The Email Address widget displays a simple list of email addresses.


When "Edit" is activated, a user may interact with an email address (delete it or replace it if allowed by configuration) or add a new email address.


Upon adding a new Email Address, the user is immediately prompted for verification. The duration of the verification token's validity can be set in the widget configuration. The default duration is 10 minutes. The user must visit the email address just added, copy the verification code from the email message sent by the plugin, and paste it into the Verification Token field to verify and finish adding the email address.

See Also