Administrative and Maintenance Tools - User Awaiting Moderation Email Notification

This modification will enable the sending of an email to the email address specified in 'AdminCP > Settings > Options > User Registration Options > Email Address to Notify About User Awaiting Moderation' when a users clicks on the Activation link in the registration email.


INSTALLATION

Go to:

AdminCP > Plugins & Products > Manage Products > [Add/Import Product]

...and import the 'product-th_moderate_user_email_1-2.xml' file.

Once installed, new options will be available within AdminCP > Settings > Options > User Registration Options allowing you to enable this setting. It will only send the email if the following settings are set to Yes:

- AdminCP > Settings > Options > User Registration Options > Moderate New Members
- AdminCP > Settings > Options > User Registration Options > Verify Email address in Registration

If EITHER of the above settings are set to No, the email will not be sent.

UNINSTALLING

Go to:

AdminCP > Plugins & Products > Manage Products

...and select 'Uninstall' from the dropdown next to the Product.


TRANSLATIONS

The email text uses a new Email Subject Text and Email Body Text Phrase (moderatenewuser). These can be translated within the Phrase Manager into your own language if this is not English.

The AdminCP phrases used are:

- setting_TH_UAME_active_title
- setting_TH_UAME_active_desc
- setting_modnewemail_desc
- setting_modnewemail_title

Note: Although not tested in previous version, given that the code has not changed, it's likely that this will work in previous version including 3.8.x however if there are any issues with previous versions, they will not be supported. If the code changes within the vBulletin core, this product will only be updated for that version onwards.


Versions

1.3 Changed variable names in email body text to account for users ending browser sessions then completing activation.
1.2 Added separate field to allow notifications to be sent to a different address. Removed product dependency.
1.1 Corrected Email Body Text phrase to use AdminCP directory from config.php rather than hard-coded value
1.0 Initial release

Thanks to BirdOfPrey5, Lynne and Paul M for putting me right on some rank stupidity with this...

[Snowhog]

Originally Posted by Trevor Hannant

Have you set both the following settings to 'Yes':

Yes.

You can have the emails sent to more than one address by entering additional email addresses in:

AdminCP > Settings > Options > User Registration Options > Email Address to Notify About New Members

Separate each address in that field with a space.

Excellent! That was where I made my mistake - this had no email address at all. I've just corrected that and now have each of our Administrators email address, separated by a space.

Thank you!!

I marked this MOD as installed and voted it for Best MOD of the Month.

[Snowhog]

Got our first email notification, but the new registrant isn't in the Users Awaiting Moderation usergroup; they are still in the Users Awaiting Email Confirmation usergroup. I thought that the MOD was triggered only after the registration email confirmation email was acknowledged, moving the registrant into the Users Awaiting Moderation usergroup.

Am I missing something that I need to check on?

[Snowhog]

Got our first email notification, but the new registrant isn't in the Users Awaiting Moderation usergroup; they are still in the Users Awaiting Email Confirmation usergroup. I thought that the MOD was triggered only after the registration email confirmation email was acknowledged, moving the registrant into the Users Awaiting Moderation usergroup.

Am I missing something that I need to check on?

Apparently I'm missing nothing. Just got a second email notification (another new registrant), and now going into Moderation > Moderate Users shows both of them. So the MOD is working.

Thank you for a very useful and needed MOD.

[Trevor Hannant]

The plugin uses the 'register_activate_process' hook location which is called within the ['do'] == 'activate' section of register.php, the only place it's called so the mails shouldn't be generating until that part of the registration process is called on.

[Snowhog]

Thank you. As I've realized that 'all is working as it should', the first email that I got, and then going into Admin CP > Moderation > Moderate Users which came back with no users to moderate, must have just been a 'timing' issue. As I added to my last post, the MOD is working as designed, and I'm a happy Administrator.

[Snowhog]

Well, again, hmmm.

Just got the following email notification:

There is a new user, sandroid at Kubuntu Forums . Net

To view their profile, go here:
http://www.kubuntuforums.net/member.php?21950-sandroid

Email Address : censored for this post
Birthday :
Referrer: N/A
IP Address: 69.156.60.60

This is a new registrant, but is not in the Users Awaiting Moderation group -- they are in the Users Awaiting Email Confirmation group.

Admin CP > Options > User Registration Options > Email Address to Notify About New Members says:

This email address will receive an email message when a new user signs up.

Signs up? Not 'when registration is confirmed'?

I don't want to receive emails for new registrants; I want email notifications when they have confirmed the registration email and are now in the Users Awaiting Moderation usergroup.

Added:

Dang it! Right after I posted this, I checked Moderate Users and there this one is! So we receive the email 'before' the user is moved into the usergroup. Why is this?

[Snowhog]

Dag nabit!

Okay, I still think something is a miss here. I just got another email notification:

Subject: New User at Kubuntu Forums . Net

There is a new user, ZackaryxHoffman at Kubuntu Forums . Net

To view their profile, go here:
http://www.kubuntuforums.net/member.php?omitted for privacy here

Email Address : omitted for privacy here
Birthday :
Referrer: N/A
IP Address: 24.11.226.135

This member is NOT in the Users Awaiting Moderation usergroup. So the email notification is going out upon registration, whether or not they confirm the registration email. That's what appears to be happening.

I again point out that Email Address to Notify About New Members says:

This email address will receive an email message when a new user signs up.

Your description of the MOD says:

Once installed, a new option will be available within AdminCP allowing you to enable this setting. It will only send the email if the following settings are set to Yes:

- AdminCP > Settings > Options > User Registration Options > Moderate New Members
- AdminCP > Settings > Options > User Registration Options > Verify Email address in Registration

If EITHER of the above settings are set to No, the email will not be sent.

Both of those settings are set to Yes.

[Trevor Hannant]

Email Address to Notify About New Members is a default vBulletin field, it's not added by this Mod - it just utilises it for the purposes of notifications.

The emails you've quoted in your posts are the default 'new registrant' emails that go out when someone registers and the admin has set an email address in that field. I'll take a look at adding a new field specifically for the purpose of receiving the 'awaiting moderation' email.

[Snowhog]

I do appreciate the quick replies to my 'concerns'. Okay, so your MOD uses this field, as well as vBulletin itself. That explains why I'm getting what I'm getting.

It doesn't really make sense to have vBulletin send Administrators emails about "Users Awaiting Email Confirmation", unless perhaps, it's so we could opt to activate the user directly -- if we were to choose to do so. But that isn't optimal, IMO.

If your MOD were to add it's own email field, and use it exclusively when the registration email was acknowledged, then as Administrators, we would have a choice of receiving one or the other, both, or neither, which I would find most desirable.

Again, thank you for your good work, and for entertaining my observations and at times, confusion.

[Trevor Hannant]

Some Admins, me included, choose to get notifications of all registrations so they can act on them if needed. Receiving notifications when a user registers and goes into the 'Users Awaiting Email Confirmation' is default vBulletin behaviour - if you don't think Admins should get that email if user's are required to verify their email address then you need to request a change to the core code via an Improvement Request here:

https://tracker.vbulletin.com

I'll look at updating the email field to it's own but it won't likely be this week unfortunately...