Ektron 9.00
Ektron's community feature can generate email when a user completes an activity. For example, if a member posts a comment to a community message board, group members who signed up for email notification in their user profile receive an email that contains the comment. Recipients can reply to the email. Replies are posted on the community group's message board.
You can also enable the attachment of files to email notifications. So, if a group manager uploads a PDF file to a group message board, the email notification message contains the PDF file as an attachment. Users can reply to that message and, if they attach an updated version of the file, it can replace the file on the group's message board.
Finally, you can set up an email address for a group. This makes it easy for anyone to broadcast a message to all group members.
To set up email delivery of and replies to notification messages:
Prerequisites
Notifications must be enabled. See Conditions for Notification Messages.
IMPORTANT: You must have permission to edit files on the Ektron server to complete this step.
The siteroot/web.config
file collects the outgoing email address information. To define the "From:" address of community email sent from your website:
siteroot/web.config
file with a text editor (such as Notepad).<notificationAgent> <providers>
elements.From:
field.Ektron provides a message that is emailed when each community activity is completed. To view the message in the Workarea, choose Settings > Community Management > Notifications > Messages and click Email Message Reply.
Ektron provides a default set of notifications that apply to all newly-created users. This step is almost exactly the same as Setting Default Notification Preferences.
The optional email Reply feature consists of additional text in a community notification that prompts a recipient to reply, as shown in the following example.
If the recipient replies, the resulting email is posted to the group's message board.
IMPORTANT: The Community email Reply feature is only available with group activities, such as uploading a document to a group workspace. It is not available with user activities.
Also, you must enable the community notification features as described in Setting Up Email to Communicate Community Activities.
IMPORTANT: Each community group's email address must be unique.
NOTE: If you are using Gmail as the SMTP server to fetch email replies, after the notification service processes the emails, you probably want to delete them from the Inbox. To set up automatic deletion of this email from the Inbox, got to Gmail's Settings screen > Forwarding and POP/IMAP tab > Pop Download Area > 2. When messages are accessed with POP > select delete Gmail's copy.
Community activity that generates an email also can include a reply statement, as shown in the following example.
NOTE: The activity message text is determined by the activity. For example, if the activity is a blog post, the message text is retrieved from the New Blog Post notification message.
To review and modify email reply text:
The line of dashes separates the activity message from the email reply.
Messages typically combine text and tokens, Ektron-defined variables surrounded by at signs (@). When a message is generated, tokens retrieve information about Ektron users, groups, and objects. See Also: Working with Tokens
C:\program files\ektron\ektronnotificationservice\
ektron.notification.service.exe.config
.<siteNotification> <sites>
element.<Add>
tag.replyStartDelimitter
—marks the beginning of the replyreplyEndDelimitter
—marks the end of the replyFor example:
<siteNotification> <sites> <add name="dev" url="http://localhost/eintranet" connectionString="server=.;database=eintranet; Integrated Security=TRUE;user=;pwd=;" services="All" replyExtractor="Ektron.Notification.Service.EktronReplyExtractor" replyStartDelimitter="^" replyEndDelimitter="\r\n" /> </sites> </siteNotification>
You use RegExregular expression; an alias that creates a pattern. For example, blogs.aspx?blogmonth=3&blogyear=2012&blogid=41 can be a RegEx blogs/2012/03/41. From that, a site visitor can infer blogs/2012/03/40 to see the previous post, or enter blogs/2012/03 to see all March 2012 posts expressions to indicate the start and end delimiters. In the above example, the start delimiter (^) is a new line, and the end delimiter (\r\n) is a page break. So, only the first paragraph in the email reply is used.
Ektron can attach assets to a notification. For example, a user uploads a PDF document to a group workspace, which generates a Group Content Added notification and attaches the asset. If you enable attachments and the email Reply feature, message recipients can:
If they do, Ektron replaces the community group asset with the attached file.
If a group administrator does not want the revision, the administrator can use the asset history to restore the original asset. See Also: Restoring a Previous Version
IMPORTANT: If a message's email signature includes an image, the email Reply feature uploads it as a group asset. To avoid this, remove the image from the signature before replying.
To set up notification attachments for a community group:
Activity notifications can prompt recipients to reply. The following table shows how each activity treats email replies.
NOTE: If you are in a load-balanced environment, the same reply may appear several times. If this problem occurs, stop the Ektron notification service on all but one of the servers in the cluster.
Activity that Triggers Message |
How email Reply Handled |
---|---|
User adds a colleague |
Comment on Activity Stream |
User adds content to Ektron |
Post to Content Message Board |
Event is added or changed on Web Calendar |
Comment on Activity Stream |
User uploads content to community group Workspace |
Post to Content Message Board |
User comments on group workspace content or asset | Comment on Activity Stream |
User uploads content to the user's profile |
Post to Content Message Board |
Comment on user workspace content or asset | Comment on Activity Stream |
User comments on a blog post |
Comment to same blog post |
User posts to the user's blog |
Comment on post |
User posts to a message board associated with content |
Reply to post |
User creates a community group |
Comment on Activity Stream |
User posts to a Forum |
Reply to post |
User replies to a Forum post |
Reply to post |
User comments on a community group’s blog post |
Comment on same blog post |
User posts to community group blog |
Comment on post |
User posts to a community group message board |
Reply to post |
User joins community group |
Comment on Activity Stream |
User posts micro-message |
Comment on Activity Stream |
User updates status |
Comment on Activity Stream |
User posts to another user's message board |
Reply to post |
Message board reply | Reply to same post |
You can set up Ektron's Community Feature to let anyone email a post to a community message board. To set this up, each community group administrator (or Ektron administrator) must define information about the receiving email account.
Alternatively, from the Workarea, choose Settings > Community Management > Community Groups. Click the group, then click its Properties tab and check the Enable Group emails checkbox.
The Community Platform’s email notification feature enables Ektron to generate email that invites other users to join a community group, join the site, or become a colleague.
To create a message:
Messages can include variables that retrieve information about the user sending the invitation or the link to join a group and display it in the message text.
Variables are surrounded by at signs (@). For example: @appSenderName@
displays the name of the user sending the invitation. In the email, this text might read:
Alan Administrator has invited you to join the Marketing Community Group.
You can use the following variables in the body of email notifications.
Click <a href=http://www.example.com/register.aspx&fInvId=
to accept.
@appInviteId@>here</a>