Administrative and Maintenance Tools - EZ Bounced Email Management for Admins

DESCRIPTION:
This mod will insert a special EZbounce link into the header of all emails sent from your forums. In the event any email bounces back to you, you simply click the EZbounce link and the Ezbounce script launches, which will modify the bouncing members settings to prevent further bouncing emails. It will also send that member a PM asking them to update their email address.

This modification is known to work with versions as high as 3.8.x


FEATURES:

• Will not modify settings for Admins, Supermods, or Moderators if their email bounces
• (if turned on) Bouncing member is moved to whatever usergroup you set in AdminCP EZbounce Settings
• Updates bouncing member's "Receive Email from Administrators" setting to NO
• Updates bouncing member's "Receive Email Notification of New Private Messages" setting to NO
• Updates bouncing member's "Receive Email from Other Members" setting to NO
• Remove email notification for all of bouncing member's subscribed THREADS
• Remove email notification for all of bouncing member's subscribed FORUMS
• Turns on Popup Notification of new Private Messages for bouncing member
• PM is sent to Member notifying them of bounced email & asking them to update email address
• (if turned on) When member updates & confirms their new email, they are returned to original usergroup.

Now, the next time you send a newsletter from your AdminCP, (so long as you only send emails to members whom have "Receive Email From Administrators" set to "Yes") you will no longer receive a bounced email from this member (because they are no longer being sent).

And also, if you created a new usergroup such as "Bounced Members" and set this usergroupid in this hack's settings, now the members that have bounced can be pruned, sent reminder emails, whateveryou want to do with them!


WHAT IF A MEMBER DECIDED TO CLICK ON THE LINK IN THE EMAIL HEADER?
Most email clients don't show the email's headers by default, however in the event a member is slick enough to view their header and they click on this mysterious link, they will simply receive a no permission message since they're unallowed to log in to the AdminCP.


ZIP FILE CONTENTS:
1 Product (2 plugins, a couple phrases & installcode which adds 1 colum to user table)
1 File


HOW TO VIEW FULL EMAIL HEADERS:
You might need to configure your email client to view full email headers in order to see the EzBounce link. There's detailed instructions on how to do this for the most popular email clients here.


CHANGELOG:
#> 1.11 - released on 7/6/2008:
Fixed bug reported in post #583

#> 1.10 - released on 12/18/2007:
Added when bouncing member is managed for bouncing, their "Pop Up a Notification Box When New PM Is Received" setting is turned on before the notification PM is sent, to better ensure they are notified to update their email address.
Bought the new CD entitled Sleaze Freak by Scum Of The Earth on Amazon.com

#> 1.9 - released on 9/22/2007:
Added when bouncing member is managed for bouncing, their "Pop Up a Notification Box When New PM Is Received" setting is turned on before the notification PM is sent, to better ensure they are notified to update their email address.
Modified the way old usergroupid is restored so methos is more compatible with other installed mods.
Optimized some queries in ezbounce.php and plugin codes.

#> 1.8 - released on 6/1/2007:
Bug fix - fixed array_merge error for those running php 5.

#> 1.7 - released on 5/8/2007:
Bug fix - fixed bug where old usergroup was incorrectly being restored.

#> 1.6 - released on 4/26/2007:
Added protective measure for Admins, Supermods, or Mods who's email may have bounced. this makes sure their usergroup and settings are not modified

even if their email bounces.
When bouncing member is managed for bouncing, their "Receive Email Notification of New Private Messages" is now set to NO.
When bouncing member is managed for bouncing, their "Receive Email from Other Members" is now set to NO.
When bouncing member is managed for bouncing, email notification is turned OFF for all of bouncing user's subscribed threads.
When bouncing member is managed for bouncing, email notification is turned OFF for all of bouncing user's subscribed forums.

#> 1.5 - released on 2/17/2007:
Added option in Settings which allows admin to insert the EZbounce link into outgoing email's message body (for email clients which make it difficult to show

email headers or don't properly parse html links when displaying email headers.
Fixed bug where original usergroupid was being erased in the event admin processed bounced more than once for same member

#> 1.4 - released on 2/17/2007:
Fixed bug - PM is now sent regardless of whether or not bouncing member had "Enable Private Messaging" turned off in UserCP.
Fixed bug - Usergroup is now properly reset to what it was before member was managed for bouncing

#> 1.3 - released on 2/15/2007:
New setting in AdminCP which gives option to move bouncing members into any usergroup of Admin's choice
If member had previously bounced, and they update their email, they are moved back to their original usergroup

#> 1.2 - released on 2/10/2007:
Bouncing members are now handled by setting their preference to receive admin emails to "no"
Sends PM to member notifying them email bounced
If / when member updates his/her email their preference to receive admin emails is reset to "yes"

#> 1.0 - released on 2/8/2007
Original release


If you like this hack, please click Nominate for MOTM

[djbaxter]

This morning, I received a bounce from the v1.09 Inactive email mod, that sends emails out to inactive members. I checked at the bottom of that email and NO EZ-Bounce link appeared, or in the header. I guess there's some kind of incompatibility (even after I used djbaxter's extra hack) as it relates specifically to my system and the two mods.

Adding the lines I suggested to Inactive Email Reminder specifically puts the EZ Bounce link in the email HEADER - so the EZ Bounce setting to add it to the bottom of the email will not work.

Options:

1. Check the headers of the returned emails

2. Add a line similar to what I showed you earlier to the BOTTOM of the emails sent out by Inactive Email reminder (do this in the Admin CP | vBulletin Options | Inactive Emails).

You should really post any other questions related to Inactive Emails in that forum. This really has nothing to do with the EZ Bolunce add-on.

[BadgerDog]

Originally Posted by djbaxter

You should really post any other questions related to Inactive Emails in that forum. This really has nothing to do with the EZ Bolunce add-on.

Yes, you are right ... :up:

Here's a problem I have that's just appeared purely with EZ-Bounce

I had a bounce on a Registration Email to day.

When EZ-Bounce link was clicked, I got the following error. I had to use a screen snap as the screen goes buy so fast without halting I couldn't cut-n-paste it. I just noticed the error at the top of the screen today, so I have no idea how long I've been getting it, or what other impact it is having.

I checked the PHP file at line 141 and I don't know enough about coding to understand what the error is referencing?

Any ideas?

Thanks

Regards,
Badger

[Antivirus]

I bet your problem is the execution order of your plugins which reside at your hook location: mail_send

In other words, it sounds like the plugin for the other mod located at mail_send is executing before the plugin for the ezbounce mod located at mail_send.

Try changing execution order for the plugins so that ezbounce has an execution order before (lower number) than that of the other hack.

[BadgerDog]

Originally Posted by Antivirus

Try changing execution order for the plugins so that ezbounce has an execution order before (lower number) than that of the other hack.

Ok, thanks....

Just so I don't screw it up, here's the execution values now.

Product : Inactive User Reminder Emails
Footer Addition global_start = 1
Update Database register_addmember_complete = 5

Product: EZ Bounce Management - by Antivirus
EZ Bounce Management - construct code mail_send = 10
EZ Bounce Management - update values register_activate_process = 10

So, I can just arbitrarily pick numbers to make EZ Bounce lower?

Thanks... appreciate your help...:up:

Regards,
Badger

[Antivirus]

Hmm, that's the only hooks for inactive users? I would have thought that it was placing a plugin at mail_send and was going to suggest to try changing the one for ezbounce mail_send to value of 1. DJbaxter posted a fix for use with this hack somewhere in this thread, that might fix the issue.

[BadgerDog]

Originally Posted by Antivirus

Hmm, that's the only hooks for inactive users? I would have thought that it was placing a plugin at mail_send and was going to suggest to try changing the one for ezbounce mail_send to value of 1. DJbaxter posted a fix for use with this hack somewhere in this thread, that might fix the issue.

Thanks...

I tried the "1" value in mail_send and also implemented DJbaxter's patch for remindermail.

I received another bounce this morning, but the EZ Bounce link wasn't there once again.

Let me drop this discussion here, as I think it's probably more appropriate to the Inactive Member's Email mod.

Thank you for your (and Djbaxter's) attempts to help.... :up:

Regards,
Badger

[MSheraz86]

Clicked Installed

Wonderful mod!!

Hate those bouncing back emails.

[BadgerDog]

Well, here's a surprise ....

I received some bounces this morning from the "Inactive Members" email mod and guess what, EZ-Bounce has the link imbedded in the headers... :up:

I have no idea why it started to work , as I changed nothing since my last post above. In any event, when I cut and pasted the link into my browser, it did its thing for each bounced email, but I still get the same "warning" error (see attachment) that I mentioned earlier.

In spite of that, it's working .... thanks very much for your work.

Regards,
Badger

[Antivirus]

good to hear it's working for you now. Probably the bounces which you received were sent before the mod was installed, but received after. The mod needs to be installed before theemail is sent as the script attaches the header to the outgoing email.

The error you're getting is likely because you're server's using php5. This is easy to fix. As matter of fact, the new version i'll update it today will resolve this. You could easily fix it yourself by editing ezbounce.php file as follows:


Find:

PHP Code:

// process errors if there are any 
$errors = array_merge($errors, $pmdm->errors); 


Replace with:

PHP Code:

// process errors if there are any 
$errors = array_merge((array)$errors, $pmdm->errors); 


should do the trick. The newest version has this fixed.

[BadgerDog]

Originally Posted by Antivirus

The error you're getting is likely because you're server's using php5. This is easy to fix. As matter of fact, the new version i'll update it today will resolve this.

<snip>

should do the trick. The newest version has this fixed.

Thanks...

I'll wait until the new version goes up, then install it.

Appreciate your patience and support....

I never realized how much a pain in the a$$ the management of bounced emails could be, particularly as a board grows. Your mod really makes it a simple task.... :up:

An option just to have it automatically do the same thing I do with the "click the link", creating an audit trail in a log would be great... then I could be real lazy and do NOTHING ....

Regards,
Badger