BP_REST_Group_Invites_Endpoint::create_multiple_item_permissions_check( WP_REST_Request $request )

Checks if a given request has access to invite a multiple member to a group.

Description

Parameters

$request

(Required) Full details about the request.

Return

(bool|WP_Error)

Source

File: bp-groups/classes/class-bp-rest-group-invites-endpoint.php

602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
public function create_multiple_item_permissions_check( $request ) {
    $inviter_id_arg = $request['inviter_id'] ? $request['inviter_id'] : bp_loggedin_user_id();
    $group          = $this->groups_endpoint->get_group_object( $request['group_id'] );
    $inviter        = bp_rest_get_user( $inviter_id_arg );
    $user_ids       = (array) $request['user_id'];
    $retval         = true;
 
    if ( ! is_user_logged_in() ) {
        $retval = new WP_Error(
            'bp_rest_authorization_required',
            __( 'Sorry, you need to be logged in to create an invitation.', 'buddyboss' ),
            array(
                'status' => rest_authorization_required_code(),
            )
        );
    }
 
    if ( true === $retval && empty( $group->id ) ) {
        $retval = new WP_Error(
            'bp_rest_group_invalid_id',
            __( 'Invalid group ID.', 'buddyboss' ),
            array(
                'status' => 404,
            )
        );
    }
 
    if ( true === $retval && ( empty( $user_ids ) || in_array( $inviter->ID, $user_ids, true ) ) ) {
        $retval = new WP_Error(
            'bp_rest_member_invalid_id',
            __( 'Invalid members ID.', 'buddyboss' ),
            array(
                'status' => 404,
            )
        );
    }
 
    // Only a site admin or the user herself can extend invites.
    if ( true === $retval && ! bp_current_user_can( 'bp_moderate' ) && bp_loggedin_user_id() !== $inviter_id_arg ) {
        $retval = new WP_Error(
            'bp_rest_group_invite_cannot_create_item',
            __( 'Sorry, you are not allowed to create the invitation as requested.', 'buddyboss' ),
            array(
                'status' => rest_authorization_required_code(),
            )
        );
    }
 
    /**
     * Filter the group invites `create_item` permissions check.
     *
     * @since 0.1.0
     *
     * @param WP_REST_Request $request The request sent to the API.
     *
     * @param bool|WP_Error   $retval  Whether the request can continue.
     */
    return apply_filters( 'bp_rest_group_invites_multiple_create_item_permissions_check', $retval, $request );
}

Changelog

Changelog
Version Description
0.1.0 Introduced.

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.