Bounce Handler
Bounce Handler
Bounce Handler intelligently handles bounces from Dada Mail mailing list messages.
Messages sent to subscribers of your mailing list that bounce back will be directed to the List Administrator Address. This email account is then checked periodically by Bounce Handler.
Bounce Handler then reads awaiting messages and parses the messages in an attempt to understand why the message has bounced.
The parsed message will then be examined and an action will be taken.
The usual action that is taken is to apply a score to the email address that has bounced the message. Once the Score Threshold is reached, the email address is unsubscribed from the mailing list.
User Guide
For a guide on using Bounce Handler, see the Dada Mail Manual:
http://dadamailproject.com/pro_dada/using_bounce_handler.html
For more information on Pro Dada/Dada Mail Manual:
http://dadamailproject.com/purchase/pro.html
Obtaining a Copy of the Plugin
Bounce Handler is located in the, dada/plugins directory of the main Dada Mail distribution, under the filename, bounce_handler
Requirements
POP3 Email Account
Bounce Handler works by checking a email address via POP3. (IMAP is not supported).
You will need to create a new email address account manually for Bounce Handler to utilize.
Example: create bounces@yourdomain.com, where, yourdomain.com is the name of the domain Dada Mail is installed on.
Guidelines on this address:
Do NOT use this address for anything except Bounce Handler
No one will be checking this POP3 account via a mail reader.
Doing so won't break Dada Mail, but it will stop Bounce Handler from working correctly, if when checking messages, your mail reader then removes those messages from the POP3 account. If you do need to periodically check this inbox, make sure to have your mail reader set to not automatically remove the messages.
The email address MUST belong to the domain you have Dada Mail installed
Meaning, if your domain is, "yourdomain.com", the bounce email address should be something like, "bounces@yourdomain.com". In other words, do not use a Yahoo! Gmail, or Hotmail account for your bounce address. This will most likely disrupt all regular mail sending in Dada Mail.
Bounce Handler MUST be able to check the POP3 account
Check to make sure that the POP3 server (usually, port 110) is not blocked from requests coming from your hosting account server.
Installation
This plugin can be installed during a Dada Mail install/upgrade, using the included installer that comes with Dada Mail. Under Plugins/Extensions (Optional) check the option, Bounce Handler.
Below this option are form fields to put in the POP3 accounts login credentials, as well as a place to test those credentials out.
Once Dada Mail installed, all new mailing lists will use the Bounce Handler's email address as the List Administrator. Any previous mailing lists may need to be manually set to have their List Administrator set to this address - this can be done in the List Control Panel under, Your Mailing List - List Information
Cronjob
Bounce Handler runs in the background on a schedule. Make sure to set Dada Mail's cronjob:
http://dadamailproject.com/d/features-scheduled_cronjobs.pod.html
FAQ
Bounce Email Address
Do you use only one Bounce Email Address for all the mailing lists?
Yes.
Even though there's only one Bounce Email Address, it is used by all the mailing lists of your Dada Mail, but Bounce Handler will work with every mailing list individually. Each mailing list also has a separate Bounce Scorecard.
COPYRIGHT
Copyright (c) 1999 - 2015 Justin Simoni http://justinsimoni.com All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
Parts of this script were swiped from Mail::Bounce::Qmail module, fetched from here:
http://mikoto.sapporo.iij.ad.jp/cgi-bin/cvsweb.cgi/fmlsrc/fml/lib/Mail/Bounce/Qmail.pm
The copyright of that code stated:
Copyright (C) 2001,2002,2003 Ken'ichi Fukamachi All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Thanks Ken'ichi