Changeset 12905

Timestamp:

04/23/2021 05:17:02 PM (3 years ago)

Author:

imath

Message:

Add a new BP Email to welcome new members

Once users activated their account, they are now receiving a welcome email with a link to their profile and a link to reset their password in case they forgot about it since they registered.

Props vapvarun, dcavins

Fixes #8428

Location:

trunk/src

Files:

• bp-core/bp-core-functions.php (modified) (3 diffs)
• bp-core/bp-core-update.php (modified) (2 diffs)
• bp-members/bp-members-functions.php (modified) (1 diff)

trunk/src/bp-core/bp-core-functions.php

@@ -3729 +3729 @@
      */
     return (array) apply_filters( 'bp_email_get_schema', array(
+        'core-user-activation' => array(
+            /* translators: do not remove {} brackets or translate its contents. */
+            'post_title'   => __( '[{{{site.name}}}] Welcome!', 'buddypress' ),
+            /* translators: do not remove {} brackets or translate its contents. */
+            'post_content' => __( "Welcome to {{site.name}}!\n\nVisit your <a href=\"{{{profile.url}}}\">profile</a>, where you can tell us more about yourself, change your preferences, or make new connections, to get started.\n\nForgot your password? Don't worry, you can reset it with your email address from <a href=\"{{{lostpassword.url}}}\">this page</a> of our site", 'buddypress' ),
+            /* translators: do not remove {} brackets or translate its contents. */
+            'post_excerpt' => __( "Welcome to {{site.name}}!\n\nVisit your profile, where you can tell us more about yourself, change your preferences, or make new connections, to get started: {{{profile.url}}}\n\nForgot your password? Don't worry, you can reset it with your email address from this page of our site: {{{lostpassword.url}}}", 'buddypress' ),
+        ),
         'activity-comment' => array(
             /* translators: do not remove {} brackets or translate its contents. */
@@ -3999 +4007 @@
             'message'   => __( 'You will no longer receive emails when your request to join a group has been accepted or denied.', 'buddypress' ),
         ),
+    );
+
+    $core_user_activation = array(
+        'description'   => __( 'Recipient has successfully activated an account.', 'buddypress' ),
     );
 
@@ -4018 +4030 @@
         'groups-membership-request-accepted' => $groups_membership_request_accepted,
         'groups-membership-request-rejected' => $groups_membership_request_rejected,
+        'core-user-activation'               => $core_user_activation,
     );
 

trunk/src/bp-core/bp-core-update.php

@@ -624 +624 @@
     global $wpdb;
     $bp_prefix = bp_core_get_table_prefix();
+
+    // Install welcome email to email list.
+    add_filter( 'bp_email_get_schema', 'bp_core_get_8_0_upgrade_email_schema' );
+
+    bp_core_install_emails();
+
+    remove_filter( 'bp_email_get_schema', 'bp_core_get_8_0_upgrade_email_schema' );
 
     // Update the `new_avatar` activity type's component to `members`.
@@ -675 +682 @@
 
     bp_core_install_nonmember_opt_outs();
+}
+
+/**
+ * Select only the emails that need to be installed with version 8.0.
+ *
+ * @since 8.0.0
+ *
+ * @param array $emails The array of emails schema.
+ */
+function bp_core_get_8_0_upgrade_email_schema( $emails ) {
+    $new_emails = array();
+
+    if ( isset( $emails['core-user-activation'] ) ) {
+        $new_emails['core-user-activation'] = $emails['core-user-activation'];
+    }
+
+    return $new_emails;
 }
 

trunk/src/bp-members/bp-members-functions.php

@@ -3307 +3307 @@
     ) );
 }
+
+/**
+ * Send welcome email on successful user activation.
+ *
+ * @since 8.0.0
+ *
+ * @param int $user_id The new user's ID
+ */
+function bp_send_welcome_email( $user_id = 0 ) {
+    if ( ! $user_id ) {
+        return;
+    }
+
+    $profile_url = bp_core_get_user_domain( $user_id );
+
+    /**
+     * Use this filter to add/edit/remove tokens to use for your welcome email.
+     *
+     * @since 8.0.0
+     *
+     * @param array $value   An array of BP Email tokens.
+     * @param int   $user_id The user ID.
+     */
+    $welcome_tokens = apply_filters(
+        'bp_send_welcome_email_tokens',
+        array(
+            'displayname'      => bp_core_get_user_displayname( $user_id ),
+            'profile.url'      => $profile_url,
+            'lostpassword.url' => wp_lostpassword_url( $profile_url ),
+        ),
+        $user_id
+    );
+
+    bp_send_email( 'core-user-activation', $user_id, array( 'tokens' => $welcome_tokens ) );
+}
+add_action( 'bp_core_activated_user', 'bp_send_welcome_email', 10, 1 );