Skip to content
/ billo Public

Simple tool for hosting static mailing lists on regular webhosting accounts

Notifications You must be signed in to change notification settings

dschmidt/billo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Billo Mailing Lists

This is a simple project for hosting static mailing lists on regular webhosting accounts.

It works by fetching unread messages from a Mailbox (for example via IMAP) and resending to users on mailing lists. Mails are marked as read afterwards, so they won't be sent again.

Mailing lists are configured in a config file that looks like this:

[[email protected] = Some List]
user@some-domain.tld = "Foo"
someone@other-domain.de = "Bar"

[[email protected] = Another List]
user@some-domain.tld = "Foo"
whoever@other-domain.de = "Bar"

This defines two mailing lists with two members each. The mailing list addresses need to be configured to end up in the same mailbox.

Retrieving and sending emails

Mail servers need to be configured in config.php in the project root folder:

<?php
use Laminas\Mail\Storage\Imap;
use PHPMailer\PHPMailer\SMTP;

$GLOBALS['mailStorage'] = new Imap([
  'host'     => '...',
  'user'     => '...',
  'password' => '...',
]);

$GLOBALS['mailSender'] = new BilloPHPMailer();
// $mailSender->SMTPDebug = SMTP::DEBUG_SERVER;                   // Enable verbose debug output
$mailSender->isSMTP();                                         // Send using SMTP
$mailSender->Host       = '....';                              // Set the SMTP server to send through
$mailSender->SMTPAuth   = true;                                // Enable SMTP authentication
$mailSender->Username   = '...';                               // SMTP username
$mailSender->Password   = '...';                               // SMTP password
$mailSender->SMTPSecure = BilloPHPMailer::ENCRYPTION_STARTTLS; // Enable TLS encryption; `PHPMailer::ENCRYPTION_SMTPS` encouraged
$mailSender->Port       = 587;                                 // TCP port to connect to, use 465 for `PHPMailer::ENCRYPTION_SMTPS` above

For retrieving mails from the mailbox you need to provide a Laminas Mail Storage implementation, e.g. Imap. For sending mails you need to provide an instance of the Billo PHPMailer subclass. You can configure it just like the upstream version.

Installation

Apart from creating the config files, you need to checkout deps with composer install.

Create a cronjob that fetches and sends mails as often as you want. Be careful not to start two parallel runs.

Run Billo

php src/billo.php --config /path/to/your/listsConfig.ini

TODO

  1. Better error handling and proper error messages
  2. Throttling
  3. Lock file for avoiding race conditions in parallel runs
  4. Improve documentation
  5. Improve usage() message
  6. Set useful mailing list headers
  7. Set return-path

Name

Billo is a German slang word for billig and can probably be translated as cheap or shoddy. It seems to fit the kinda hack-ish approach of this project fairly well :)

About

Simple tool for hosting static mailing lists on regular webhosting accounts

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages