Workflowtypes

Send email, extended

This is an extension of the default "Send email" workflow type. The extra settings are:
  • Email
    • Enter multiple e-mail addresses by separating them with a semicolon (;).
  • ReplyTo - Enter the e-mail address that will be used when clicking "Reply" in your e-mail program.
    • To reference a field from your form use a lower-cased, spaceless version of your field name inside curly brackets like: {emailaddress}
  • SendFields
    • Send the content of the form fields in the email
  • Attachment
    • If you have an upload field, attach the uploaded file to the e-mail, instead of only adding a link to the file in the body of the e-mail.
  • Message
    • The introduction message can contain multiple dictionary items (the dictionary key can not contain a space!), example: #MyDictionaryKey #MyOtherDictionaryKey
    • Newlines can be added using "\n", example: Hello {firstname}, \n\nThis is an introtext.
    • Note: do not start Message with a dictionary item, it will conflict with the default workflow parsing. Instead start with a newline and space (\n )
  • Other notes
    • field captions in e-mail are now translated, use the hash notation for dictionary items to name the field caption, example: #emailfieldname
    • textarea fields with linebreaks are preserved in e-mail

Send XSLT transformed email, extended

This is an extension of the default "Send XSLT transformed email" workflow type. The extra settings are:
  • Email
    • Enter multiple e-mail addresses by separating them with a semicolon (;).
  • ReplyTo - Enter the e-mail address that will be used when clicking "Reply" in your e-mail program.
    • To reference a field from your form use a lower-cased, spaceless version of your field name inside curly brackets like: {emailaddress}
  • Attachment
    • If you have an upload field, attach the uploaded file to the e-mail, instead of only adding a link to the file in the body of the e-mail.

New: send e-mails using SSL protected SMTP servers

You can do all of the configuration in your web.config, see an example of relaying mail through Gmail's servers below.
There is one important additional step you need to take though, in your appSettings section you need to add:

<add key="contourContribUseSsl" value="true" />

Example Gmail config:
  <system.net>
    <mailSettings>
      <smtp>
        <network 
                        host="smtp.gmail.com" 
                        port="587"
                        userName="yourGmailAccount" 
                        password="yourGmailPassword" 
                        defaultCredentials="false"
                />
      </smtp>
    </mailSettings>
  </system.net>

Fieldtypes

Are you a human captcha

Never set the "Are you a human" fieldtype to "Mandatory", this will not work. When this fieldtype is added, it is always mandatory.

This field type displays a captcha provided by http://areyouahuman.net.

The captcha can be configured from the ayah control panel to be displayed inline on the form or in a lightbox on submit of the form.

The field requires API keys which are obtained (for free) when creating an account at http://areyouahuman.net.

Recaptcha

Never set the Recaptcha fieldtype to "Mandatory", this will not work. When this fieldtype is added, it is always mandatory.

The Recaptcha fieldtype has a few settings that are obvious (API keys can be acquired from http://www.google.com/recaptcha).
There is the option to do custom theming of the control. This requires you to enable the "custom" theme from the dropdown and enter the elemetn ID of the the div which contains the custom theme.
The easiest scenario here is where you have a template and you've inserted the form macro in there:

  <form runat="server">
   <umbraco:Macro FormGuid="3b3cd72f-568d-471f-9b04-bf9f9f161169" Alias="umbracoContour.RenderForm" runat="server"></umbraco:Macro>
   <!-- insert custom theme here -->
  </form>
You can get an example of custom theme code from here: http://code.google.com/apis/recaptcha/docs/customization.html#Custom_Theming
Add the custom theme code where it says "<!-- insert custom theme here -->".
The default ID from the example ("<div id="recaptchawidget" style="display:none">") is "recaptchawidget". This is what you need to enter in your field under the "CustomThemeWidget" setting.

You can now proceed to change the positioning of the Recaptcha widget and probably Contour's submit button, as the theme will always appear under the form, there's currently no way to add it next to the label automatically.

Last edited Feb 10, 2013 at 8:59 PM by adam_jenkin, version 12

Comments

Drakhul Dec 10, 2012 at 8:58 PM 
It warms my heart to see the outpouring of support for this package... wait, there IS NO BLOODY SUPPORT! Hello!?!?!

Drakhul Nov 30, 2012 at 2:14 PM 
I installed this package on Umbraco 4.7.2, and I setup a new workflow using the extended email, but the mail is not being delivered. Are there any special settings or something I need to check? I need the ability to include attached files.