Contents

Code Reference Classes BP_REST_Media_Endpoint BP_REST_Media_Endpoint::create_item()

BP_REST_Media_Endpoint::create_item( WP_REST_Request $request )

Create medias.

Description

Parameters

$request

(Required) Full details about the request.

Return

(WP_REST_Response) | WP_Error

Source

File: bp-media/classes/class-bp-rest-media-endpoint.php

439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
public function create_item( $request ) {
 
    $args = array(
        'upload_ids' => $request['upload_ids'],
        'privacy'    => $request['privacy'],
    );
 
    $args['upload_ids'] = $request['upload_ids'];
 
    if ( empty( $request['upload_ids'] ) ) {
        return new WP_Error(
            'bp_rest_no_media_found',
            __( 'Sorry, you are not allowed to create a Media item.', 'buddyboss' ),
            array(
                'status' => 400,
            )
        );
    }
 
    if ( isset( $request['group_id'] ) && ! empty( $request['group_id'] ) ) {
        $args['group_id'] = $request['group_id'];
    }
 
    if ( isset( $request['album_id'] ) && ! empty( $request['album_id'] ) ) {
        $args['album_id'] = $request['album_id'];
    }
 
    if ( isset( $request['activity_id'] ) && ! empty( $request['activity_id'] ) ) {
        $args['activity_id'] = $request['activity_id'];
    }
 
    if ( isset( $request['content'] ) && ! empty( $request['content'] ) ) {
        $args['content'] = $request['content'];
    }
 
    /**
     * Filter the query arguments for the request.
     *
     * @param array           $args    Key value array of query var to query value.
     * @param WP_REST_Request $request The request sent to the API.
     *
     * @since 0.1.0
     */
    $args = apply_filters( 'bp_rest_media_create_items_query_args', $args, $request );
 
    $medias_ids = $this->bp_rest_create_media( $args );
 
    if ( is_wp_error( $medias_ids ) ) {
        return $medias_ids;
    }
 
    $medias = $this->assemble_response_data( array( 'media_ids' => $medias_ids ) );
 
    $retval = array();
    foreach ( $medias['medias'] as $media ) {
        $retval[] = $this->prepare_response_for_collection(
            $this->prepare_item_for_response( $media, $request )
        );
    }
 
    $response = rest_ensure_response( $retval );
 
    /**
     * Fires after a Media is created via the REST API.
     *
     * @param WP_REST_Response $response The response data.
     * @param WP_REST_Request  $request  The request sent to the API.
     *
     * @since 0.1.0
     */
    do_action( 'bp_rest_media_create_item', $response, $request );
 
    return $response;
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
0.1.0 Introduced.

Uses

Uses
Uses Description
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::bp_rest_create_media()

Create the Media IDs from Upload IDs.
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::assemble_response_data()

Get medias.
bp-media/classes/class-bp-rest-media-endpoint.php: BP_REST_Media_Endpoint::prepare_item_for_response()

Prepares activity data for return as an object.
bp-media/classes/class-bp-rest-media-endpoint.php: bp_rest_media_create_items_query_args

Filter the query arguments for the request.
bp-media/classes/class-bp-rest-media-endpoint.php: bp_rest_media_create_item

Fires after a Media is created via the REST API.
bp-media/classes/class-bp-media-album.php: BP_Media_Album::__construct()

Constructor method.
Show 1 more use Hide more uses

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.