Setup EMails: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
mNo edit summary
Line 7: Line 7:




The EMails setup screen allows you to setup Dolibarr to send EMails.
The EMails setup screen allows you to setup Dolibarr to send EMails and to test your setup.
 
= Setup parameters =
This is explanation of all setup parameters:


Modify the following option:
== Disable globally all emails sendings (test mode or demo) ==
== Disable globally all emails sendings (test mode or demo) ==
Set this to No. If you set to yes (for a demo system for example), no more mail will be sent.
Set this to No. If you set to yes (for a demo system for example), no more mail will be sent.
== Method to send emails ==
== Method to send emails ==
The default method is '''PHP mail function'''. This means that Dolibarr use your PHP to send emails.
The default method is '''PHP mail function'''. This means that Dolibarr use your PHP to send emails.
The choice '''Simplemail class''' do the same thing.
The choice '''Simplemail class''' do the same thing.
If your email sending server needs authentication, you must choose '''SMTP/SMTP-AUTH''', validate, this will make the field login or password appears on this page.
If your email sending server needs authentication, you must choose '''SMTP/SMTP-AUTH''', validate, this will make the field login or password appears on this page.
== Hostname or ip address of SMTP/SMTPS sending server ==
== Hostname or ip address of SMTP/SMTPS sending server ==
Name or IP address of the server that send mail. It is usually an name like smtp.xxx.zzz provided by your Internet Service Provider.
Name or IP address of the server that send mail. It is usually an name like smtp.xxx.zzz provided by your Internet Service Provider.
For example: smtp.aol.com, smtp.free.fr, smtp.myprovider.com
For example: smtp.aol.com, smtp.free.fr, smtp.myprovider.com


== Port of email sending server ==
== Port of SMTP/SMTPS sending server ==
If the email sending server use the standard port (25), you can let the field empty.
If the email sending server use the standard port (25), you can let the field empty.
== SMTP Authentification ID ==
== SMTP Authentification ID ==
Visible if you have choose '''SMTP-AUTH''' as sending method. Put here your login.
Visible if you have choose '''SMTP-AUTH''' as sending method. Put here your login.
== SMTP Authentification Password ==
== SMTP Authentification Password ==
Visible if you have choose '''SMTP-AUTH''' as sending method. Put here your password.
Visible if you have choose '''SMTP-AUTH''' as sending method. Put here your password.
== Usage of TLS (SSL) ==
== Usage of TLS (SSL) ==
Some emails servers require SSL encrypted communication (For example the SMTP server of Google smtp.gmail.com). It's SMTPS.
Some emails servers require SSL encrypted communication (For example the SMTP server of Google smtp.gmail.com). It's SMTPS.
Line 35: Line 42:
== EMail used as sender for automatic emails ==
== EMail used as sender for automatic emails ==
EMail that will be used by Dolibarr as emails sender if sender is not explicitly defined.
EMail that will be used by Dolibarr as emails sender if sender is not explicitly defined.
= Actions =
== Test server availability ==
This button is to test if you can communicate with the server. This allow you validate the parameter:
* Hostname or ip address of SMTP/SMTPS sending server
* Port of SMTP/SMTPS sending server
* Usage of TLS (SSL)
== Test send email ==
This button is to test what happens when you send an email with simple text content.
== Test send email HTML ==
This button is to test what happens when you send an email with HTML content.

Revision as of 14:42, 1 November 2009

Help about screen: EMail setup

Menu path: Home -> Setup -> EMails


The EMails setup screen allows you to setup Dolibarr to send EMails and to test your setup.

Setup parameters

This is explanation of all setup parameters:

Disable globally all emails sendings (test mode or demo)

Set this to No. If you set to yes (for a demo system for example), no more mail will be sent.

Method to send emails

The default method is PHP mail function. This means that Dolibarr use your PHP to send emails. The choice Simplemail class do the same thing. If your email sending server needs authentication, you must choose SMTP/SMTP-AUTH, validate, this will make the field login or password appears on this page.

Hostname or ip address of SMTP/SMTPS sending server

Name or IP address of the server that send mail. It is usually an name like smtp.xxx.zzz provided by your Internet Service Provider. For example: smtp.aol.com, smtp.free.fr, smtp.myprovider.com

Port of SMTP/SMTPS sending server

If the email sending server use the standard port (25), you can let the field empty.

SMTP Authentification ID

Visible if you have choose SMTP-AUTH as sending method. Put here your login.

SMTP Authentification Password

Visible if you have choose SMTP-AUTH as sending method. Put here your password.

Usage of TLS (SSL)

Some emails servers require SSL encrypted communication (For example the SMTP server of Google smtp.gmail.com). It's SMTPS.

The only method that support this protocol is "SMTP/SMTPS socket library". You can enable cryptography by setting this parameter to Yes.

Note: SSL functions must be available in your PHP. If not, you probably forget to install the openssl module of PHP.

EMail used as sender for automatic emails

EMail that will be used by Dolibarr as emails sender if sender is not explicitly defined.

Actions

Test server availability

This button is to test if you can communicate with the server. This allow you validate the parameter:

  • Hostname or ip address of SMTP/SMTPS sending server
  • Port of SMTP/SMTPS sending server
  • Usage of TLS (SSL)

Test send email

This button is to test what happens when you send an email with simple text content.

Test send email HTML

This button is to test what happens when you send an email with HTML content.