flexible email
"Flexmail" is a now-outdated Wagn term for our former handling of customized emails. It was based on the former *send setting, which by default referred to +email config cards.
As of Wagn 1.14 all Wagn emails are now customizable and are handled via action extensions rules and Email templates.
Example
Here's an email that's configured to go out whenever you add an Event card.
First the +*send card must point to an email configuration card:
Second, that configuration card should set the email details:
How To
*send Setting
To have email sent out whenever cards in a particular set are added, configure "send" in the card's rules. By default, it will be a Pointer to "|that set|+email config", which you can then fill out with who the email should go to, its subject and message, etc.
Let's say you want to configure an email to go out whenever someone adds an Event, with some event details. You'd go to Event's rules (under avanced in the menu):
There, you scroll down and click the radio button labelled 'All "event" cards' and Submit. You can then click to add an email configuration. See the example above.
Email Address Fields
The purpose of the *from, *to, *cc, and *bcc plus cards is, naturally, to produce a list of email addresses. This can be done in a number of ways:
- The value can be a simple email address, as in a Phrase card.
- Pointer cards can refer to other cards with email addresses
- Search cards can return cards with email addresses
- Most powerfully, the above can be used in combination. Eg, you can point to a search card that returns a list of email addresses.
Permissions
When emails are sent, all configuration cards are restricted to the permissions of the user who last configured them. So that, even though most users cannot view +*email cards, an administrator can configure an email to use such cards, and then any user with permission to create the triggering card will be able to email to those users.
If you don't want these emails to be visible to end users, you can use the *bcc setting.
Contextual Content
You can use contextual names to further customize your emails. Within each email configuration card, "_self" will be treated as referring to the card triggering the email. See +*subject and +*message in the example.
Tips
- You may have noticed that most of the inclusions are using the naked views; that's to prevent unwanted line endings in the email.
- Any of the address fields can be changed to be a Search or a Pointer, including ones that reference additional Searches and Pointer (up to three layers deep, not counting the +*to card itself).
Discussion
Is there a ticket yet to "digest" email notifications (like watchers)? Maybe this isn't the right place for this, but if the ticket doesn't exist, I'll create an Idea ticket for it. -- Gerry
You mean to incorporate notification (watcher) email into the flexmail system? There's no ticket for that yet.
--John Abbe.....Sun Jan 23 06:12:53 -0800 2011
There sort of is a ticket for what John's describing: convert system emails to flexmail system. There isn't a ticket for making digests possible, but I've got ideas about how that might work and will try to get that recorded now.
--Ethan McCutchen.....Wed Mar 09 11:19:56 -0800 2011
ideas here: upgrade email system
--Ethan McCutchen.....Wed Mar 09 12:42:20 -0800 2011