wp_new_blog_notification() WordPress Function
The wp_new_blog_notification function sends an email notification to the specified email address when a new blog is created. This is useful for site administrators who want to be notified when a new blog is created.
wp_new_blog_notification( string $blog_title, string $blog_url, int $user_id, string $password ) #
Notifies the site admin that the installation of WordPress is complete.
Description
Sends an email to the new administrator that the installation is complete and provides them with a record of their login credentials.
Parameters
- $blog_title
(string)(Required)Site title.
- $blog_url
(string)(Required)Site URL.
- $user_id
(int)(Required)Administrator's user ID.
- $password
(string)(Required)Administrator's password. Note that a placeholder message is usually passed instead of the actual password.
Source
File: wp-admin/includes/upgrade.php
function wp_new_blog_notification( $blog_title, $blog_url, $user_id, $password ) { $user = new WP_User( $user_id ); $email = $user->user_email; $name = $user->user_login; $login_url = wp_login_url(); $message = sprintf( /* translators: New site notification email. 1: New site URL, 2: User login, 3: User password or password reset link, 4: Login URL. */ __( 'Your new WordPress site has been successfully set up at: %1$s You can log in to the administrator account with the following information: Username: %2$s Password: %3$s Log in here: %4$s We hope you enjoy your new site. Thanks! --The WordPress Team https://wordpress.org/ ' ), $blog_url, $name, $password, $login_url ); $installed_email = array( 'to' => $email, 'subject' => __( 'New WordPress Site' ), 'message' => $message, 'headers' => '', ); /** * Filters the contents of the email sent to the site administrator when WordPress is installed. * * @since 5.6.0 * * @param array $installed_email { * Used to build wp_mail(). * * @type string $to The email address of the recipient. * @type string $subject The subject of the email. * @type string $message The content of the email. * @type string $headers Headers. * } * @param WP_User $user The site administrator user object. * @param string $blog_title The site title. * @param string $blog_url The site URL. * @param string $password The site administrator's password. Note that a placeholder message * is usually passed instead of the user's actual password. */ $installed_email = apply_filters( 'wp_installed_email', $installed_email, $user, $blog_title, $blog_url, $password ); wp_mail( $installed_email['to'], $installed_email['subject'], $installed_email['message'], $installed_email['headers'] ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.1.0 | Introduced. |