Contents

Code Reference Functions bp_media_add_handler()

bp_media_add_handler( array $medias = array(), string $privacy = 'public', string $content = '', int $group_id = false, int $album_id = false )

Media add handler function

Description

Parameters

$medias

(Optional)

Default value: array()

$privacy

(Optional)

Default value: 'public'

$content

(Optional)

Default value: ''

$group_id

(Optional)

Default value: false

$album_id

(Optional)

Default value: false

Return

(mixed|void)

Source

File: bp-media/bp-media-functions.php

491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
function bp_media_add_handler( $medias = array() ) {
    global $bp_media_upload_count;
    $media_ids = array();
 
    if ( empty( $medias ) && ! empty( $_POST['medias'] ) ) {
        $medias = $_POST['medias'];
    }
 
    $privacy = ! empty( $_POST['privacy'] ) && in_array( $_POST['privacy'], array_keys( bp_media_get_visibility_levels() ) ) ? $_POST['privacy'] : 'public';
 
    if ( ! empty( $medias ) && is_array( $medias ) ) {
 
        // update count of media for later use.
        $bp_media_upload_count = count( $medias );
 
        // save  media.
        foreach ( $medias as $media ) {
 
            $media_id = bp_media_add( array(
                'attachment_id' => $media['id'],
                'title'         => $media['name'],
                'album_id'      => ! empty( $media['album_id'] ) ? $media['album_id'] : false,
                'group_id'      => ! empty( $media['group_id'] ) ? $media['group_id'] : false,
                'privacy'       => ! empty( $media['privacy'] ) && in_array( $media['privacy'], array_merge( array_keys( bp_media_get_visibility_levels() ), array( 'message' ) ) ) ? $media['privacy'] : $privacy,
            ) );
 
            if ( $media_id ) {
                $media_ids[] = $media_id;
            }
        }
    }
 
    /**
     * Fires at the end of the execution of adding saving a media item, before returning the new media items in ajax response.
     *
     * @since BuddyBoss 1.2.0
     *
     * @param array $media_ids Media IDs.
     * @param array $medias Array of media from POST object or in function parameter.
     */
    return apply_filters( 'bp_media_add_handler', $media_ids, (array) $medias );
}

Expand full source code Collapse full source code

Changelog

Changelog
Version Description
BuddyBoss 1.2.0 Introduced.

Uses

Uses
Uses Description
bp-media/bp-media-functions.php: bp_media_get_visibility_levels()

Get media visibility levels out of the $bp global.
bp-media/bp-media-functions.php: bp_media_add_handler

Fires at the end of the execution of adding saving a media item, before returning the new media items in ajax response.
bp-media/bp-media-functions.php: bp_media_add()

Add an media item.
bp-media/classes/class-bp-media.php: BP_Media::__construct()

Constructor method.
Used By
Used By Description
bp-media/bp-media-filters.php: bp_media_update_activity_media_meta()

Update media for activity
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::bp_media_ids_update_rest_field_callback()

The function to use to update the medias’s value of the activity REST Field.
bp-media/bp-media-filters.php: bp_media_attach_media_to_message()

Attach media to the message object
bp-templates/bp-nouveau/includes/media/ajax.php: bp_nouveau_ajax_media_save()

Save media
bp-templates/bp-nouveau/includes/media/ajax.php: bp_nouveau_ajax_media_album_save()

Save album
Show 1 more used by Hide more used by

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.