Client Setup - "Email Test and Setup"

In order to aid you and your clients in successfully configuring vuMail, Valutilities has included a generic "Email Test and Setup" (ETS) application in both an executable and source code form.  This ETS application is freely distributable to your clients.

Once your client has been successful in sending an email with this program, the settings are automatically saved in the system registry and will be read automatically by your application (these settings can be overwritten by your application).

NOTE: Settings used by ETS to successfully send an email are retained
in the system directory for use by all of the functions provided in vuMail
.

vuMail uses SMTP (Simple Mail Transport Protocol) to send emails.  As with any email client, you will need to provide the information necessary to connect to an SMTP server and send your emails.  If your client has a default Outlook Express or Windows Mail (Vista) account, vuMail is able to read and use some of the email account information.  vuMail is able to read FROM, Email Server, Email Port, Proxy Server, and Proxy Port from the default email account and use this information automatically (vuMail cannot read the account password, this must be provided through this program or your application).

NOTE: vuMail does not use any external email client to send emails, and you do not need to use the default email account to send emails.  It is also not required that you have Outlook, Outlook Express, Windows Mail, or any other email client software installed.  All that is required is a valid account from either a local or external SMTP server.

After entering the information required (typically only Authentication information), if you are able to successfully send an email with the Email Test and Setup program, the following message will be displayed:

All settings will be automatically saved for you and your client in the system registry.  By using this, or your own external email setup application, it is not necessary that you include any account information or calls in your main application (of course, you can if you wish).  Also, by using an external application such as "Email Test and Setup", you isolate any issues that might occur in sending emails.  Both you and your client will be able to better troubleshoot any issues with email, without worrying if the problem is within your applications.

With the exception of an error where vuMail failed to initialize, failure to connect to the transport, or a wrongly formatted FROM address was supplied, all email errors returned are from the SMTP server. 

The following is a list of some common messages that can be returned either by vuMail or the SMTP server if you are unable to successfully send emails with the Email Test and Setup application (these are the same type of messages that are returned by vuMailLastError() and vuMailErrorDisplay().

This error message indicates that vuMail was unable to connect to the SMTP server, or that the SMTP server did not respond.  Common causes are wrong SMTP server name, wrong SMTP server port, wrong security settings, etc.

The FROM address is formatted incorrectly (this error will not appear for a missing FROM address).

The security settings are incorrect, or an incorrect Account Name and/or Password was supplied.  Most email accounts provided by an ISP require authentication.  The most common security type is BASIC, No SSL.

The SMTP server requires a secure connection.  Enabling SSL should fix this problem.

COMMON SETTINGS FOR SOME POPULAR SMTP EMAIL PROVIDERS

Google (gMail) Settings:
SMTP Server: smtp.gmail.com
SMTP Port: 465

Security Type: BASIC
Account Name: <Your Account Name>
Password: <Your Password>
SSL: Yes

YAHOO Settings:
SMTP Server: plus.smtp.mail.yahoo.com
SMTP Port: 587

Security Type: BASIC
Account Name: <Your Account Name>
Password: <Your Password>
SSL: No
NOTE: FROM Address must be your Yahoo FROM Address