vuMailKit 1.1.0 available

vuMailKit 1.1.0 is now available.

This release is focused on making email from Clarion easier to set up, easier to send, and easier to explain to your customers.

The biggest point is this:

For normal use, you do not have to write OAuth code and very little vuMailKit code.

Your customers don’t need to know server ports, protocols or any of the hard parts in most cases - so they don’t call you for support!

The vuMailKit Email Setup Wizard walks the user through setting up the email account, testing it, and saving the working profile. Once that profile exists, your Clarion application can send email using the normal vuMailKit calls.

This release also adds and documents several features designed to make common email tasks much easier:

  • Simple to use HTML email support (sending HTML email has never been easier!)
  • Token merge / mail merge style message creation
  • CSV-based batch sending examples
  • Recommended send-flow examples using a stored profile
  • Better return-code and troubleshooting guidance
  • Expanded setup wizard and OAuth documentation
  • Updated getting-started documentation for normal Clarion developer use

One of the practical uses this opens up is generating output from Clarion and embedding it directly into an email.

For example, you can generate an invoice or customer notice, include a nice HTML header and footer, merge in customer-specific values, and send the finished email without making the user deal with the underlying email setup details.

The documentation has also been reorganized so the normal path is easier to find:

  1. Run the Email Setup Wizard.
  2. Save a tested profile.
  3. Send mail from Clarion using the stored profile.
  4. Add HTML, token merge, attachments, or batch sending as needed.

Online documentation:

The goal with vuMailKit 1.1.0 is to show Clarion developers that adding modern email support does not have to mean wrestling with OAuth flows, provider-specific setup code, or a pile of low-level mail code. The wizard handles the account setup, and your Clarion code can stay focused on sending the message.

This is a free update for all vuMailKit 1.0 users.

vuMail users can upgrade (it is a drop in replacement) to vuMailKit at our website

https://www.clarionproseries.com/html/vumailkit.html

Charles

Hi Charles,
Is there a link for existing users to download the update?
cheers
Rohan

Use the same link that was in your original email to download the 1.1 install exe

Hi Carl
The download link I have is still for version 1.0 and is code signed 23rd April 2026.
I ran the install again and it’s Version 1.0
Cheers
Rohan

Hi Rohan,

Carl is right in that normally you use the same download link to get the latest versions.

The initial release of vuMailKit only supported C9-C12.

However we decided that since it is not dependent on any version of Clarion and developers with older versions of Clarion need the ability to send modern mail we repackaged the installer to support C5.5 to C12.

We sent out new links to everyone who had the initial downloads because the filenames are different.

It now appears that you and a few others might not have gotten the new download info.

We are finalizing a new build with a few more changes to the diagnostic logging based on some feedback and also updated help pages that make it more clear what the SimpleHTML can do for developers.

When we get that ready we will resend the new links to everyone.

BTW - the SimpleHTML feature is a nice addition.

When you enable it, you can take text from a regular Clarion TEXT field (or MEMO, etc) and vuMailKit will automatically render it as an HTML EMail for you.

It creates a HTML wrapper for the email, puts the content in it and converts things like to
automatically so you don’t even have to think about it.

You can also add a graphic as the Email header or footer with one line of code (just name the file).

Additionally you can use our new TokenMerge feature to easily create your own Mailmerge type feature.

Another really cool feature is being able to include an external file within the Email body.

So you can run a Clarion report say for an invoice for a customer with output to TXT, then vuMailKit can create an HTML Email that has the company logo and address at the top (graphic or not), then the actual invoice can be a part of the EMail body and not have to be sent as an attachment.

Just as vuMailKit lets developers not have to write a single line of code to support OAuth, now it is making it easy to send really nice HTML emails (with the TEXT version as a multi-part EMail) without worrying about how to get it right.

Build 157 should be available later today and we will send out notices again so that everyone has the new links.

Charles

Thanks for the information. I look forward to your email! :slightly_smiling_face:

vuMailKit 1.1.0 Build 157 is available now.

We have also reset and resent the current registration/download information to all registered users, so you should now have the correct download links for the new build.

The updated documentation is online here:

This documentation pass includes extensive updates to make it much easier to get started, especially if you are migrating from the old vuMail product.

The new docs show the fastest path to sending mail with vuMailKit, including the parts most developers actually use in normal applications. While vuMailKit is designed as a drop-in replacement for the old vuMail DLL, you do not have to carry forward all of the complexity that older vuMail integrations often accumulated over time.

There are also new examples for the Simple HTML features. These make it easy to send better-looking HTML emails without needing to hand-code a full HTML message. The docs show how to:

  • send ordinary text from a Clarion TEXT control, memo field, note, or generated text
  • let vuMailKit turn that text into a clean HTML email
  • automatically include a plain-text alternative
  • add a graphic header and/or footer
  • embed images inside the message body
  • use the legacy _embed attachments_ style for body images
  • use local or remote image references where appropriate
  • merge external HTML templates created in other programs
  • use TokenMerge with email templates

The goal is to make the common cases simple. For many applications, you can use the Email Setup Wizard to create and test the profile, then call the normal send functions from your Clarion code.

And if you need OAuth for Microsoft or Google accounts, remember that you do not have to write a single line of OAuth code yourself. The vuMailKit Email Setup Wizard handles the account authorization and profile setup for you.

More information about vuMailKit is available here:

https://www.clarionproseries.com/html/vumailkit.html