Register Members List Search Today's Posts Mark Forums Read

Reply
 
Mod Options
Auto Bounce Messages Management Details »
Auto Bounce Messages Management
Mod Version: 1.0.0.b.1, by Milad (Coder) Milad is offline
Developer Last Online: Mar 2022 I like it Show Printable Version Email this Page

This modification is in the archives.
vB Version: 3.7.0 Rating: (6 votes - 5.00 average) Installs: 86
Released: 08 Jun 2008 Last Update: 08 Jun 2008 Downloads: 335
Not Supported DB Changes Uses Plugins Additional Files Is in Beta Stage  

Brought to you by Syrian Medical Society & Milado

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 [email protected]
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:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

This ID is generated By using the following code in /includes/class_mail.php:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

I take the red portion from the unique Message-ID, and the red portion from the domain name of the catch-all address:

Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.


Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

The result will be:
Block Disabled:      (Update License Status)  
Suspended or Unlicensed Members Cannot View Code.

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):
Copyright (c) 1999-2005, Manuel Lemos
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:

* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.
* Neither the name of the Manuel Lemos nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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.

Download Now

Only licensed members can download files, Click Here for more information.

Screenshots

Click image for larger version

Name:	20080608_233132.jpg
Views:	1447
Size:	68.8 KB
ID:	81933  

Show Your Support

  • To receive notifications regarding updates -> Click to Mark as Installed.
  • This modification may not be copied, reproduced or published elsewhere without author's permission.
  #91  
Old 05 Aug 2008, 08:53
Raptor Raptor is offline
 
Join Date: Nov 2001
ok got this all running HOWEVER its not moving any users to the bounce usergroup - I notice many others with the same problem

here is the message after the cron is run

ABMM: Retrive Bounces

Connected to the POP3 server "pop.1and1.co.uk".
User "bounce@*******.com" logged in.
There are 10521 message(s) in the mail box with a total of 31975516 bytes.
Disconnected from the POP3 server "pop.1and1.co.uk".
Done
Id love to get this to work - as you can see I have a heavy board and a lot of users to process.

I would pay $$ to get this working

Last edited by Raptor; 05 Aug 2008 at 18:51.
Reply With Quote
  #92  
Old 05 Aug 2008, 17:58
Gersfan Gersfan is offline
 
Join Date: Dec 2007
Is this working?
Reply With Quote
  #93  
Old 05 Aug 2008, 18:51
Raptor Raptor is offline
 
Join Date: Nov 2001
here is my test msg

Connecting to pop.1and1.co.uk ...
S +OK POP server ready H mimap11
Connected to the POP3 server "pop.1and1.co.uk".
C USER bounce@*********.com
S +OK password required for user "bounce@*********.com"
C PASS *******
S +OK mailbox "bounce@*********.com" has 10521 messages (31975516 octets) H mimap11
User "bounce@*********.com" logged in.
C STAT
S +OK 10521 31975516
There are 10521 message(s) in the mail box with a total of 31975516 bytes.
Reply With Quote
  #94  
Old 06 Aug 2008, 01:39
ams3521 ams3521 is offline
 
Join Date: May 2005
Same problem as Raptor, seems to work ok but the bounced users do not get moved to the new usergroup.

Great hack by the way if it worked.
Reply With Quote
  #95  
Old 06 Aug 2008, 19:46
Raptor Raptor is offline
 
Join Date: Nov 2001
so far 15 users have been moved - out of around 10,000 that need sorting lol

so its almost there - im sure it will get sorted
Reply With Quote
  #96  
Old 07 Aug 2008, 21:35
ams3521 ams3521 is offline
 
Join Date: May 2005
lol
did u do anything Raptor to move those 15 or did u just leave it?
I'm asking as i have disabled it at the moment.
Reply With Quote
  #97  
Old 09 Aug 2008, 10:32
Raptor Raptor is offline
 
Join Date: Nov 2001
I just left it - its at 53 atm however there is still many thousands to be processed.

is this mod still being worked on ?

Connecting to pop.1and1.co.uk ...
S +OK POP server ready H mimap40
Connected to the POP3 server "pop.1and1.co.uk".
C USER bounce@********.com
S +OK password required for user "bounce@********.com"
C PASS *******
S +OK mailbox "bounce@********.com" has 11242 messages (34093668 octets) H mimap40
User "bounce@********.com" logged in.
C STAT
S +OK 11242 34093668
There are 11242 message(s) in the mail box with a total of 34093668 bytes.
Reply With Quote
  #98  
Old 14 Aug 2008, 10:38
Gersfan Gersfan is offline
 
Join Date: Dec 2007
I guess It's not working them, I'll probarly have to install the EZ version and manualy move accounts.
Reply With Quote
  #99  
Old 14 Aug 2008, 18:33
TheInsaneManiac TheInsaneManiac is offline
 
Join Date: Feb 2008
So is there a way that if a user has inputted a fake email and it gets bounced, that the email would no longer be emailed therefor saving server resources.?
Reply With Quote
  #100  
Old 15 Aug 2008, 06:48
Raptor Raptor is offline
 
Join Date: Nov 2001
Is this going to get updated or not ?

I've already offered $$$
Reply With Quote
  #101  
Old 15 Aug 2008, 08:06
Milad's Avatar
Milad Milad is offline
 
Join Date: May 2005
Real name: Milad
Raptor, please don't push!
Reply With Quote
  #102  
Old 19 Aug 2008, 13:23
Gene Steinberg Gene Steinberg is offline
 
Join Date: Dec 2006
Real name: Gene Steinberg
Originally Posted by Gersfan View Post
I guess It's not working them, I'll probarly have to install the EZ version and manualy move accounts.
I can't get the EZ version to function at all with 3.7.2. I get the bounced mails, but they don't have the requisite links that EZ is supposed to insert. I tried both the header and the insertion at the bottom of the message -- no luck. The coder doesn't respond to the post I presented on the subject.

So I'm back to this one, but it's not fully reliable either. It doesn't appear to be parsing even a fraction of the actual bounces.

Milad, any help here?

Peace,
Gene
Reply With Quote
  #103  
Old 20 Aug 2008, 12:21
Milad's Avatar
Milad Milad is offline
 
Join Date: May 2005
Real name: Milad
This is beta 1, you're expecting too much from the first beta.

I worked on beta 2. but din't finish it yet. Some commercial projects have higher priorities.

So please be patient.
Reply With Quote
  #104  
Old 20 Aug 2008, 14:22
Gene Steinberg Gene Steinberg is offline
 
Join Date: Dec 2006
Real name: Gene Steinberg
Originally Posted by Milad View Post
This is beta 1, you're expecting too much from the first beta.

I worked on beta 2. but din't finish it yet. Some commercial projects have higher priorities.

So please be patient.
I just want it to work.

Do you have any ideas yet when beta 2 will be finished?

Peace,
Gene
Reply With Quote
  #105  
Old 22 Aug 2008, 03:02
fatal1980 fatal1980 is offline
 
Join Date: Jul 2006
Originally Posted by ThorstenA View Post
I agree that a copyright notice is okay. But I need to know that there is a notice and where it is placed. Here it is placed on *all* of my pages. This for an administorial modification! You'd never think there's a copyright notice at all. If administrators just install this mod, they do not always look around what this modification displays on places which have nothing to do with this mod.

I never installed a mod and then searched my website for additional copyright notices (which is here also linked - bad for SEO). And I installed a lot of mods. But now I do. Does not make vb.org a more secure place for me.
Deal with it. He isn't Hans Reiser, he didn't murder his wife. So don't get so bent out of shape.
__________________
http://www.webhacks.co Wordpress, Forums and Server Tips/Tricks and Hacks
Reply With Quote
Reply


Currently Active Users Viewing This Thread: 1 (0 members and 1 guests)
 
Mod Options

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off


New To Site? Need Help?

All times are GMT. The time now is 01:16.

Layout Options | Width: Wide Color: