tamarian
05-31-2003, 10:00 PM
What vBouncer does
vBouncer will reduce your server load, bandwidth, and your forum admin in-box, by unsubscribing members who keep bouncing their emails back to your forum admin email, which may bomb your mail box if you have a busy forum with many members who subscribe to many threads, but their emails are either invalid, in box full, or have ISP problems.
Screen shots
None, this is a command line script, with some changes in functions.php
Who may want to use this?
1. Very busy sites, with thousands of notifications a day.
2. Your admin box gets too many bouncing emails
3. You use sendmail. I'm not sure how this works on other mail servers.
Caution
This may drive some of your members mad :) If their email bounces a lot, this script will unsubscribe them from their favourite threads. They will have to fix their email account, and then subscribe manually to each thread again... This may not be due to bad emails, just ISP side problems.
Use at your own risk. I'm sharing this since some indicated interest at vBulletin.com in this thread:
http://www.vbulletin.com/forum/showthread.php?threadid=71496
I'd be glad to help answer questions, but as with most hacks, it is your responsibility....
Installation
1. Create a unique email address on your server, dedicated to catch bouncing emails. Do not use adminemail, or any other existing email that you want to receive through a POP account. This email will be used only to catch bouncing emails.
Recommended name (makes for less editing): subscriber_notify
2. Edit functions.php
Find:
// work out the 'From' header
if ($from == '') {
$headers = "From: \"$bbtitle Mailer\" <$webmasteremail>\r\n" . $headers;
} else {
$headers = 'From: "' . iif($username, "$username @ $bbtitle", $from) . "\" <$from>\r\n" . $headers;
}
// actually send the email message
mail($toemail, $subject, $message, trim($headers));
Replace with:
// work out the 'From' header
if ($from == '') {
$from = $webmasteremail;
$headers = "From: \"$bbtitle\" <$webmasteremail>\r\n" . $headers;
} else {
$headers = 'From: "' . iif($username, "$username @ $bbtitle", $from) . "\" <$from>\r\n" . $headers;
}
// actually send the email message
mail($toemail, $subject, $message, trim($headers), "-f$from");
Find:
vbmail($touser['email'], $emailsubject, $emailmsg);
Replace with: replace subscriber_notify@example.com with your domain name)
$emailerusername = "New Reply Notification";
$emailer = "subscriber_notify@example.com"; // change this to your bouncer email account.
$emailerheader = "Reply-To: $emailer\nErrors-To: $emailer\n";
vbmail($touser['email'], $emailsubject, $emailmsg, $emailer, $emailerheader, $emailerusername);
3. Copy vBouncer.pl.txt to a directory on your server. vBouncer.pl.txt is attached below.
Rename it to vBouncer.pl by typing:
mv vBounver.pl.txt vBouncer.pl
Make it executable by typing:
chmod +x vBouncer.pl
4. Edit the configuation section of vBouncer.pl
#! /usr/bin/perl -w
#
# USAGE: vBouncer.pl -bounce : to unsubscribe threads from members with bouncing email
# vBouncer.pl : with no parameters to see (test) who will be unsubscribed
#
# When done, remember to reset the email file,
# cp /dev/null subscriber_notify (or whatever filename your bouncing email file is chosen)
#
# Copyright (c) 2003 Mad SCO Disease, released under GPL. Mad SCO Disease reserves the right
# to sue your butt, if you don't buy out their small time company. Check eBay for current bids.
#
# Details on Mad SCO Disease provided here: http://www.opensource.org/sco-vs-ibm.html
# For the proper way to eat sane cows, check here: http://www.lowcarb.ca
# Config:
my $bouncelimit = 25; # how much bounced emails are allowed, before taking actions
my $unsubscribe = 1; # unsubscribe member from all subscribed threads, 1=yes, 0=no
my $changedefault = 1; # change subscription default to no. 1=yes, 0=no
my $nobulletin = 0; # This is only for those who installed the newsletter bulletin hack
# change receive bulletin option to no. 1=yes, 0=no
my $changeusergroup = 0;# change user group to bounced group, 1=yes, 0=no
# THIS IS NOT RECOMMENDED USE WITH CAUTION
# IF AMINS AND/OR MODS BOUNCE EMAILS, IT WON'T CHECK
# IF you really want to use this option, you will need to uncomment the code
my $bouncedgroup = 2; # the usergroup id for bouncing members, be careful, this number
# must match the user group id you setup in the vb control panel (not yet implemented)
my $bouncefile = "/var/spool/mail/subscriber_notify";
# the path/to/bouncing emails file. "subscriber_notify is the email name, you need
# to change it to the email name you chose for bouncing emails.
my $db="database"; # mysql database name
my $db_host="localhost"; # mysql host
my $db_username="username"; # mysql username
my $db_password="password"; # mysql password
5. Once a week or so, you can run the scropt manually, or through a cron job. When done, you have to clear the email file, otherwise it will keep unsubscribing members whos emails no longer bounce.
To run the script in test mode, type:
./vBounver.pl
To run the script in bouncer mode, type:
./vBounver.pl -bouncer
To clear the mail box, use:
cat /dev/null > subscriber_notify
6. Optional bonus: If you have very long threads, you can queue emails until the server load is acceptable. Edit /etc/sendmail.cf
Find:
# load average at which we just queue messages
#O QueueLA=5
Change to:
# load average at which we just queue messages
O QueueLA=3
This basically means sendmail will not attempt to deliver the email if your server is at load average of 3 or greater, it will place it in the mail queue for later delivery. You can change this number to suit your needs.
Planned enhancments (will wait for vB 3.0)
1. Instead of unsubscribing members threads, suspend notification by making a copy of their subscriptions, and copying them back when emails no longer bounce.
2. Track bounce history through admin panel,. This is similar to the old eGroup bouncing history.
3. Automatically PM members re their bounced emails.
4. Offer an option to admin to disable email notification to bouncing members, but keep the subscription. Similar to vB 3.0's daily and weekly notification, but adding a "no emails" option. This is also planned to be a seperate hack. If someone already has access to vB3.0, feel free to use this idea :)
Attached file is dated June 1st, 2003
vBouncer will reduce your server load, bandwidth, and your forum admin in-box, by unsubscribing members who keep bouncing their emails back to your forum admin email, which may bomb your mail box if you have a busy forum with many members who subscribe to many threads, but their emails are either invalid, in box full, or have ISP problems.
Screen shots
None, this is a command line script, with some changes in functions.php
Who may want to use this?
1. Very busy sites, with thousands of notifications a day.
2. Your admin box gets too many bouncing emails
3. You use sendmail. I'm not sure how this works on other mail servers.
Caution
This may drive some of your members mad :) If their email bounces a lot, this script will unsubscribe them from their favourite threads. They will have to fix their email account, and then subscribe manually to each thread again... This may not be due to bad emails, just ISP side problems.
Use at your own risk. I'm sharing this since some indicated interest at vBulletin.com in this thread:
http://www.vbulletin.com/forum/showthread.php?threadid=71496
I'd be glad to help answer questions, but as with most hacks, it is your responsibility....
Installation
1. Create a unique email address on your server, dedicated to catch bouncing emails. Do not use adminemail, or any other existing email that you want to receive through a POP account. This email will be used only to catch bouncing emails.
Recommended name (makes for less editing): subscriber_notify
2. Edit functions.php
Find:
// work out the 'From' header
if ($from == '') {
$headers = "From: \"$bbtitle Mailer\" <$webmasteremail>\r\n" . $headers;
} else {
$headers = 'From: "' . iif($username, "$username @ $bbtitle", $from) . "\" <$from>\r\n" . $headers;
}
// actually send the email message
mail($toemail, $subject, $message, trim($headers));
Replace with:
// work out the 'From' header
if ($from == '') {
$from = $webmasteremail;
$headers = "From: \"$bbtitle\" <$webmasteremail>\r\n" . $headers;
} else {
$headers = 'From: "' . iif($username, "$username @ $bbtitle", $from) . "\" <$from>\r\n" . $headers;
}
// actually send the email message
mail($toemail, $subject, $message, trim($headers), "-f$from");
Find:
vbmail($touser['email'], $emailsubject, $emailmsg);
Replace with: replace subscriber_notify@example.com with your domain name)
$emailerusername = "New Reply Notification";
$emailer = "subscriber_notify@example.com"; // change this to your bouncer email account.
$emailerheader = "Reply-To: $emailer\nErrors-To: $emailer\n";
vbmail($touser['email'], $emailsubject, $emailmsg, $emailer, $emailerheader, $emailerusername);
3. Copy vBouncer.pl.txt to a directory on your server. vBouncer.pl.txt is attached below.
Rename it to vBouncer.pl by typing:
mv vBounver.pl.txt vBouncer.pl
Make it executable by typing:
chmod +x vBouncer.pl
4. Edit the configuation section of vBouncer.pl
#! /usr/bin/perl -w
#
# USAGE: vBouncer.pl -bounce : to unsubscribe threads from members with bouncing email
# vBouncer.pl : with no parameters to see (test) who will be unsubscribed
#
# When done, remember to reset the email file,
# cp /dev/null subscriber_notify (or whatever filename your bouncing email file is chosen)
#
# Copyright (c) 2003 Mad SCO Disease, released under GPL. Mad SCO Disease reserves the right
# to sue your butt, if you don't buy out their small time company. Check eBay for current bids.
#
# Details on Mad SCO Disease provided here: http://www.opensource.org/sco-vs-ibm.html
# For the proper way to eat sane cows, check here: http://www.lowcarb.ca
# Config:
my $bouncelimit = 25; # how much bounced emails are allowed, before taking actions
my $unsubscribe = 1; # unsubscribe member from all subscribed threads, 1=yes, 0=no
my $changedefault = 1; # change subscription default to no. 1=yes, 0=no
my $nobulletin = 0; # This is only for those who installed the newsletter bulletin hack
# change receive bulletin option to no. 1=yes, 0=no
my $changeusergroup = 0;# change user group to bounced group, 1=yes, 0=no
# THIS IS NOT RECOMMENDED USE WITH CAUTION
# IF AMINS AND/OR MODS BOUNCE EMAILS, IT WON'T CHECK
# IF you really want to use this option, you will need to uncomment the code
my $bouncedgroup = 2; # the usergroup id for bouncing members, be careful, this number
# must match the user group id you setup in the vb control panel (not yet implemented)
my $bouncefile = "/var/spool/mail/subscriber_notify";
# the path/to/bouncing emails file. "subscriber_notify is the email name, you need
# to change it to the email name you chose for bouncing emails.
my $db="database"; # mysql database name
my $db_host="localhost"; # mysql host
my $db_username="username"; # mysql username
my $db_password="password"; # mysql password
5. Once a week or so, you can run the scropt manually, or through a cron job. When done, you have to clear the email file, otherwise it will keep unsubscribing members whos emails no longer bounce.
To run the script in test mode, type:
./vBounver.pl
To run the script in bouncer mode, type:
./vBounver.pl -bouncer
To clear the mail box, use:
cat /dev/null > subscriber_notify
6. Optional bonus: If you have very long threads, you can queue emails until the server load is acceptable. Edit /etc/sendmail.cf
Find:
# load average at which we just queue messages
#O QueueLA=5
Change to:
# load average at which we just queue messages
O QueueLA=3
This basically means sendmail will not attempt to deliver the email if your server is at load average of 3 or greater, it will place it in the mail queue for later delivery. You can change this number to suit your needs.
Planned enhancments (will wait for vB 3.0)
1. Instead of unsubscribing members threads, suspend notification by making a copy of their subscriptions, and copying them back when emails no longer bounce.
2. Track bounce history through admin panel,. This is similar to the old eGroup bouncing history.
3. Automatically PM members re their bounced emails.
4. Offer an option to admin to disable email notification to bouncing members, but keep the subscription. Similar to vB 3.0's daily and weekly notification, but adding a "no emails" option. This is also planned to be a seperate hack. If someone already has access to vB3.0, feel free to use this idea :)
Attached file is dated June 1st, 2003