Controlled batch email module for Dolibarr ERP/CRM.
Copyright © 2025–2026 Colin Whyles
Licensed under the GNU General Public License v3 or later
BatchMailer provides a safe, auditable, batch-based email sending system for Dolibarr. It is designed for administrative and operational use where control, transparency, and recoverability matter more than speed or volume.
It was originally developed to support annual subscription renewals for a small organisation, but has since evolved into a general-purpose batch email tool suitable for:
- Membership renewals
- Event reminders
- Administrative notices
- Small, targeted announcements
BatchMailer is not a marketing platform:
- No open or click tracking
- No background or automated sending
- No bulk “fire-and-forget” campaigns
Instead, it focuses on human oversight and accountability.
BatchMailer enforces a deliberate, four-stage workflow:
- Profiles – reusable recipient selection rules
- Recipient Lists – snapshot lists generated from profiles
- Templates – reusable, tokenised email templates
- Send – controlled, batch-based delivery with safety checks
Each stage is explicit and reviewable.
There is no hidden state and no automatic progression.
- Profile-based recipient selection
- Snapshot recipient lists (immutable once generated)
- Reusable, tokenised email templates
- Mandatory preview using real recipient data
- Dry-run validation before sending
- Throttled, batch-based delivery
- Abortable and resumable campaigns
- Permanent, readable send logs
- Admin safety controls (Send Lock, recovery tools)
- Uses existing Dolibarr SMTP configuration
BatchMailer is intended for administrative and operational emails sent to known contacts.
It is deliberately conservative by design and prioritises safety, clarity, and recoverability over automation or volume.
- Full user documentation is provided in
docs/user_guide.md - Technical and architectural documentation is included in
docs/ - HTML and PDF versions can be generated from the Markdown sources
See INSTALL.md for installation and upgrade instructions.