Dolibarr/sendrecurringinvoicebymail
1
0
Fork 0
Code Issues Pull requests Releases 6 Activity Actions
Dolibarr module to send recurring invoice by email.
42 commits 2 branches 6 tags 683 KiB
PHP 100%
Find a file
Chl f94ba084a3 Disable Dolibarr filter on email addresses and subject 
'was wondering if the filter change of Dolibarr 13 might have affected
something else and, well, yes...

So, following e1ac0a6d69, we also disable the
filter for the email addresses, else we get something like
"Webmaster <webmaster@bugness.org>" becoming "Webmaster".
2024-08-25 15:10:07 +02:00
.tx Commit initial 2018-12-01 22:40:20 +01:00
admin Add a notice if the module cron is disabled 2021-12-05 02:09:37 +01:00
class $conf->global->MAIN_MAIL_ERRORS_TO is not always set 2024-03-15 01:22:23 +01:00
core/modules Preparing 0.3.5 release 2024-08-17 21:37:00 +02:00
img v. 0.3.0 : customization form for each recurring invoice 2021-03-23 15:27:33 +01:00
langs Add a notice if the module cron is disabled 2021-12-05 02:09:37 +01:00
sql [DB upgrade] Adding a field to select the mail's body format 2021-12-05 02:01:00 +01:00
test/phpunit Renaming from sendfacrecmail to sendrecurringinvoicebymail 2019-08-03 19:08:07 +02:00
.editorconfig Commit initial 2018-12-01 22:40:20 +01:00
.gitattributes Commit initial 2018-12-01 22:40:20 +01:00
.gitignore Commit initial 2018-12-01 22:40:20 +01:00
ChangeLog.md Preparing 0.3.5 release 2024-08-17 21:37:00 +02:00
COPYING Commit initial 2018-12-01 22:40:20 +01:00
fiche-rec-tab1.php Disable Dolibarr filter on email addresses and subject 2024-08-25 15:10:07 +02:00
modulebuilder.txt Commit initial 2018-12-01 22:40:20 +01:00
phpdoc.dist.xml Renaming from sendfacrecmail to sendrecurringinvoicebymail 2019-08-03 19:08:07 +02:00
README.md readme: specify 'customer invoice' 2024-03-13 18:54:01 +01:00

README.md

SendRecurringInvoiceByMail for DOLIBARR ERP CRM

Features

(en) This module sends by email the customer invoice generated with a recurring invoice template via scheduled jobs.

(fr) Ce module envoie par mail les factures clientes générées automatiquement par les travaux planifiés et les factures modèles.

You can customize the mail globally or by recurring invoice.

Screenshot n° 1

To edit the default global mail template, go to Home > Setup > Emails > Email templates, and modify the SendRecurringInvoiceByMail : original template. If you don't want to attach the PDF of the invoice to the mails, set the Attach file input to 0 (default: 1, PDF attached).

To edit the default sender address, go to Home > Setup > Emails, and edit the Sender email for automatic emails field.

This module hooks himself on the end of the Recurring invoices job from the Scheduled jobs (aka. cron) module. It will only be triggered via this Scheduled job and will not send mail when manually generating an invoice from a recurring invoice template.

Requirements

It requires Dolibarr version 10.0 at least (first version with the cron/afterCreationOfRecurringInvoice() hook).

Don't forget to also activate the Scheduled jobs module.

Other modules are available on Dolistore.com.

Install

From the ZIP file and GUI interface

Go to Home > Setup > Modules/Applications and finally the Deploy/install external app/module tab and upload the module_sendrecurringinvoicebymail-x.y.z.zip file (you can get it from the original forge or Github).

Next, on the Modules/Applications page, activate the newly available sendrecurringinvoicebymail module, and probably the Scheduled jobs (alias cron or modCron) integrated module too.

Troubleshooting

Note: If the module screen tells you there is no custom directory, check that your setup is correct:

  • In your Dolibarr installation directory, edit the htdocs/conf/conf.php file and check that following lines are not commented:

    //$dolibarr_main_url_root_alt ...
//$dolibarr_main_document_root_alt ...

  • Uncomment them if necessary (delete the leading //) and assign a sensible value according to your Dolibarr installation

    For example :

    • UNIX:

      $dolibarr_main_url_root_alt = '/custom';
$dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';

    • Windows:

      $dolibarr_main_url_root_alt = '/custom';
$dolibarr_main_document_root_alt = 'C:/My Web Sites/Dolibarr/htdocs/custom';

From a GIT repository

  • Clone the repository in $dolibarr_main_document_root_alt/sendrecurringinvoicebymail
cd ....../custom
git clone https://code.bugness.org/Dolibarr/sendrecurringinvoicebymail.git sendrecurringinvoicebymail

Then, from your browser:

  • Log into Dolibarr as a super-administrator
  • Go to "Setup" -> "Modules"
  • You should now be able to find and enable the module

Updating instructions

  • Disable the module,
  • Update the files (see Install),
  • Re-enable the module.

Licenses

Main code

GPLv3 logo

GPLv3 or (at your option) any later version.

See file COPYING for more information.

Documentation

All texts and readmes.

GFDL logo