Contents

Code Reference Functions groups_notification_new_membership_request()

groups_notification_new_membership_request( int $requesting_user_id, int $admin_id, int $group_id, int $membership_id )

Notify group admin about new membership request.

Description

Parameters

$requesting_user_id

(Required) ID of the user requesting group membership.

$admin_id

(Required) ID of the group admin.

$group_id

(Required) ID of the group.

$membership_id

(Required) ID of the group membership object.

Source

File: bp-groups/bp-groups-notifications.php

122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
function groups_notification_new_membership_request( $requesting_user_id = 0, $admin_id = 0, $group_id = 0, $membership_id = 0 ) {
 
    // Trigger a BuddyPress Notification.
    if ( bp_is_active( 'notifications' ) ) {
        bp_notifications_add_notification( array(
            'user_id'           => $admin_id,
            'item_id'           => $group_id,
            'secondary_item_id' => $requesting_user_id,
            'component_name'    => buddypress()->groups->id,
            'component_action'  => 'new_membership_request',
        ) );
    }
 
    // Bail if member opted out of receiving this email.
    if ( 'no' === bp_get_user_meta( $admin_id, 'notification_groups_membership_request', true ) ) {
        return;
    }
 
    $unsubscribe_args = array(
        'user_id'           => $admin_id,
        'notification_type' => 'groups-membership-request',
    );
 
    $group = groups_get_group( $group_id );
    $args  = array(
        'tokens' => array(
            'admin.id'             => $admin_id,
            'group'                => $group,
            'group.name'           => $group->name,
            'group.id'             => $group_id,
            'group-requests.url'   => esc_url( bp_get_group_permalink( $group ) . 'admin/membership-requests' ),
            'membership.id'        => $membership_id,
            'profile.url'          => esc_url( bp_core_get_user_domain( $requesting_user_id ) ),
            'requesting-user.id'   => $requesting_user_id,
            'requesting-user.name' => bp_core_get_user_displayname( $requesting_user_id ),
            'unsubscribe'          => esc_url( bp_email_get_unsubscribe_link( $unsubscribe_args ) ),
        ),
    );
    bp_send_email( 'groups-membership-request', (int) $admin_id, $args );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
BuddyPress 1.0.0 Introduced.

Uses

Uses
Uses Description
bp-groups/bp-groups-functions.php: groups_get_requests()

Get group membership requests filtered by arguments.
bp-loader.php: buddypress()

The main function responsible for returning the one true BuddyBoss Instance to functions everywhere.
bp-notifications/bp-notifications-functions.php: bp_notifications_add_notification()

Add a notification for a specific user, from a specific component.
bp-groups/bp-groups-functions.php: groups_get_group()

Fetch a single group object.
bp-groups/bp-groups-template.php: bp_get_group_permalink()

Return the permalink for the current group in the loop.
bp-members/bp-members-functions.php: bp_core_get_user_displayname()

Fetch the display name for a user.
bp-members/bp-members-functions.php: bp_core_get_user_domain()

Return the domain for the passed user: e.g. http://example.com/members/andy/.
bp-core/bp-core-template.php: bp_is_active()

Check whether a given component (or feature of a component) is active.
bp-core/bp-core-functions.php: bp_email_get_unsubscribe_link()

Creates unsubscribe link for notification emails.
bp-core/bp-core-functions.php: bp_send_email()

Send email, similar to WordPress’ wp_mail().
bp-core/bp-core-functions.php: bp_get_user_meta()

Get a piece of usermeta.
Show 6 more uses Hide more uses
Used By
Used By Description
bp-groups/classes/class-bp-groups-invitation-manager.php: BP_Groups_Invitation_Manager::run_send_action()

This is where custom actions are added to run when notifications of an invitation or request need to be generated & sent.

Questions?

We're always happy to help with code or other questions you might have! Search our developer docs, contact support, or connect with our sales team.