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

[banuchi2]

Hello Antivirus....once again. Thanks for your mod. [Clicks MOTM Nomination]

I do have one problem I was wondering if you could help me fix.
I did the unistallation of the old mod and did a fresh re-start with this one.
I tested it and I do get the link in the header.
However, when I click the link, it says the following:

Fatal error:
hpa has chosen not to receive private messages or may not be allowed to receive private messages. Therefore you may not send your message to him/her.
Unable to proceed with save while $errors array is not empty in class vB_DataManager_PM in /includes/class_dm.php on line 763

Any ideas on how to remedy this?
Thanks.

NOTE: The user does have the ability to accept PMs. I checked that as well.

[Antivirus]

Banuchi2, the PM override is something I didn't originally take into consideration, so I'll have to look into that since it makes sense the bouncing member should receive the PM regardless of whether or not they can use PMs.

xtazy & nathan, ok i think i found the problem. It seems that the User Datamanager is conflicting with restoring the original usergroupid. I found where the problem is, but it seem sthat a hook where i need one doesn't exist, so i'm going to have to figure out a way to get around it... will look into fixing this this weekend.

For now, so long as you have "Update Member's Usergroup when Processing Bounces?" setting in AdminCP turned OFF, this hack is stable.

[banuchi2]

Antivirus.... the one interesting thing about that message I received is that it says that message for everyone....regardless of whether or not they receive/use pms. That member in particular was accepting pms, but I had still gotten that error message anyways. Good luck and thank you.

[Tom_S]

I am using Outlook Express for my bounced mail only. I do not see anything that says "X-EZbouncer" in the header. I am using 3.6.4 and installed it per your directions. Does it not work with Outlook Express?

[ludachris]

Does this mod work if you've enabled SMTP email instead of the internal PHP mail function?

[Antivirus]

Originally Posted by Tom_S

I am using Outlook Express for my bounced mail only. I do not see anything that says "X-EZbouncer" in the header. I am using 3.6.4 and installed it per your directions. Does it not work with Outlook Express?

I don't use outlook express, but my guess is that you need to enable viewing the full email header in order to see the link.

Originally Posted by ludachris

Does this mod work if you've enabled SMTP email instead of the internal PHP mail function?

Not sure, but I think it should since the email header is created within the mail_send hook (which is located in class_mail.php

[ludachris]

Hmmm... I'm not seeing any reference to EZbouncer in my bounced emails. Is there any other settings I need to turn off or on? I'm using 3.6.4 and Outlook 2003.

[djbaxter]

Originally Posted by Tom_S

I am using Outlook Express for my bounced mail only. I do not see anything that says "X-EZbouncer" in the header. I am using 3.6.4 and installed it per your directions. Does it not work with Outlook Express?

Originally Posted by Antivirus

I don't use outlook express, but my guess is that you need to enable viewing the full email header in order to see the link.

I use Outlook Express - the default installation - and it works just fine.

[Antivirus]

new version 1.4 uploaded today. Fixes the issues above with PM not being sent to users who have private messaging turned off, and also now correctly restores user's usergroup to what it was before they were processed for bouncing.

[DJ XtAzY]

yep i confirm the moving to the original group after activation now works =] , but now i think i found another bug.. not sure. Here's the situation using the same setup and options from my previous posts. For example:

Assume i have like 20 bounced email. I used the header link and managed User1 to the bounced group. The hack remembers his original usergroup, Registered Users, and now moved User1 to the Invalid Emal usergroup. Then i moved on to the second email and managed that user. Same as third and fourth. Suppose i opened the 5th bounced message and that user is User1 again, but i forgot that i already managed him as a bounced user. So i went off and click the link and he's managed again. But now the hack remembers User1's original usergroup as Invalid Email usergroup instead of Registered Users because he was already moved there in the first place. So then User1 change and activates his email but he will be moved back to the Invalid Email usergroup again.

I think the hack should check if that user is already been bounced. If bounced msgs goes to gmail email users, gmail group multiple same bounced emails into one. So gmail users can just go down the list and click on the header link easily, but they will probably forget if they already had that user as a bounced member. Just a suggestion or a bug reporting.