Line 14:
Line 14:
userdoc=This page}}
userdoc=This page}}
−
= Introduction =
+
=Introduction=
This module permits to send mass emailing to your customers, suppliers, prospects, contacts, members, or users.
This module permits to send mass emailing to your customers, suppliers, prospects, contacts, members, or users.
−
= Installation =
+
=Installation=
{{NoInstallModuleEn}}
{{NoInstallModuleEn}}
−
= Setup =
+
=Setup=
{{ActivationModuleEn}}
{{ActivationModuleEn}}
Check also that Dolibarr setup to send mails is ok: [[Setup EMails]]
Check also that Dolibarr setup to send mails is ok: [[Setup EMails]]
−
= Usage =
+
Check also the setup options available in [[Setup Other|Setup Other, for the emailing module]]. Amongst others, you can set the number of emails to be sent from your web interface with MAILING_LIMIT_SENDBYWEB.
+
+
[[File:Warning.png]] Note: If a constant MAILING_NO_USING_PHPMAIL is set to 1 in Home - Setup - Other, it is only possible to send emailing when the send mode in setup is not on "PHP Mail" but on another mode (like "SMTPs").
+
+
=Usage=
Mass E-Mailing features are available from menus (if [[Module EMailing]] has been activated).
Mass E-Mailing features are available from menus (if [[Module EMailing]] has been activated).
Menu link can be found in menu "''Tools''" with default menu manager "''Eldy''".
Menu link can be found in menu "''Tools''" with default menu manager "''Eldy''".
−
== Life cycle / Business rules ==
+
==Life cycle / Business rules==
The full process is this one:
The full process is this one:
- You create an emailing with a title, a topic and an email sender (For this, click on menu "Tools - EMailings - New emailing", input the content of the email with substitue variables and click on "Create emailing" button. The other solution is to go on an existing emailing and click "Clone").
- You create an emailing with a title, a topic and an email sender (For this, click on menu "Tools - EMailings - New emailing", input the content of the email with substitue variables and click on "Create emailing" button. The other solution is to go on an existing emailing and click "Clone").
−
- Then you choose the targets, among predefined dynamic lists from your Dolibarr data or from external files (For this, go on tab "Recipients" and click on button "Add" for predefined lists you want).
+
- Then you choose the targets, among predefined dynamic lists from your Dolibarr data or from external files (For this, go on tab "Recipients" and click on button "Add" of the predefined lists you want).
−
- You can modify this list, by removing targets for example.
+
- You can modify this list, by removing targets for example, orcadding targets from dufferent sources.
- The user responsible to validate emailing checks content and recipients. He can do a test to its own e-mail address to see the result inside its email software.
- The user responsible to validate emailing checks content and recipients. He can do a test to its own e-mail address to see the result inside its email software.
If results looks good, he set the status of e-mailing to ''validated'' (For this, click on button "Validate").
If results looks good, he set the status of e-mailing to ''validated'' (For this, click on button "Validate").
−
- The mass e-mail sending is done then from screen or command line with script [[Script mailing-send.php]]. Only an emailing with status Validated can be sent by the script.
+
- The mass e-mail sending is done then from:
+
+
*the web application screen. In such a case, there is a limit in number of emails sent in one step, 50 by defaut in most cases. If you have more than 50 recipients, you can submit the emailing from screen a second time and the application will automatically send emails to the 50 next recipients. Repeat until all recipients are addressed.
+
*or from the command line with script [[Script mailing-send.php]].
−
See page [[Script mailing-send.php]] for more information on how to launch it from command line.
+
Only an emailing with the status '''Validated''' can be sent by the script. See page [[Script mailing-send.php]] for more information on how to launch it from command line.
- The global status for e-mailing and send result for each recipient will be updated and visible.
- The global status for e-mailing and send result for each recipient will be updated and visible.