Auto Bounce Messages Management
 

Introduction: quoted from wikipedia with adaptation.
Any long-lived forums is going to eventually contain addresses that can't be reached. Addresses that were once valid can become unusable because the person receiving the mail there has switched to a different provider (possibly as a result of changing jobs or schools). In another scenario, the address may still exist but be abandoned, with unread mail accumulating until there is not enough room left to accept any more.

The presence of invalid addresses in the forums results in bounce messages being sent to the owner of the forums. If the mailing list is small, the owner can read the bounce messages and manually remove the invalid addresses from the forums. With a larger forums, this is a tedious, unpleasant job, so it is desirable to automate the process.

In short: This hack automates handling of the bounce messages.


Requirements:

• vBulletin 3.7.1
• catch-all email address, with POP3 access. (I use Google app (Gmail))

Features:

• Auto Bounce Messages Management.
• Uses POP3 protocol to retrieve messages from your catch-all email box.
• On bounce detection the user will be moved to bounce usergroup (you can set which usergroup).
• Works according to VERP.

A note:
I believe there is no need to delete the user subscriptions. because once a user got moved to the "Awaiting email confirmation" usergroup, he / she won't be sent any additional emails.

How Does It Work?
You have your catch-all email box, that will be used to receive the bounce messages. Of course we must have a POP3 access to retrieve messages from it.
Let's suppose that your catch-all email address is bounces@yourdomain.ext
After we set it properly, it will work as described below:
1) By default: On every single message being sent, vBulletin generates a unique Message-ID for it, example:
This ID is generated By using the following code in /includes/class_mail.php:
I take the red portion from the unique Message-ID, and the red portion from the domain name of the catch-all address:
The result will be: Now every single message has its own unique envelope-from address. so if it gets returned as a bounce, I will recognize it easily.
So every message will be recorded in the database. each record consists of : toemail, bounceemail (the one we generated) and the timeline (for sake of pruning.)
2) A cron job runs every ten minutes to retrieve bounce messages from the catch-all email box.
If the message sent to something similar to the bounceemail we generate, it will update the appropriate record in the database to be marked as returned. and delete the message from the POP3 server.
3) Another cron job runs once an hour, reads the bounced emails from the database and moves their owners to an usergroup which is determined by the admin from the settings.
4) Yet another cron job, will run once daily, to prune the records that haven't returned bounces in a settable period of time (30 days by default).

Did I miss something here?
Yeh, right. this is the first beta, I believe the core is almost done. but there may be some functions to add, and few things to tweak.
I'm all opened to your suggestions. So feel free to dream!

Installation & Upgrade:
1) Have your own catch-all email with POP3 access. I don't have the time to write a how-to article for this please do it yourself, you'll be luckily if someone explains it to others.
2) Upload files from the /upload/ folder in the package to their appropriate locations.
3) Install the xml product file: product-bounce_management.xml, of course choose yes to override when upgrading.
4) Refresh your AdminCP. you will see at the navigation side, above the Users tab, a new tab called "Bounces Management"
5) At that tab, go to the settings: Set your POP server settings, your "Bounce Usergroup" and "Exclude Usergroups".
6) At the same tab you will find a link called "Test POP Connection" to test the connection with your POP server.
7) Enjoy! Click install to let me enjoy too!

Settings:
Attachment 81933

Know issues:
- In rare situations, a vacation reply may returned via the bounce path rather than the webmaster path.


Change log:

• 1.0.0.b.1 first public release, on June, 8 2008.

Support:
The product marked as not supported, but that doesn't mean you won't see me again here.
So please try to help each other.

License & Credits:
1) I use the pop3_class from Manuel Lemos, Copyright (c) 1999-2005 to retrieve messages from the POP server, so all the credits regarding this go to him.
Here is his license (included in the package too):

Click install to receive updates.
You like it? nominate it. I'm looking forward to enter the Mod Of The Month competition.
I depend on you.
Also donations will help me to improve the product. :up:

/ * reserved

First install, woot :]

Looks nice, though personally I won't run it as I don't like providing back links to others websites.


READ THIS!

Hi Zachery,

I understand you. Actually, I want something in return for my time and efforts.

Best regards

That quick? woot :)

very nice

thanks milad

Many thanks Milad! I am looking forward to future versions.

Please consider to add:

• different responses to different error codes / Custom filters to match patterns in bounced emails. i.e. permanent error, mailbox full, etc should get a different response. Not many webmasters want their members account inactivated when a mailbox is full.
• Stats on members with bouncing emails, and error codes
• Turns on Popup Notification of new Private Messages for bouncing member
• Automatically send a notification PM to bouncing Member (customizable message)
• Return members to their original usergroup when the member updates & confirms their new email.

I'll have to give this a try, because I have around 200 000 members and many of them will be bouncing.

Please let us know how that goes. Are you planning to do a mass emailing?

A very nice forum BTW!

Thats nice, but I won't run it or recomend it to anyone because of the back link. Or the copyright text in general, since this is completely a backend feature that a normal user will never see.

Not that i have a problem with copyrights, or authors wanting to benifit from their work.

Agreed. Why would I put your copyright on the frontend of my site when it's a backend feature?

Seems like you just want to cash in on big forums linking to you.

Guys, you discourage me!

I'm disappointed that simpler mods have got attention more than this one.

mate, he didnt mean to discourage you.
but how many copyrights we gonna put on forumhome ?
i have already three huh.

anyway Best ever hack for 3.7.0 :up:
:D

Sorry but I have to agree as well, having a compulsory copyright is a big turnoff for me to use this feature since it is back-end. I can understand a major front-end feature having one (like VBCredits points system for example, which I agreed to having in my footer) but not something like this. If most/all authors decided to copyright their work like this, then the footers of forums would be extremely unattractive since they would be essentially full of spam links.

SO I have much respect for authors who understand this issue and give users the option to display the copyright or not from the ACP, and chances are I would be more obliged to do so knowing that its not being forced.

Don't mean to discourage either, just hope that you reconsider this decision because it really is a great feature that shouldn't be burdened with something which makes it less attractive to install/use.

Otherwise well done on great work :)

Cheers :)

Can you add this same resource from the mod EZ Bouced Email Management?

Thanks a lot, This is a great starting point for a great addon. I do think that it needs the features Alfa1 suggested making it more like VBouncer. Also a catch-all address can be hard for a lot of users. I get hundreds, usually 200 - 300 a day of attempted spams to non existant addresses. These will all now not be refused and dump all the spams into the catch-all.

Yes, it's a better idea to use an MTA with VERP support (that sends only bounces with the VERP address pattern to a bounce mailbox), instead of a catch-all address.

That would require this add-on to actually use VERP (mailbox+memberid@ourdomain), rather than a proprietary pattern similar to VERP :(

I agree. My MTA calls it + addressing I think. If the format was changed slightly to mailbox+messageid@domain.com then people could use a compatible MTA or if they do not have one they could use a catch-all. I think the messageid idea is good to verify the bounce is not a fake bounce causing havoc to your members.

For me, I use Gmail. it handles the spam very well. Spam messages go to the spam box, and the bounce messages will be returned to me.

This is very easy and nice.

If you have a better pattern to suggest, go on.

mailbox+memberid@ourdomain won't be a good approach, because it can be abused by members. someone may send a fake email to kick someone else. so we can't use a simple pattern.

mailbox+messageid@domain.com is a good idea. I use bouncemessageid@domain.com not too different. I can alter it to mailboxmessageid@domain.com if you will get benefit from it.

Exactly. I'm not leaving this mod for kids to play with it. it got to be secure. for sure.

Our own spam filters do a very good job at actually catching the spam. The main one is refusing connections for non existing accounts. Mail that does get through to real addresses will then be tagged if they are spam and passed to the MTA and moved by the MTA to the spam folder. By using a catch-all I increase the load on the MTA that the spam filters are currently releiving it of.

If you add a + sign in between the mailbox name and the message id then I think from what I have read about VERP you will be compatible. Then people can still use catch-all if they have no other choice. I am not an expert in VERP but this is how i understand it.

Yes, Then an account named bounce will catch all email to bounce+(anything)@domain.com but will not catch anything that does not start bounce+. This will definatly help in my situation and as i understand it any VERP compatible MTA.

Would you please give me a link to what you've read?

Regards

I think it's acceptable to use + or =

Just the info in wikipedia.


I can use one of four characters + - _ or %.

On wikipedia the = sign is used as an example to replace the @ if you are adding the users full email address in the return address.

Looks good, but as others have said, the copyright on FORUMHOME is completely unnecessary. So, for that reason, I'm not installing.

Same here.

If we help each other can we request homepage links too :p

The copyright is my only method to get back what I spend of time and efforts.
I'm sorry, this is not commercial product, but it requires a lot of work. you wouldn't do it for free.

You're free not to use it.

Best regards

I'm thinking about making it as a pattern. every webmaster will change it according to his/her needs.

Alot of us spend time working on things, we do it because we feel our own sites need it, or we wanted to help out.

If you coded this purely for wanting to attract attention to your website... I really don't have anything more to say then.

Not only that - but the vast majority of sites that will be using the Auto Bounce Messages Management hack are English-only sites, which would totally defeat the purpose of showing that ridiculous backlink anyway :D

Jacquii.

Everyone who makes hacks here are in the same boat, myself included. Just seems to me that you want to get a lot of backlinks to your site.

A great mod but just like the rest I will not install because of the copyright. I agree with Zachery you just want the backlinks.

OK, never mind. I'm sorry for that. I'm going to make the copyright optional.

Thus, I appreciate if you post a backlink to my site. when you announce the automation to your members.

Regards

Great thanks, as i have a non-english community so it wont work for back linking to you :D

Please let's just concentrate on the mod!

is there any way to know who was move because email bounce ?