wp_new_user_notification "user" option for third parameter

[Jonathandejong]

I propose adding a third option for the third parameter $notify in wp_new_user_notification() called "user" (string) which would allow for sending the notification to the user only. Many user-driven sites have the need for sending this email to new users but would rather not flood an admin email with registration notifications.

I don't think this only flaw is enough to justify plugging the function with a custom one. It'd be much preferred to allow for this third option in the core function instead.

[akibjorklund]

I agree this would be a useful addition. I've attached 36009.diff​ which adds this functionality. The few lines indented by the if block added are also fixed for spacing issues to adhere to the WordPress coding standards.

[boonebgorges]

Patch seems pretty good to me. Can we get a @since annotation for the new accepted value?

[akibjorklund]

Indeed. Patch updated.

[Jonathandejong]

Great to hear!

[DrewAPicture]

The changelog entry in 36009.2.diff​ looks good.

[SergeyBiryukov]

In 37276:

Users: In wp_new_user_notification(), sdd 'user' option for the $notify parameter, which allows for sending notification only to the user created.

Props akibjorklund.
Fixes #36009.

[ocean90]

I'm shocked that this landed without a unit test. May I remind you about [35735]?

Also,wp_send_new_user_notifications() is a wrapper for wp_new_user_notification() and should get a note about the new parameter too.

[SergeyBiryukov]

In 37277:

Users: Add a unit test for [37276].

See #36009.

[SergeyBiryukov]

Replying to ocean90:

I'm shocked that this landed without a unit test. May I remind you about [35735]?

Right, sorry for that. Thanks for reminding :)

[SergeyBiryukov]

In 37278:

Docs: Reflect the new 'user' option for wp_new_user_notification()'s $notify parameter added in [37276] in wp_send_new_user_notifications() docs as well.

Props ocean90.
Fixes #36009.

[boonebgorges]

#36970 was marked as a duplicate.

[jshrek]

I submitted the following suggestion here https://core.trac.wordpress.org/ticket/36970 which turns out to be a duplicate of this one!

Adding a user email only option is great idea.

[zodiac1978]

FYI: If BuddyPress is active, this is not sufficient.

Please see also: ​https://buddypress.trac.wordpress.org/ticket/7597#comment:7